Amazon Categories Scraper

An Apify actor that scrapes the main navigation categories and their URLs from Amazon's regional websites.

Overview

This tool extracts structured category data from Amazon's country-specific domains. You provide a country code, and it returns a JSON array of category titles and their corresponding links from the site's primary navigation.

Key Features

• Scrapes category titles and URLs from Amazon's main navigation.
• Supports 24 regional Amazon sites (e.g., amazon.com, amazon.co.uk, amazon.de).
• Returns clean, structured JSON data.
• Handles country-specific domain logic automatically.
• Includes error handling and logging.

Input

The actor requires a single input parameter.

• countryIso (string, required): The two-letter ISO country code for the target Amazon site. Defaults to "us".
  • Valid codes: au, be, br, ca, cn, de, eg, es, fr, gb, ie, in, it, jp, mx, nl, pl, sa, se, sg, tr, us, za, ae.

Input Example:

{
  "countryIso": "de"
}

Output

The actor outputs an array of objects. Each object represents a main navigation section and contains its categories.

Each category object within the array has:
* title (string): The display name of the category.
* url (string): The full URL to the category page.
* mainId (string): An internal identifier for the main section.

Output Example:

[
  {
    "categories": [
      {
        "title": "All Videos",
        "url": "https://www.amazon.com/Amazon-Video/b?node=2858778011"
      }
    ],
    "mainId": "2"
  }
]

How to Use

Apify Console

1. Go to the actor in your Apify console.
2. Click Start.
3. Select the desired countryIso from the dropdown.
4. Click Start again to run it.
5. Download the results from the dataset when the run finishes.

Apify API (JavaScript)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });
const input = { countryIso: 'jp' };

const run = await client.actor('ACTOR_ID').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

HTTP API

curl -X POST https://api.apify.com/v2/acts/ACTOR_ID/runs \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"countryIso":"fr"}'