Data ScraperWeb Site

Results Navigation API

ScrapeIN Amazon Navigation API Response Description.

The method provided by the Amazon Navigation API's endpoint, /navigation, allows you to perform two main functions: listing categories and searching for categories on a specific Amazon domain.

  1. Listing Categories
    Using the /navigation endpoint, you can retrieve a list of categories available on a specific Amazon domain. This functionality is particularly useful when you want to explore the hierarchical structure of categories and subcategories offered by Amazon. By listing categories, users can obtain an overview of the available product categories to navigate through the Amazon catalog effectively.
  2. Searching for Categories
    The /navigation endpoint also enables you to search for specific categories on a given Amazon domain. This functionality comes in handy when you want to locate a particular category or narrow down your search based on specific criteria. By performing category searches, users can quickly find and access the desired product categories without having to browse through the entire category tree.

JSON Example

{
  "request_info": {
    "success": true
  },
  "categories": [
    {
      "id": "13299131",
      "name": "Outdoor Kitchen Appliances",
      "has_children": true,
      "is_root": false,
      "path": "Patio, Lawn & Garden > Grills & Outdoor Cooking > Outdoor Kitchen Appliances & Storage > Outdoor Kitchen Appliances",
      "link": "https://www.amazon.com/s?node=13299131",
      "parent_id": "2253417011",
      "parent_name": "Outdoor Kitchen Appliances & Storage",
      "type": "standard",
      "domain": "amazon.com"
    },
    {
      "id": "18098890011",
      "name": "Restaurant Appliances & Equipment",
      "has_children": true,
      "is_root": false,
      "path": "Industrial & Scientific > Food Service Equipment & Supplies > Restaurant Appliances & Equipment",
      "link": "https://www.amazon.com/s?node=18098890011",
      "parent_id": "6054382011",
      "parent_name": "Food Service Equipment & Supplies",
      "type": "standard",
      "domain": "amazon.com"
    },
    {
      "id": "166350011",
      "name": "Real-Food Appliances",
      "has_children": false,
      "is_root": false,
      "path": "Toys & Games > Dress Up & Pretend Play > Pretend Play > Kitchen Toys > Real-Food Appliances",
      "link": "https://www.amazon.com/s?node=166350011",
      "parent_id": "166343011",
      "parent_name": "Kitchen Toys",
      "type": "standard",
      "domain": "amazon.com"
    },
    {
      "id": "155295011",
      "name": "Appliances",
      "has_children": false,
      "is_root": false,
      "path": "Automotive > RV Parts & Accessories > Appliances, Heating, A/C & Ventilation > Appliances",
      "link": "https://www.amazon.com/s?node=155295011",
      "parent_id": "155287011",
      "parent_name": "Appliances, Heating, A/C & Ventilation",
      "type": "standard",
      "domain": "amazon.com"
    },
    {
      "id": "289742",
      "name": "Coffee, Tea & Espresso Appliances",
      "has_children": true,
      "is_root": false,
      "path": "Home & Kitchen > Kitchen & Dining > Small Appliances > Coffee, Tea & Espresso Appliances",
      "link": "https://www.amazon.com/s?node=289742",
      "parent_id": "289913",
      "parent_name": "Small Appliances",
      "type": "standard",
      "domain": "amazon.com"
    },
    {
      "id": "2253417011",
      "name": "Outdoor Kitchen Appliances & Storage",
      "has_children": true,
      "is_root": false,
      "path": "Patio, Lawn & Garden > Grills & Outdoor Cooking > Outdoor Kitchen Appliances & Storage",
      "link": "https://www.amazon.com/s?node=2253417011",
      "parent_id": "553760",
      "parent_name": "Grills & Outdoor Cooking",
      "type": "standard",
      "domain": "amazon.com"
    },
    {
      "id": "156257011",
      "name": "Special Appliances",
      "has_children": false,
      "is_root": false,
      "path": "Kindle Store > Kindle eBooks > Nonfiction > Cooking, Food & Wine > Special Appliances",
      "link": "https://www.amazon.com/s?node=156257011",
      "parent_id": "156154011",
      "parent_name": "Cooking, Food & Wine",
      "type": "standard",
      "domain": "amazon.com"
    },
    {
      "id": "155287011",
      "name": "Appliances, Heating, A/C & Ventilation",
      "has_children": true,
      "is_root": false,
      "path": "Automotive > RV Parts & Accessories > Appliances, Heating, A/C & Ventilation",
      "link": "https://www.amazon.com/s?node=155287011",
      "parent_id": "2258019011",
      "parent_name": "RV Parts & Accessories",
      "type": "standard",
      "domain": "amazon.com"
    },
    {
      "id": "289941",
      "name": "Specialty Appliances",
      "has_children": true,
      "is_root": false,
      "path": "Home & Kitchen > Kitchen & Dining > Small Appliances > Specialty Appliances",
      "link": "https://www.amazon.com/s?node=289941",
      "parent_id": "289913",
      "parent_name": "Small Appliances",
      "type": "standard",
      "domain": "amazon.com"
    },
    {
      "id": "11058091",
      "name": "Styling Tools & Appliances",
      "has_children": true,
      "is_root": false,
      "path": "Beauty > Personal Care > Hair Care > Styling Tools & Appliances",
      "link": "https://www.amazon.com/s?node=11058091",
      "parent_id": "11057241",
      "parent_name": "Hair Care",
      "type": "standard",
      "domain": "amazon.com"
    },
    {
      "id": "15735661",
      "name": "Electrical Appliances",
      "has_children": true,
      "is_root": false,
      "path": "Automotive > Interior Accessories > Electrical Appliances",
      "link": "https://www.amazon.com/s?node=15735661",
      "parent_id": "15857501",
      "parent_name": "Interior Accessories",
      "type": "standard",
      "domain": "amazon.com"
    },
    {
      "id": "289913",
      "name": "Small Appliances",
      "has_children": true,
      "is_root": false,
      "path": "Home & Kitchen > Kitchen & Dining > Small Appliances",
      "link": "https://www.amazon.com/s?node=289913",
      "parent_id": "284507",
      "parent_name": "Kitchen & Dining",
      "type": "standard",
      "domain": "amazon.com"
    },
    {
      "id": "4256",
      "name": "Kitchen Appliances",
      "has_children": true,
      "is_root": false,
      "path": "Books > Cookbooks, Food & Wine > Kitchen Appliances",
      "link": "https://www.amazon.com/s?node=4256",
      "parent_id": "6",
      "parent_name": "Cookbooks, Food & Wine",
      "type": "standard",
      "domain": "amazon.com"
    },
    {
      "id": "13397451",
      "name": "Appliances",
      "has_children": true,
      "is_root": false,
      "path": "Tools & Home Improvement > Appliances",
      "link": "https://www.amazon.com/s?node=13397451",
      "parent_id": "468240",
      "parent_name": "Tools & Home Improvement",
      "type": "standard",
      "domain": "amazon.com"
    },
    {
      "id": "18116194011",
      "name": "Laundry Appliances",
      "has_children": true,
      "is_root": false,
      "path": "Appliances > Laundry Appliances",
      "link": "https://www.amazon.com/s?node=18116194011",
      "parent_id": "2619526011",
      "parent_name": "Appliances",
      "type": "standard",
      "domain": "amazon.com"
    },
    {
      "id": "2619526011",
      "name": "Appliances",
      "has_children": true,
      "is_root": true,
      "path": "Appliances",
      "link": "https://www.amazon.com/s?node=2619526011",
      "type": "standard",
      "domain": "amazon.com"
    }
  ]
}

JSON Structure

The Amazon Navigation API returns the following properties:

request_info

An object that provides information about the success of a request made to the Amazon Navigation API's endpoint. In the context of the response, when success is true, it indicates that the request was successful.

categories

An array of category objects containing details of a given category. This parameter holds the information about the categories that match the search criteria. It is present when either the parent_id or search_term request parameters are used.

  • domain: Indicates the specific Amazon marketplace or region to which the category belongs.
  • id: The ID of the category. This parameter uniquely identifies a category and can be used as input for subsequent API requests. For example, you can pass this category ID as the category_id parameter in a search, deals, or bestsellers requests to retrieve information specific to this category.
  • name: The name of the category as it appears on Amazon. It gives a brief description of the category's content or products.
  • has_children: A boolean value indicating whether the category has child categories. If this parameter is true, it means the category contains subcategories or child categories. If it is false, the category does not have any child categories.
  • is_root: A boolean value indicating whether the category is a top-level (root) category. If this parameter is true, it means the category is a top-level category, which serves as the starting point in the category hierarchy. If it is false, the category is not a root category.
  • path: The fully qualified path to the category in the category hierarchy, delimited by > characters. This property shows the hierarchical structure of the category, indicating its position within the category taxonomy. The path displays the sequence of parent categories leading to the current category ("Tools & Home Improvement > Appliances").
  • type: Specifies the category type, which can be one of the following values:
    • standard: A standard category without any specific classification.
    • bestsellers: A category that represents the best-selling products in a particular domain or subcategory.
    • gift_ideas: A category featuring gift ideas or recommendations for specific occasions or recipients.
    • most_wished_for: A category containing the most wished-for or desired items.
    • movers_and_shakers: A category showcasing products with a significant increase in sales rank.
    • new_releases: A category displaying newly released products.
    • deals: A category highlighting products with discounted prices or special offers.

current_category

An object with the same properties as the category objects found in the categories array. It provides details about the current category that is being accessed. The current_category parameter is only present when a request is made using the parent_id parameter. It is used to retrieve child categories for a given parent_id.

parent_category

An object with the same properties as the category objects found in the categories array. It provides details about the parent category of the category specified in the parent_id parameter. The parent_category property is only present when a request is made using the parent_id parameter. It is used to retrieve child categories for a given parent_id.

However, if the category specified in the parent_id parameter has the is_root=true property, the parent_category is not returned.

category

An object with the same properties as the category objects found in the categories array. It provides details of a single category requested by the id parameter. The category property is only present when a request is made using the id parameter. It is used to retrieve the details of a specific category.