/amazon-products

Returns information about products on Amazon.

↗ Open in API Explorer
GET

Amazon Products

Returns information about products on Amazon.

Request

Endpoint: GET https://api.outscraper.cloud/amazon-products

Parameters

NameInTypeRequiredDescriptionExampleConstraints
query query array<string> Yes You can use Amazon products, searches, or summary page URLs. It supports batching by sending arrays with up to 1000 queries (e.g., query=text1&query=text2&query=text3). It allows multiple queries to be sent in one request and to save on network latency time. - -
limit query integer No The parameter specifies the limit of products to get from one query (in case of using summary pages). - default 24
domain query string enum No The parameter specifies Amazon domain to use. - default amazon.com, allowed amazon.com, amazon.co.uk, amazon.ca, amazon.de, amazon.es, amazon.fr, amazon.it, amazon.in, …
postal_code query string No The parameter specifies the postal code for delivery. - default 11201
language query string enum No The parameter specifies the language to use for website. - default en, allowed en, de, es, es-419, fr, hr, it, nl, …
fields query string No The parameter defines which fields you want to include with each item returned in the response. By default, it returns all fields. Use &fields=query,name to return only the specific ones. - -
async query boolean Yes The parameter defines the way you want to submit your task to Outscraper. It can be set to false to open an HTTP connection and keep it open until you got your results, or true (default) to just submit your requests to Outscraper and retrieve them later (usually within 1-3 minutes) with the Request Results endpoint. Each response is available for 4 hours after a request has been completed. A good practice is to send async requests and start checking the results after the estimated execution time. Check out this Python implementation as an example. As most of the requests take some time to be executed the async=true option is preferred to avoid HTTP requests timeouts. - default true
ui query boolean No The parameter defines whether a task will be executed as a UI task. This is commonly used when you want to create a regular platform task with API. Using this parameter overwrites the async parameter to true. - default false
format query array<string enum> No The parameter defines the format of the output data. Using this parameter overwrites the ui parameter to true. - -
webhook query string No The parameter defines the URL address (callback) to which Outscraper will create a POST request with a JSON body once a task/request is finished. Using this parameter overwrites the webhook from integrations. - -

Responses

200

application/json

The response contains the status of the request and data. Data is an array where each element represents a response for a single query from the request.

{
  "id": "your-request-id",
  "status": "Success",
  "data": [
    [
      {
        "short_url": "https://www.amazon.com/Lacoste-Womens-Stainless-Leather-Calfskin/dp/B00G3XWLR8",
        "asin": "B00G3XWLR8",
        "name": "Lacoste Women's 12.12 Stainless Steel Quartz Watch with Leather Calfskin Strap, Taupe, 16 (Model: 2001150)",
        "rating": null,
        "reviews": null,
        "answered_questions": null,
        "fast_track_message": null,
        "about": "ON TIME, IN STYLE: Once upon a time there was a polo shirt that made history now it has inspired a ladies timepiece to follow in its footsteps. The Lacoste.12.12 Lady is the epitome of sporty chic and comfort, with thoughtful dashes of detail. Game, set and match for style., QUALITY MATERIALS: Women's 36 mm pale rose gold ion-plated stainless steel case with a taupe leather strap featuring a carnation gold dial., QUARTZ MULTIFUNCTION: It’s a battery-powered watch that sends energy through a quartz crystal. Is typically built into three separate dials for the day of the week, date of the month and 24-hour time., DURABLE MINERAL CRYSTAL: Made from glass and protects watch from scratches., 2 YEAR WARRANTY: Lacoste offers a 2-year limited warranty against defects in materials and workmanship that prevent the watch from functioning properly under normal use. Only purchases from an authorized retailer are covered by the manufacturer’s warranty.",
        "description": "The Lacoste legend was born in 1933, when Rene Lacoste revolutionized men's fashion replacing the classical woven fabric, long-sleeved and starched shirts on the courts, by what has now become the classic LACOSTE polo shirt. More than 75 years after its creation, LACOSTE has become a lifestyle brand which allies elegance and comfort. The LACOSTE art of living expresses itself today through a large collection of apparel for women, men and children, footwear, fragrances, leather goods, eyewear, watches, belts, home textiles, and fashion jewelry. LACOSTE founds its success on the essential values of authenticity, performance, and elegance. The crocodile incarnates today the elegance of the champion, Rene Lacoste, as well as of his wife Simone Lacoste and their daughter Catherine Lacoste, both also champions, in everyday life as on the tennis courts and golf courses. The Crocodile's origins The true story of the \"Crocodile\" begins in 1923 after a bet that Rene Lacoste had with the Captain of the French Davis Cup Team, Allan H. Muhr, who promised him an alligator suitcase if he won an important game for the team. This episode was reported in an article in the Boston Evening Transcript, where his nickname of the Crocodile came to life for the first time. The American public grew fond of this nickname which highlighted the tenacity he displayed on the tennis courts, never giving up his prey. His friend Robert George drew him a crocodile which was embroidered on the blazer he wore on the courts. The Legend was born.",
        "categories": [
          "Clothing, Shoes & Jewelry",
          "Women",
          "Watches",
          "Wrist Watches"
        ],
        "store_title": "Lacoste Store",
        "store_url": "https://www.amazon.com/stores/Lacoste/page/C85490CB-0E64-4F8B-89A8-217111AFF6FE?ref_=ast_bln",
        "price": "$175.00",
        "availability": "In stock soon. Order it now.",
        "strike_price": null,
        "price_saving": null,
        "shipping": "",
        "merchant_info": "",
        "bage": "",
        "currency": null,
        "image_1": "https://m.media-amazon.com/images/I/314jzz9RfsL.jpg",
        "image_2": "https://m.media-amazon.com/images/I/31he4kecs0L.jpg",
        "image_3": "https://m.media-amazon.com/images/I/31FgebhbXEL.jpg",
        "image_4": "https://m.media-amazon.com/images/I/41IYiTJyLIL.jpg",
        "image_5": "https://m.media-amazon.com/images/I/41gZMv+FwoL.jpg",
        "overview": null,
        "details": {
          "details.brand_seller_or_collection_name": "Lacoste",
          "details.model_number": "2001150",
          "details.part_number": "2001150",
          "details.item_shape": "Round",
          "details.dial_window_material_type": "Mineral",
          "details.display_type": "Analog",
          "details.clasp": "Tang Buckle",
          "details.case_material": "Stainless Steel",
          "details.case_diameter": "36 millimeters",
          "details.case_thickness": "9.75 millimeters",
          "details.band_material": "Leather",
          "details.band_size": "Womens Standard",
          "details.band_width": "16 millimeters",
          "details.band_color": "Brown",
          "details.dial_color": "Carnation Gold",
          "details.bezel_material": "Stainless Steel",
          "details.bezel_function": "Stationary",
          "details.calendar": "Day-Date",
          "details.movement": "Quartz",
          "details.water_resistant_depth": "50 Meters",
          "details.warranty": "Manufacturer’s warranty can be requested from customer service. to make a request to customer service.",
          "details.package_dimensions\n‏\n\n‎": "3.58 x 3.46 x 3.23 inches; 3.84 Ounces",
          "details.item_model_number\n‏\n\n‎": "2001150",
          "details.department\n‏\n\n‎": "Womens",
          "details.date_first_available\n‏\n\n‎": "January 13, 2021",
          "details.manufacturer\n‏\n\n‎": "Lacoste",
          "details.asin\n‏\n\n‎": "B00G3XWLR8",
          "details.country_of_origin\n‏\n\n‎": "China"
        }
      }
    ]
  ]
}

202

application/json

The response contains a request ID that can be used to fetch results by using Request Results endpoint. Each response is available for 4 hours after a request has been completed.

{
  "id": "your-request-id",
  "status": "Pending",
  "results_location": "https://api.outscraper.cloud/requests/your-request-id"
}

401

application/json

Wrong or missing API Key (token).

{
  "error": true,
  "errorMessage": "401 Unauthorized: The server could not verify that you are authorized to access the URL requested. You either supplied the wrong credentials (e.g. a bad password), or your browser doesn't understand how to supply the credentials required."
}

402

application/json

Past due invoices or a payment method not connected.

{
  "error": true,
  "errorMessage": "Please close past due invoices or verify your card information is correct."
}

422

application/json

Wrong query url parameters.

{
  "error": true,
  "errorMessage": "422 Unprocessable Entity: The request was well-formed but was unable to be followed due to semantic errors."
}

Code Samples

cURL

curl -X GET "https://api.outscraper.cloud/amazon-products?query=https://www.amazon.com/dp/B00G3XWLR8&limit=1&async=false" -H  "X-API-KEY: YOUR-API-KEY"

cURL (async)

curl -X GET "https://api.outscraper.cloud/amazon-products?query=https://www.amazon.com/dp/B00G3XWLR8&limit=1" -H  "X-API-KEY: YOUR-API-KEY"

Python

from outscraper import OutscraperClient

api_client = OutscraperClient(api_key='YOUR-API-KEY')
results = api_client.amazon_products('https://www.amazon.com/dp/B00G3XWLR8', limit=3)

Related Endpoints