AMALYZE Falcon API

research.product.keywords.changes (POST)

Endpoint

Endpoint research.product.keywords.changes returns the keyword changes for an ASIN / marketplace combination

Method

POST research.product.keywords.changes

Example call

curl https://falcon.amalyze.com/<VERSION>/research.product.keywords.distribution \
-X POST \
-H "X-Falcon-Token: <YOUR-TOKEN-HERE>" \
-d '
{
	"filters": {
		"marketplace": "A1PA6795UKMFR9",
		"asin": "B0014TE6FG"
	}
}
'

1

2

3

4

5

6

7

8

9

10

11

curl https://falcon.amalyze.com/<VERSION>/research.product.keywords.distribution \

-X POST \

-H "X-Falcon-Token: <YOUR-TOKEN-HERE>" \

-d '

{

"filters": {

"marketplace": "A1PA6795UKMFR9",

"asin": "B0014TE6FG"

}

'

JSON Payload

Property	Type	Description	Further information
`filters`	object	Object containing the filter information
`filters.asin`	string	The ASIN, for which ranking data is requested for
`filters.marketplace`	string	The marketplace-ID, for which ranking data is requested for.	valid marketplace-IDs

JSON Response

{
    "items": {
        "lost": 98,
        "down": 33,
        "equal": 6,
        "up": 27,
        "new": 58
    },
    "request": {
        "id": "dd523fc5-4de5-480c-a37a-bad8dc1fc0b3",
        "took": 1.1868,
        "costs": 5,
        "remaining": 99995,
        "method": "research.product.keywords.changes",
        "success": true,
        "error": {
            "code": null,
            "message": null,
            "hint": null
        }
    }
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

{

"items": {

"lost": 98,

"down": 33,

"equal": 6,

"up": 27,

"new": 58

},

"request": {

"id": "dd523fc5-4de5-480c-a37a-bad8dc1fc0b3",

"took": 1.1868,

"costs": 5,

"remaining": 99995,

"method": "research.product.keywords.changes",

"success": true,

"error": {

"code": null,

"message": null,

"hint": null

}

Property	Type	Description
`items`	array	Array containing the aggregated keyword distribution
`items.lost`	integer	The number of keyword rankings, which have been lost
`items.down`	integer	The number of keyword rankings, which have been declined
`items.equal`	integer	The number of keyword rankings, which did not change
`items.up`	integer	The number of keyword rankings, which did improve
`items.new`	integer	The number of keyword rankings, which are new
`request`	object	The request information object (see request information object definition for more information)