Keyword
commerce.keywordUnifiedSoonA search term with its volume, rank and competition.
key marketplace + term + language5 planned calls30 Direct endpoints today
5 calls plannedSoon
Calls from commerce API design 0.1.0-draft, written as REST paths. Each call returns this entity in one shape on the platforms it lists, and none is deployed yet.
- GET
/Figures for one exact term, such as search volume and rank, each with its unit and periodAmazon (13 sites) · Walmart · Google Trends (18 sites)Prototypev1/ e-commerce/ keywords/ metrics - GET
/Listings tied to one term, organic and adAmazon (13 sites) · WalmartPrototypev1/ e-commerce/ keywords/ listings - GET
/Terms related to a seed termAmazon (10 sites) · WalmartPrototypev1/ e-commerce/ keywords/ related - POST
/One request across up to five marketplaces: metrics, listings and related termsAmazon (13 sites) · Walmart · Google Trends (18 sites)Prototypev1/ e-commerce/ keywords/ research - GET
/The terms one listing is tied to, by ASIN or Walmart product IDAmazon (13 sites) · WalmartPrototypev1/ e-commerce/ listings/ {listingId}/ keywords
19 fields in the field contractFrom example responses
The design has no schema for these calls yet, so the keys are read from its example responses.
Request3
What the call was askedkeywordstringlanguagestringmarketplacestring
Metrics7
One row per figure: metric, value, unit and perioddata[].metricstringdata[].valuenumberdata[].unitstringdata[].period.kindstringdata[].period.startdatedata[].period.enddatedata[].match_typestring
Links6
Listings tied to the term, by the platform's own IDdata[].platform_product_idstringdata[].titlestringdata[].organic_ranknumberdata[].ad_ranknumberdata[].traffic_sharenumberdata[].relation_typestring
Context3
Source, collection time and the period the figures coversourceobjectcollected_atdatetimedata_periodobject
decimal and integer values arrive as strings to keep precision. A key ending in _reported is the source's own figure, method unconfirmed; _raw keeps the source's raw code. uuid fields point at other AIsa entities.
Call it today through DirectLive
Vendor endpoints that already return this kind of object, in the vendor's own format. Your code names the vendor, so switching vendors means changing it.
30 endpoints from 2 APIs · from $0.001
| API | Method | Path | Endpoint | Price |
|---|---|---|---|---|
| DataForSEO | GET | dataforseo/dataforseo_labs/amazon/bulk_search_volume/live | Amazon Bulk Search Volume | from $0.14 |
| TikHub | GET | tikhub/tiktok/shop/web/fetch_search_word_suggestion_v2 | tiktok web/fetch_search_word_suggestion | from $0.001 |
| DataForSEO | GET | dataforseo/keywords_data/bing/keywords_for_keywords/live | Setting Live ‘Keywords For Keywords’ Tasks | from $0.09 |
| DataForSEO | GET | dataforseo/keywords_data/clickstream_data/bulk_search_volume/live | Setting Live ‘Bulk Clickstream Search Volume’ Tasks | from $0.09 |
| DataForSEO | GET | dataforseo/keywords_data/google_ads/keywords_for_keywords/live | Setting Live ‘Keywords For Keywords’ Tasks | from $0.09 |
| DataForSEO | GET | dataforseo/dataforseo_labs/google/bulk_keyword_difficulty/live | Bulk Keyword Difficulty | from $0.073 |
| DataForSEO | GET | dataforseo/dataforseo_labs/amazon/ranked_keywords/live | Ranked Keywords | from $0.14 |
| DataForSEO | GET | dataforseo/keywords_data/bing/keywords_for_keywords/task_get/{id} | Get ‘Keywords For Keywords’ Results by id | Metered |
| DataForSEO | GET | dataforseo/keywords_data/clickstream_data/dataforseo_search_volume/live | Setting Live ‘DataForSEO Search Volume’ Tasks | from $0.09 |
| DataForSEO | GET | dataforseo/keywords_data/google_ads/keywords_for_keywords/task_get/{id} | Get ‘Keywords For Keywords’ Results by id | Metered |
| DataForSEO | GET | dataforseo/dataforseo_labs/google/historical_keyword_data/live | Historical Keyword Data | from $0.14 |
| DataForSEO | GET | dataforseo/dataforseo_labs/amazon/related_keywords/live | Related Keywords | from $0.14 |
Showing 12 of 30, a few from each API. Every endpoint is listed on its API's page.
Next to Keyword
Each link is a field you can ask for in the same call.
Listing
marketplace + listing IDOne product page on one marketplace: price, rank, reviews and sales.
Category
taxonomy + codeA node in the Amazon, TikTok, Google or GS1 category tree.
SearchResult
engine + query + rankA ranked result from a search engine or a map.