AMALYZE Falcon API

research.products.keywords.rankings (POST)

Endpoint

Endpoint research.products.keywords.rankings returns the historical keyword positions for a ASIN / keyword / marketplace combination.

By default each keyword is queried at least once per week. Depending on its volatility (how often the results of keyword vary), the query interval will be algorithmical adopted.

Method
POST research.products.keywords.rankings
Example call

JSON Payload

PropertyTypeDescriptionFurther information
rankings.keywordstringThe keyword, which ranking data is requested for
rankings.asinstringThe ASIN, for which ranking data is requested for
rankings.marketplacestringThe marketplace-ID, for which ranking data is requested for.valid marketplace-IDs
filters.startdateThe start-date for which rankings shall be requested for.
filters.enddateThe end-date for which rankings shall be requeste for.
filters.intervalstringThe interval, in which the ranking data shall be returned.valid intervals
JSON Response

PropertyTypeDescription
items.marketplace.idstringThe marketplace ID, which the returned rankings refer to
items.marketplace.namestringThe marketplace name, which the returned rankings refer to
items.asinstringThe ASIN, which the returned rankings refer to
items.keywordstringThe keyword, which the returned rankings refer to
items.history.datedateDepending of the requested interval, the day / week / month / year the returned rankings refer to.
items.history.date.maxfloatThe hightes (worst) ranking within the requested interval for the keyword-ASIN-marketplace-combination.
items.history.date.minfloatThe lowest (best) ranking within the requested interval for the keyword-ASIN-marketplace-combination.
items.history.date.avgfloatThe average ranking within the requested interval for the keyword-ASIN-marketplace-combination.
Updates / Changes
VersionDescription
Menu