search

Enables you to scrape search results from Amazon using the ScrapeIN service.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Endpoint

The /search API endpoint allows you to retrieve the results of your Amazon Search query using the GET method and fetches the search results in a structured format. The search results are retrieved from the search results page on Amazon.

The search results obtained from the /search endpoint usually include a list of products or items that match the specified search criteria. Each item in the result set typically contains information such as the product title, description, price, availability, ratings, and other relevant details. The data you receive through this endpoint is similar to what you would see if you performed the same search directly on the Amazon website.

Authentication

API-KEY. Use your API-KEY for authentication.

Output format

html, json, csv

🚧

Required Parameters

To specify the search, you have the following options:

  1. You can use the amazon_domain and q parameters together. By using these parameters, you can ensure that you retrieve information from the correct version of an Amazon page.
  2. Alternatively, you can provide the url parameter, which should contain the link to an Amazon page. If you use the url parameter, the q and amazon_domain parameters will be disregarded. In this case, the url itself defines the search query parameter (q) used.

Results: Click "200" at the bottom of the page in the Responses block to see the JSON structure of a successful response. For more details click here.

Support

If you have any questions about authentication or API usage, please contact our support team at [email protected].

Query Params
string
enum
Defaults to amazon.com

The Amazon domain to retrieve search results from. You can use the amazon_domain and q parameters together, ensuring that you retrieve information from the correct version of an Amazon page. Check the Supported Amazon Domains for a complete list of domains supported.

string
Defaults to comics

Used to search products. You can use q and the amazon_domain parameters together. By using these parameters, you can ensure that you retrieve information from the correct version of an Amazon page.

string

Specifies the URL to be scraped instead of using the q parameter to perform a search query. The url parameter must be URL-encoded. You can provide the url parameter, which should contain the link to an Amazon page. If you use the url parameter, the q and amazon_domain parameters will be disregarded.

string

Used to refine your search results based on specific criteria such as "Reviews rating 4 and over," "Price range," and "Brand." To use refinements, start by making a q request without specifying any refinements. This will provide you with a list of available refinement options for a category or search item. You can then use these options to customize your searches in the future. Let's take two refinements as examples: n/21579968011 and p_72/1248879011. To include multiple refinements, separate them with commas. In our example, the refinements parameter would be: refinements=n/21579968011,p_72/1248879011. These refinements represent the "Fire TV" department and reviews with a rating of 4 stars and above.

string

Used to narrow down search results based on a specific category. It is recommended to use a category ID obtained from the Navigation API because these IDs are known to be valid and recognized by Amazon.

string
enum

Used to search for products on Amazon, you can choose how the search results are ordered using a parameter. You can sort them by most_recent, price_low_to_high or price_high_to_low, featured items, or average_review. For Audible Amazon Domains, there are additional sorting options such as relevance, bestsellers, running_time_ascending, running_time_descending, and alphabetical sorting by title.

boolean

Used to choose whether to exclude sponsored search results (by setting exclude_sponsored to true) or include them in the search results. By default, it is set to false.

int32

Used to specify the current page of search results you want to retrieve. To determine the total number of pages available for the search results, you can check the total_results property in the pagination object.

int32

Used to get multiple pages of results in one request, the API will paginate through pages automatically and concatenate the results into one response. See the Pagination for more information.

boolean

By default, Amazon shows search results for the corrected search term if a spelling mistake is suspected in the q parameter. To disable this behavior and directly search for the value in q parameter without auto-correction, you can set direct_search=true.

boolean

Specifies if the response should include raw HTML, which may increase its size. The option to include HTML can be true or false (the default), with the latter being the default.

string
enum
Defaults to json

The format of the returned results can be specified using the output parameter. By default, the results are returned in structured JSON format. You can also choose to receive the raw HTML by setting the parameter to html, or the results in CSV format by setting it to csv.

Allowed:
string
enum

Used to determine the location it uses when fetching pages from Amazon. It helps show how a product appears on amazon.com to customers in different countries. It can also identify cross-border shipping information and opportunities. To find the available values for customer_location, refer to the Locations reference. If no customer_location value is provided, the API will automatically make the request from the country corresponding to the Amazon page requested. For example, if the page is from amazon.de, the default customer_location will be "Germany"

string
enum

Used to determines the language in which the API requests the Amazon page to be displayed. This allows you to choose the preferred language for viewing the page. You can refer to the supported Languages list provided by Amazon to see the languages that are supported.

string
enum

Used to determine the currency in which the API requests the Amazon page to display prices and monetary values. By specifying the currency, you can view the prices on the page in your preferred currency. You can refer to the supported Currencies list for each Amazon domain to see the currency values that are supported.

string
enum

This parameter allows you to control the API's behavior when it encounters a parsing incident. You can choose to have the API skip serving the request entirely when a degraded or major parsing incident is detected (value: all), or only skip the request when a "major" parsing incident is detected (value: major_only). If your system is making unsupervised requests to the API, using skip_on_incident can be a useful way to handle incidents gracefully.

Allowed:
string

Allows you to specify the JSON field names you want to include in the response JSON object as a comma-separated list. You can use dot notation to specify the field names - for instance, setting include_fields=pagination will only include the pagination property in the JSON response. The include_fields parameter is useful when you only want certain fields to be included in the JSON response returned by the API.

string

Used to exclude certain fields from the JSON object returned by the API. You can specify the names of the fields to be excluded in dot notation as a comma-separated list. For example, exclude_fields=pagination would remove the pagination property from the response JSON. If there are particular fields you don't want to be included in the API's JSON response, use exclude_fields.

string
Responses

Language
Credentials
Query
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json