Owler Scraper

API Endpoints

The Amazon Scraper API provides endpoints for extracting various types of data from Amazon. The API is designed to be simple and easy to use, with clear documentation and examples to help you get started. For full documentation, code examples and test environment, check our API documentation. For full documentation, code examples and test environment, check our API documentation

1. Amazon Reviews - Collect by URL

Endpoint:

POST /api/ecommerce/amazon-scraper/reviews

Description:

This endpoint collects reviews for a specific Amazon product URL. Users can specify the number of days to look back and optionally filter by a keyword.

Request Headers:

Request Body:

[
  {
    "url": "https://www.amazon.com/dp/B01DFKC2SO",
    "days_range": 30,
    "keyword": "quality"
  }
]
    

Response:

200 OK

{
  "data": [
    {
      "review_text": "Great quality product...",
      "rating": 5,
      "date": "2023-09-01",
      "verified_purchase": true
    }
    // More review objects...
  ]
}
    

2. Amazon Products - Collect by URL

Endpoint:

POST /api/ecommerce/amazon-scraper/products

Description:

This endpoint collects detailed information about specific Amazon products by their URLs.

Request Headers:

Request Body:

[
  {
    "url": "https://www.amazon.com/dp/B01DFKC2SO"
  }
]
    

Response:

200 OK

{
  "data": [
    {
      "title": "Product Name",
      "price": 29.99,
      "rating": 4.5,
      "number_of_reviews": 1000,
      "features": [
        "Feature 1",
        "Feature 2"
      ]
    }
  ]
}
    

3. Amazon Products - Discover by Keyword

Endpoint:

POST /api/ecommerce/amazon-scraper/products-by-keyword

Description:

This endpoint discovers Amazon products based on a provided keyword.

Request Headers:

Request Body:

[
  {
    "keyword": "wireless headphones"
  }
]
    

Response:

200 OK

{
  "data": [
    {
      "title": "Wireless Headphones Model X",
      "url": "https://www.amazon.com/dp/B01EXAMPLE",
      "price": 59.99,
      "rating": 4.2
    }
    // More product objects...
  ]
}
    

4. Amazon Global Products - Collect by URL

Endpoint:

POST /api/ecommerce/amazon-scraper/global-products

Description:

This endpoint collects detailed information about Amazon products from the global dataset by their URLs.

Request Headers:

Request Body:

[
  {
    "url": "https://www.amazon.com/dp/B01EXAMPLE"
  }
]
    

Response:

200 OK

{
  "data": [
    {
      "title": "Global Product Name",
      "price": 39.99,
      "rating": 4.7,
      "number_of_reviews": 2000,
      "features": [
        "Global Feature 1",
        "Global Feature 2"
      ],
      "country": "US"
    }
  ]
}
    

5. Amazon Global Products - Discover by Keywords

Endpoint:

POST /api/ecommerce/amazon-scraper/global-products-by-keywords

Description:

This endpoint discovers Amazon products from the global dataset using keywords and specific Amazon domains.

Request Headers:

Request Body:

[
  {
    "keywords": "smartphone",
    "domain": "https://www.amazon.co.uk"
  }
]
    

Response:

200 OK

{
  "data": [
    {
      "title": "Smartphone Model Y",
      "url": "https://www.amazon.co.uk/dp/B01EXAMPLE",
      "price": 299.99,
      "rating": 4.5,
      "country": "UK"
    }
    // More product objects...
  ]
}
    

6. Amazon Products Search

Endpoint:

POST /api/ecommerce/amazon-scraper/products-search

Description:

This endpoint performs a search for Amazon products across different domains using specified keywords.

Request Headers:

Request Body:

[
  {
    "keyword": "gaming laptop",
    "url": "https://www.amazon.com"
  }
]
    

Response:

200 OK

{
  "data": [
    {
      "title": "High-Performance Gaming Laptop",
      "url": "https://www.amazon.com/dp/B01GAMEXAMPLE",
      "price": 1299.99,
      "rating": 4.6,
      "number_of_reviews": 500
    }
    // More product objects...
  ]
}
    

7. Amazon Sellers Info

Endpoint:

POST /api/ecommerce/amazon-scraper/sellers-info

Description:

This endpoint retrieves detailed information about Amazon sellers based on their seller page URLs.

Request Headers:

Request Body:

[
  {
    "url": "https://www.amazon.com/sp?seller=A2EXAMPLE777"
  }
]
    

Response:

200 OK

{
  "data": [
    {
      "seller_name": "TechGadgets Inc.",
      "seller_rating": 4.8,
      "total_ratings": 10000,
      "products_offered": 500,
      "joined_date": "2015-03-15",
      "business_address": "123 Tech St, Silicon Valley, CA 94000"
    }
  ]
}
    

Authentication

All API requests must include an Authorization header with a valid Bearer token. You can generate an API token by logging into your account and navigating to the API token management section.

Example:

Authorization: Bearer YOUR_API_TOKEN

Error Handling

The API uses standard HTTP status codes to indicate the success or failure of an API request. Here are the common status codes and their meanings:

• 200 OK: The request was successful.
• 201 Created: The resource was successfully created.
• 400 Bad Request: There was an error with the request, such as validation errors.
• 401 Unauthorized: The request did not include a valid API token.
• 403 Forbidden: The user does not have permission to access the resource.
• 404 Not Found: The requested resource could not be found.
• 429 Too Many Requests: The user has sent too many requests in a given amount of time.
• 500 Internal Server Error: There was an error on the server.

Rate Limiting

To ensure fair usage and maintain service quality, API requests are subject to rate limiting. The current limit is 50 requests per minute per API token. If you exceed this limit, you'll receive a 429 Too Many Requests response.