DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Keyword Intersections
The Amazon search terms two or more products both rank for. Pages with limit, offset and offset_token; use the token past the first pages. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. Where post_dataforseo_labs_amazon_product_competitors_live names the rivals, this names the terms they contest.
Pricing reference
- Metering: Reported response cost.
- Reference request estimate: USD 0.1356.
- Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.
Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.
- Type: array (object | null)[]
- asinsType: object | null
asins of target products
required field
product IDs of the products for which you need to find keyword intersections;
specify the ASINs as in the following example:"asins": {
"1": "019005476X",
"2": "0190074442"
}
the maximum number of ASINs you can specify in this object is 20;
learn more about the parameter on this help center page- propertyType: string | null
Name
- filtersType: array (object | null)[] | null
array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operatorand,orbetween the conditions
the following operators are supported:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,ilike,not_ilike,like,not_like,match,not_match
you can use the%operator withlikeandnot_like, as well asilikeandnot_iliketo match any string of zero or more characters
example:["avg_position","<", 10]for more information about filters, please refer to Dataforseo Labs - Filters or this help center guide
Empty object - intersectionType: string | null
_mode - languageType: string | null
_code language code
required field if don't specifylanguage_name
you can receive the list of available languages with theirlanguage_codeby making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:en - languageType: string
_name full name of the language
required field if don't specifylanguage_code
you can receive the list of available languages with theirlanguage_nameby making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:English - limitType: integer | null
the maximum number of products in the results array
optional field
default value:100;
maximum value:1000 - locationType: integer
_code location code
required field if don't specifylocation_name
you can receive the list of available locations with theirlocation_codeby making a separate request tohttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US, Egypt, Saudi Arabia, and the United Arab Emirates locations only;
example:2840 - locationType: string
_name full name of the location
required field if don't specifylocation_code
you can receive the list of available locations with theirlocation_nameby making a separate request tohttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Note: this endpoint currently supports the US, Egypt, Saudi Arabia, and the United Arab Emirates locations only;
example:United Kingdom - offsetType: integer | null
offset in the results array of returned keywords
optional field
default value:0
if you specify the10value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords - orderType: array string[] | null
_by results sorting rules
optional field
you can use the same values as in thefiltersarray to sort the results
possible sorting types:asc- results will be sorted in the ascending orderdesc- results will be sorted in the descending order
you should use a comma to set up a sorting parameter
example:["sum_position,desc"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:["intersections,desc","avg_position,asc"]
default rule:["intersections,desc"] - tagType: string | null
user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specifiedtagvalue in thedataobject of the response
- Type: object | null · Response36Afe1097B20_DataforseoLabsAmazonProductKeywordIntersectionsLiveResponseInfo200
- Type: number | null Format: doublecost
total tasks cost, USD
- Type: integer | nullstatus
_code general status code you can find the full list of the response codes here
- Type: string | nullstatus
_message general informational message you can find the full list of general informational messages here
- Type: array (object | null)[] | nulltasks
array of tasks
- Type: object | null · Response36Afe1097B20_DataforseoLabsAmazonProductKeywordIntersectionsLiveTaskInfo
- costType: number | null Format: double
total tasks cost, USD
- dataType: object | null
contains the same parameters that you specified in the POST request
- propertyType: object | null
Name
- idType: string | null
task identifier unique task identifier in our system in the UUID format
- pathType: array (string | null)[] | null
URL path
- resultType: array (object | null)[] | null
array of results
- asinsType: object | null
ASINs in a POST array
- propertyType: string | null
Name
- itemsType: array (object | null)[] | null
contains detected Amazon product competitors and related data
- intersectionType: object | null
_result data on the intersection
- propertyType: object | null · Response36Afe1097B20_AmazonInfo
Name - asinType: string | null
ASIN in a POST array
- boughtType: integer | null
_past _month Integer numbers.
- currencyType: string | null
- deliveryType: object | null · Response36Afe1097B20_AmazonDeliveryInfo
_info delivery information
delivery information including free and fast delivery date ranges- deliveryType: string | null
_date _from the earliest date when the product can be shipped
- deliveryType: string | null
_date _to the latest date when the product can be delivered
- deliveryType: string | null
_message message accompanying the delivery information as posted by the seller
- deliveryType: object | null · Response36Afe1097B20_PriceInfo
_price price for the delivery price of the delivery based on the location you specified in the POST request; if free delivery is available, the value is null
- currencyType: string | null
currency of the listed price ISO code of the currency applied to the price
- currentType: number | null Format: double
current price indicates the current price of the product or service featured in the result
- displayedType: string | null
_price price string in the result raw price string as provided in the result
- isType: boolean | null
_price _range price is provided as a range indicates whether a price is provided in a range
- maxType: number | null Format: double
_value the maximum price the maximum price of the product or service as indicated in the result
- regularType: number | null Format: double
regular price indicates the regular price of the product or service with no discounts applied
- fastestType: string | null
_delivery _date _from the earliest date when the product can be delivered with a fast delivery option
- fastestType: string | null
_delivery _date _to the latest date when the product can be delivered with a fast delivery option
- domainType: string | null
Amazon domain
- imageType: string | null
_url URL of the product image featured in the results
- isType: boolean | null
_amazon _choice "Amazon's choice" label
if the value istrue, the product is marked with the "Amazon's choice" label - isType: boolean | null
_best _seller "Best Seller" label
if the value istrue, the product is marked with the "Best Seller" label - positionType: string | null
the alignment of the element in Amazon SERP
can take the following values:left,right - priceType: number | null
_from the regular price of a product
example:49.98 - priceType: number | null
_to the upper limit of the product price range
example:384.99 - rankType: integer | null
_absolute absolute rank in Amazon SERP
absolute position among all the elements in SERP - rankType: integer | null
_group position within a group of elements with identical
typevalues
positions of elements with differenttypevalues are omitted fromrank_group - ratingType: object | null · Response36Afe1097B20_RatingInfo
the item's rating
the popularity rate based on reviews and displayed in SERP- ratingType: integer | null
_max the maximum value for a rating_type
- ratingType: string | null
_type the type of rating here you can find the following elements: Max5, Percents, CustomMax
- valueType: number | null Format: float
the value of the rating
- votesType: integer | null Format: int64
_count the amount of feedback
- seType: string | null
_type search engine type
- specialType: array (string | null)[] | null
_offers special offer details
contains special offer details, including coupon and Subscribe & Save discounts - titleType: string | null
product title
- typeType: string | null
type of element
- urlType: string | null
URL of the product page
- xpathType: string | null
the XPath of the element
- keywordType: object | null · Response36Afe1097B20_AmazonKeywordData
_data keyword data for the returned keyword
- keywordType: string | null
related keyword
- keywordType: object | null · Response36Afe1097B20_AmazonKeywordInfo
_info keyword info for the returned keyword
- lastType: string | null
_updated _time date and time when keyword data was updated in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: '2019-11-15 12:57:46 +00:00'
- seType: string | null
_type search engine type
- searchType: integer | null Format: int64
_volume average monthly search volume rate represents the (approximate) number of searches for the provided keyword idea on Amazon
- languageType: string | null
_code language code in a POST array
- locationType: integer | null Format: int64
_code location code in a POST array
- seType: string | null
_type search engine type
- seType: string | null
_type search engine type
- itemsType: integer | null Format: int64
_count the number of results returned in the
itemsarray - languageType: string | null
_code language code in a POST array
if there is no data, then the value is_null - locationType: integer | null
_code location code in a POST array
if there is no data, then the value is_null - seType: string | null
_type search engine type
- totalType: integer | null Format: int64
_count total amount of results in our database relevant to your request
- resultType: integer | null Format: int64
_count number of elements in the result array
- statusType: integer | null
_code status code of the task generated by DataForSEO, can be within the following range: 10000-60000 you can find the full list of the response codes here
- statusType: string | null
_message informational message of the task you can find the full list of general informational messages here
- timeType: string | null
execution time, seconds
- Type: integer | null Format: int64tasks
_count the number of tasks in the tasks array
- Type: integer | null Format: int64tasks
_error the number of tasks in the tasks array returned with an error
- Type: string | nulltime
total execution time, seconds
- Type: string | nullversion
the current version of the API
application/json - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
Error response; upstream passthrough responses may use provider formats
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/amazon/product_keyword_intersections/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"asins": {
"1": "B09172433Z",
"2": "B07GBZ4Q68",
"3": "B07GCKQD77"
},
"language_name": "English",
"location_code": 2840
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"se_type": null,
"asins": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"keyword_data": "[Max Depth Exceeded]",
"intersection_result": null
}
]
}
]
}
]
}