AMALYZE Falcon API

Keyword Object

Definition

{   
	"score": null,
	"keyword": {
		"keyword": "fatburner",
		"id": "64475c5aae112156d5a227a0b855c345"
	},  
	"marketplace": {
		"id": "A1PA6795UKMFR9",
		"name": "amazon.de"
	},  
	"brands": 73, 
	"buybox": {
		"merchants": 55, 
		"rate": 0.78217821782178,
		"offer": {
			"avg": 23.928108910891,
			"min": 2.99,
			"max": 643.99,
			"currency": "EUR"
		},  
		"rrp": {
			"avg": 23.928108910891,
			"min": 2.99,
			"max": 643.99,
			"currency": "EUR"
		},  
		"stroke": {
			"rate": 0.30693069306931
		}   
	},  
	"results": {
		"organic": {
			"count": 6317
		},  
		"advertising": {
			"spa": {
				"count": 5
			},  
			"hsa": false
		}   
	},  
	"categories": {
		"total": 29, 
		"root": {
			"id": "64187031",
			"name": "Drogerie & K\u00f6rperpflege"
		},
		"categories": [
			{
				"id": "64187031",
				"name": "Drogerie & K\u00f6rperpflege",
				"categories": [
					{   
						"id": "2860508031",
						"name": "Gewichtsmanagement"
					},  
					{   
						"id": "64373031",
						"name": "Sportnahrung"
					}
				]   
			},  
			{   
				"id": "186606",
				"name": "B\u00fccher",
				"categories": [
					{   
						"id": "536470",
						"name": "Fatburner"
					},  
					{   
						"id": "13752911",
						"name": "Schlanke & Gesunde K\u00fcche"
						}
				]   
			}  
		]
	},
	"correction": {
		"correction": null,
		"type": "none"
	},
	"related": {
		"exists": false,
		"keywords": []
	},
	"success": true,
	"error": {
		"code": null,
		"message": null,
		"hint": null
	},
	"filters": [
		{
			"values": [
				{
					"name": "Amazon Spar-Abo"
				}
			],
			"name": "Abo-Option"
		},
		{
			"values": [
				{
					"name": "Mit Prime bestellbar"
				},
				{
					"name": "Kostenlose Lieferung ab EUR 29 Bestellwert"
				}
			],
			"name": "Versandoption"
		}
	],
	"reviews": {
		"avg": 157.21052631579,
		"min": 123,
		"max": 345
	},
	"rating": {
		"avg": 4.0763157894737,
		"min": 1,
		"max": 5
	},
	"optimization": {
		"total": null
	},
	"update": {
		"last": "2018-05-23T11:57:27+00:00"
	}
}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

{

"score": null,

"keyword": {

"keyword": "fatburner",

"id": "64475c5aae112156d5a227a0b855c345"

"marketplace": {

"id": "A1PA6795UKMFR9",

"name": "amazon.de"

"brands": 73,

"buybox": {

"merchants": 55,

"rate": 0.78217821782178,

"offer": {

"avg": 23.928108910891,

"min": 2.99,

"max": 643.99,

"currency": "EUR"

"rrp": {

"avg": 23.928108910891,

"min": 2.99,

"max": 643.99,

"currency": "EUR"

"stroke": {

"rate": 0.30693069306931

}

"results": {

"organic": {

"count": 6317

"advertising": {

"spa": {

"count": 5

"hsa": false

}

"categories": {

"total": 29,

"root": {

"id": "64187031",

"name": "Drogerie & K\u00f6rperpflege"

"categories": [

{

"id": "64187031",

"name": "Drogerie & K\u00f6rperpflege",

"categories": [

{

"id": "2860508031",

"name": "Gewichtsmanagement"

{

"id": "64373031",

"name": "Sportnahrung"

}

]

{

"id": "186606",

"name": "B\u00fccher",

"categories": [

{

"id": "536470",

"name": "Fatburner"

{

"id": "13752911",

"name": "Schlanke & Gesunde K\u00fcche"

}

]

}

]

"correction": {

"correction": null,

"type": "none"

"related": {

"exists": false,

"keywords": []

"success": true,

"error": {

"code": null,

"message": null,

"hint": null

"filters": [

{

"values": [

{

"name": "Amazon Spar-Abo"

}

"name": "Abo-Option"

{

"values": [

{

"name": "Mit Prime bestellbar"

{

"name": "Kostenlose Lieferung ab EUR 29 Bestellwert"

}

"name": "Versandoption"

}

"reviews": {

"avg": 157.21052631579,

"min": 123,

"max": 345

"rating": {

"avg": 4.0763157894737,

"min": 1,

"max": 5

"optimization": {

"total": null

"update": {

"last": "2018-05-23T11:57:27+00:00"

}

Property	Type	Description	Comment	Version
`score`	float	Internal score for matching		0.1.10
`keyword`	object	Object containing the keyword information		0.1.10
`keyword.keyword`	string	The requested keyword		0.1.10
`keyword.id`	string	Internal keyword ID		0.1.10
`marketplace`	object	Object containing the marktplace information		0.1.10
`marketplace.id`	string	The official marketplace ID	(valid marketplace ids)	0.1.10
`marketplace.name`	string	The marketplace’s name		0.1.10
`brands`	array	Array containing the brands (as string)		0.1.10
`buybox`	object	Object containing the buybox information		0.1.10
`buybox.merchants`	integer	Number of (different) unique merchants, holding the buybox		0.1.10
`buybox.rate`	float	Rate of products under this keyword, having a buybox		0.1.10
`buybox.offer`	object	Object containing the pricing information		0.1.10
`buybox.offer.avg`	float	Average price (offers) for products ranking for this keyword		0.1.12
`buybox.offer.min`	float	Minimum price (offers) for products ranking for this keyword		0.1.10
`buybox.offer.max`	float	Maximum price (offers) for products ranking for this keyword		0.1.10
`buybox.offer.curreny`	string	Currency		0.1.10
`buybox.rrp`	object	Object containing the recommend retail price (rrp) information		0.1.12
`buybox.rrp.avg`	float	Average recommended retail price (rrp) for products ranking for this keyword		0.1.12
`buybox.rrp.min`	float	Minimum recommended retail price (rrp) for products ranking for this keyword		0.1.12
`buybox.rrp.max`	float	Maximum recommended retail price (rrp) for products ranking for this keyword		0.1.12
`buybox.rrp.curreny`	string	Currency		0.1.2
`buybox.stroke`	object	Object containing the stroke price information		0.1.10
`buybox.stroke.rate`	float	rate of products under this keywords, having a stroke price		0.1.10
`results`	object	object containing information about the search results for this keyword		0.1.10
`results.organic`	object	object containing information about the organic search results for this keyword		0.1.10
`results.organic.count`	integer	number of products ranking (organically) for this keyword		0.1.10
`results.advertising`	object	object containing information about the advertised products for this keyword		0.1.10
`results.advertising.spa`	object	object containing information about the advertised (sponsored product ads) for this keyword		0.1.10
`results.advertising.spa.count`	integer	number of products delivered by sponsored product ads for this keyword		0.1.10
`results.advertising.hsa`	boolean	indicates, if there are headline search ads (HSA) for this keyword		0.1.10
`categories`	object	object containing information about the relevant categories for this keyword		0.1.10
`categories.total`	integer	number of different relevant categories for this keyword		0.1.10
`categories.root`	object	object containing information about the main category for this keyword		0.1.10
`categories.root.id`	string	the amazon browse-node id for the main category		0.1.10
`categories.root.name`	string	the (translated to the marketplace-language) name of the browse node for the main category		0.1.10
`categories.categories`	array	array containing further relevant categories for this keyword		0.1.10
`categories.categories.id`	string	the amazon browse-node id for this category		0.1.10
`categories.categories.name`	string	the (translated to the marketplace-language) name of the browse node for this category		0.1.12
`categories.categories.categories`	array	array containing further relevant subcategories for this keyword		0.1.12
`categories.categories.categories.id`	string	the amazon browse-node id for this subcategory		0.1.12
`categories.categories.categories.name`	string	the (translated to the marketplace-language) name of the browse node for this subcategory		0.1.12
`correction`	object	object containing the correction information		0.1.10
`correction.correction`	string	correction of the entered keyword (if applicable)		0.1.10
`correction.type`	string	type of correction (if applicable)	`corrected`searchterm is corrected and redirected `suggest`correction is suggested but not redirected `none`no correction found	0.1.10
`related`	object	object containing related keywords		0.1.10
`related.exists`	boolean	indicates if related keywords exist		0.1.10
`related.keywords`	array	related keywords (string)		0.1.10
`success`	boolean	indicates if the requested keyword is known by AMALYZE		0.1.10
`error`	object	object containing the error information (if occured)		0.1.10
`filters`	array	array containing the filter information for the requested keyword		0.1.10
`filters.values`	array	array containing the filter values for the requested keyword		0.1.10
`filters.values.name`	string	the name of the filter values		0.1.10
`filters.name`	string	the filter’s name		0.1.10
`reviews`	object	object containing the reviews information		0.1.10
`reviews.avg`	float	average number of reviews for the products ranking for the keyword		0.1.12
`reviews.min`	float	minimum number of reviews for the products ranking for the keyword (products with no reviews are ignored)		0.1.12
`reviews.max`	float	maximum number of reviews for the products ranking for the keyword		0.1.12
`rating`	object	object containing the rating information
`rating.avg`	float	average rating (stars) for products ranking for the keyword		0.1.12
`rating.min`	float	minimum rating (stars) for products ranking for the keyword		0.1.12
`rating.max`	float	maximum rating (stars) for products ranking for the keyword		0.1.12
`optimization`	object	object containing the optimization information	not yet implemented
`optimization.total`	float	average optimization value for products ranking for the keyord	not yet implemented
`stats`	object	object containing the staticti object for the keyword		0.1.15
`stats.impressions`	integer	integer containing the monthly searchVolume for the keyword		0.1.15
`stats.sales`	object	object containing the sales info for the keyword		0.1.15
`stats.sales.amount`	float	estimated monthly sales for this keyword		0.1.15
`stats.sales.currency`	string	Currency		0.1.15
`update`	object	object containing the update information		0.1.10
`update.last`	dateTime	timestamp when keyword was last updated		0.1.10

Update changes

Version	Description
0.1.15	added `stats.impressions`
	added `stats.sales`
	removed `buybox.offer.amount`
	removed `results.advertising.spa.ration`
	removed `categories.categies.text`
	removed `reviews.total`
	removed `rating.score`
0.1.12	added `buybox.offer.avg`
	marked `buybox.offer.amount` as deprecated
	added `buybox.rrp`
	added `buybox.rrp.avg`
	added `buybox.rrp.min`
	added `buybox.rrp.max`
	added `buybox.rrp.currency`
	marked `results.advertising.spa.ratio`
	marked `categories.categories.text`
	added `categories.categories.name`
	added `categories.categories.categories`
	added `categories.categories.categories.id`
	added `categories.categories.categories.name`
	marked `reviews.total` as deprecated
	added `reviews.avg`
	added `reviews.min`
	added `reviews.max`
	marked `rating.score` as deprecated
	added `rating.avg`
	added `rating.min`
	added `rating.max`