Data ScraperWeb Site

Amazon Category

ScrapeIN Amazon Category API Response Description

When making a request with the /category endpoint ScrapeIN returns results based on either the URL provided in the url parameter or the Category ID specified in the category_id parameter which is obtained from the Navigaton API, along with the Amazon domain specified in the amazon_domain parameter.

The API response showcases the powerful capabilities of ScrapeIN in extracting and providing comprehensive data from Amazon's category listings.

ScrapeIN retrieves results from the category listing pages on Amazon with the following properties:

JSON Example

{
  "category_results": [
    {
      "position": 1,
      "title": "Nespresso Capsules VertuoLine, Medium and Dark Roast Coffee, Variety Pack, Stormio, Odacio, Melozio, 30 Count, Brews 7.77 Fl Oz (Pack of 3 )",
      "asin": "B01N05APQY",
      "link": "https://www.amazon.com/dp/B01N05APQY",
      "categories": [
        {
          "name": "Coffee, Tea & Espresso"
        }
      ],
      "image": "https://m.media-amazon.com/images/I/61J0e7d0GEL._AC_UL320_.jpg",
      "is_prime": true,
      "rating": 4.8,
      "ratings_total": 54769,
      "sponsored": false,
      "prices": [
        {
          "symbol": "$",
          "value": 37.5,
          "currency": "USD",
          "raw": "$37.50"
        }
      ],
      "price": {
        "symbol": "$",
        "value": 37.5,
        "currency": "USD",
        "raw": "$37.50"
      }
    },
    {
      "position": 2,
      "title": "Nespresso Capsules VertuoLine, Melozio, Medium Roast Coffee, Coffee Pods, Brews 7.77 Fl Ounce (VERTUOLINE ONLY), 10 Count (Pack of 3)",
      "asin": "B0768N9N6M",
      "link": "https://www.amazon.com/dp/B0768N9N6M",
      "categories": [
        {
          "name": "Coffee, Tea & Espresso"
        }
      ],
      "image": "https://m.media-amazon.com/images/I/71CmEDQIn-S._AC_UL320_.jpg",
      "is_prime": true,
      "rating": 4.8,
      "ratings_total": 26719,
      "sponsored": false,
      "prices": [
        {
          "symbol": "$",
          "value": 37.5,
          "currency": "USD",
          "raw": "$37.50"
        }
      ],
      "price": {
        "symbol": "$",
        "value": 37.5,
        "currency": "USD",
        "raw": "$37.50"
      }
    },
  ],
  "category_information": {
    "is_landing_page": true
  },
  "refinements": {
    "department": [
      {
        "name": "Home & Kitchen",
        "link": "https://www.amazon.com/s?bbn=1055398&rh=n%3A1055398&dc&qid=1687982716&ref=lp_915194_ex_n_1",
        "refinement_display_name": "Department"
      },
      {
        "name": "Kitchen & Dining",
        "link": "https://www.amazon.com/s?bbn=284507&rh=n%3A1055398%2Cn%3A284507&dc&qid=1687982716&ref=lp_915194_ex_n_1",
        "refinement_display_name": "Department"
      },
    ],
    "product_grade": [
      {
        "name": "Commercial Grade",
        "link": "https://www.amazon.com/s?bbn=915194&rh=n%3A915194%2Cp_n_feature_five_browse-bin%3A5616183011&dc&qid=1687982716&rnid=5616182011&ref=lp_915194_nr_p_n_feature_five_browse-bin_0",
        "refinement_display_name": "Product Grade"
      }
    ],
  },
  "category_list": [
    {
      "title": "Coffee, Tea, and Espresso",
      "link": "https://www.amazon.com/s/ref=s9_acss_bw_cg_HarKCoff_1a1_w?fst=as%3Aoff&rh=n%3A1055398%2Cn%3A%211063498%2Cn%3A284507%2Cn%3A915194%2Cp_89%3AKeurig%7CHamilton+Beach%7CBonavita%7CMr.+Coffee%7CBLACK%2BDECKER%7CDeLonghi%7CCuisinart%7CSharkNinja%7CTechnivorm+Moccamaster%2Cp_76%3A1249155011%2Cp_6%3AATVPDKIKX0DER%2Cp_72%3A1248915011&bbn=915194&ie=UTF8&qid=1528934531&rnid=1248913011&lo=kitchen&pf_rd_m=ATVPDKIKX0DER&pf_rd_s=merchandised-search-1&pf_rd_r=77F7TCMJPA3PPD1W77HG&pf_rd_t=101&pf_rd_p=04afe6c4-9f9d-468f-ae93-7c445fdf55da&pf_rd_i=915194",
      "image": "https://images-na.ssl-images-amazon.com/images/G/01/img18/home/Harmony/Headers/CoffeeTeaEspresso/Harmony_Herotator_CoffeeTeaEspresso.jpg"
    },
    {
      "title": "Coffee Maker Combos",
      "link": "https://www.amazon.com/b/ref=s9_acss_bw_cg_HarKCoff_2a1_w?node=14163731&pf_rd_m=ATVPDKIKX0DER&pf_rd_s=merchandised-search-2&pf_rd_r=77F7TCMJPA3PPD1W77HG&pf_rd_t=101&pf_rd_p=0089c99b-1d93-471a-bed9-bd6cd53bd435&pf_rd_i=915194",
      "image": "https://images-na.ssl-images-amazon.com/images/G/01/img18/home/Harmony/Nav_Tiles/CoffeeTeaEspresso/Nav1_CoffeeTeaEspresso._CB476881925_.jpg"
    },
  ],
  "pagination": {
    "total_results": 50000
  }
}

JSON Structure

The JSON structure returned by the Amazon API includes required elements, such as request_parameters, request_metadata, pagination, as described in the Results Amazon Data API section, as well as those specific to Amazon category data, which are described below.

category_information

An object with details about the current page of category results.

  • is_landing_page: A boolean value indicating if the current page is a category landing page. If the value is true, it means the page is a higher-level summary page. In such cases, you should either navigate to a lower-level category or use the refinements parameter to move to a category listing page.

pagination

An object provides information about the pagination of the offers. The parameters in the JSON response are as follows:

  • total_results: Represents the total number of results found for the search query.
  • current_page: Indicates the current page number that is displayed in the pagination.
  • next_page_link: Provides the URL or link to the next page of results. By following this link, you can access the next set of items in the category. The provided link leads to the second page of results in the "electronics" category on Amazon.
  • total_pages: Specifies the total number of pages required to display all the results.

To paginate specify the page number in your request parameter.

refinements

An object contains details of the available refinements for the given category results. These allow for narrowing down the category by criteria such as "Reviews rating 4 and over", "Price range", "Brand", and others. To refine your category results based on a specific refinement value, you should specify the desired values as comma-separated in the refinements parameter of your request.

📘

Note on Refinements

Refinement values are dynamic and can vary depending on the category area used. To obtain the available refinements for a specific category area or category term, it is recommended to first make a Category request without specifying any refinements. This will retrieve a master list of the available refinements, which you can cache for future use in subsequent requests.

Sometimes, Amazon may not provide an explicit refinement value and instead return a link. In such cases, you can pass the link into the url parameter of a subsequent Category request. This allows you to retrieve data from the refinement-filtered page.

In the JSON response, the refinements parameter refers to a section that contains refinement options for filtering search results. Within the response, the refinements object has a property name for each available refinement. Each property contains an array with the corresponding value, such as

  • name: The full-text name of the refinement, such as "Free Shipping by Amazon".
  • value: The value of the refinement. You should specify the refinement value(s) as comma-separated in the refinements parameter of your request. For example, it is "n:6463520011||p_76/1249137011".
  • link: The link associated with the refinement. You can use this link in a new category request's url parameter to access the category results filtered by this refinement.
  • refinement_display_name: The refinement display name is "Prime." This name is shown to users to indicate that the refinement corresponds to products eligible for Amazon Prime, a premium membership service that offers free shipping and other benefits.

category_results

The property contains an array of results obtained from scraping the Amazon category section. Each result includes the following information:

  • position: The position of the product in the category listing.

  • title: The title or name of the product.

  • asin: The Amazon Standard Identification Number (ASIN) of the product, which serves as a unique identifier ("B09RMRNSBF").

  • link: The URL link to the product's page on Amazon.

  • availability: The availability status of the product. The raw availability information provided is "Only 19 left in stock - order soon."

  • categories: An array of categories associated with the product. For example, the product belongs to the "OLED TVs" category, with a category ID of "6463520011".

  • image: The URL link to the product's image.

  • sponsored: Set to true or false depending on whether the search result is a sponsored listing or not.

  • add_on_item: An object represents an item in the Amazon 'add-on item' program.

    • is_add_on_item: Indicates whether the product is an add-on item (true/false).

  • is_prime: A boolean value indicating whether the product is eligible for Amazon Prime.

  • categories: An array contains details of the categories associated with the product, displayed next to the search bar on the page. Each object in the array has the following properties:

    • name: The name of the category.

  • bestseller: An object contains details of whether the product is a bestseller in a specific category.

    • category: The name of the category in which the product is a bestseller.

  • rating: The average rating of the product.

  • ratings_total: The total number of ratings received by the product.

  • prices: An array of price details for the product. For example, the price entry can provide the following properties:

    • symbol: The currency symbol, "$".
    • value: The price value is 1696.99.
    • currency: The currency code "USD".
    • raw: The raw price value as a string "$1696.99".
    • name: The price name is "$1696.99".
    • is_rpp: A boolean value that indicates whether the price is the recommended retail price (RRP) or not. A value of true signifies that the price is the suggested retail price for the product.

  • price: An object represents the main price of the product. It is included for convenience and provides the "main" information about the product.

category_list

An array of Category List objects. It contains information about categories when a specific "intermediate" category URL is provided using the url parameter in the request. These "intermediate" category URLs are landing pages that show a branded list of sub-categories. For example, the parameter node=284507 specifies the specific category node or identifier within the Amazon hierarchy.

It's important to note that the categories in this array are obtained directly from the category listing page itself, not from the Amazon Navigation API. Each category in the array has its own set of properties.

  • title: Represents the title of the sub-category linked to from the intermediate category page.
  • link: Provides a link to the sub-category from the intermediate category page. This link can be used in a subsequent category request by passing it as a value to the url parameter, allowing retrieval of category listings from that specific page.
  • image: Represents the image of the sub-category from the intermediate category page, if it is displayed.