# Amazon Influencer Storefronts Scraper (`maximedupre/amazon-influencer-storefronts`) Actor

Extract public Amazon influencer profiles and collections from storefront URLs or handles. Optionally expand collections into visible recommended products or include creator videos, and filter by marketplace or public signals. No Amazon login is needed.

- **URL**: https://apify.com/maximedupre/amazon-influencer-storefronts.md
- **Developed by:** [Maxime Dupré](https://apify.com/maximedupre) (community)
- **Categories:** E-commerce, Social media, Marketing
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### 🛍️ Inspect Amazon influencer storefronts

This Actor is for influencer marketing teams, Amazon brands, affiliate managers, and creator researchers. Submit public Amazon storefront URLs or handles and get creator profiles, storefront sections, Idea Lists, curation data, recommended products, and optional creator videos with source links, marketplace context, and capture times. Use the data to compare creator product mixes, check public affiliate signals, or prepare outreach from the pages you chose.

- Review a creator page and its public data with **[Amazon Influencer Storefront Scraper](https://apify.com/maximedupre/amazon-influencer-storefronts/examples/amazon-influencer-storefront-scraper)**.
- Check a known Amazon page with **[Amazon Storefront Scraper](https://apify.com/maximedupre/amazon-influencer-storefronts/examples/amazon-storefront-scraper)** and save its public creator and collection details.
- Inspect one Idea List or storefront with **[Amazon Influencer Storefront](https://apify.com/maximedupre/amazon-influencer-storefronts/examples/amazon-influencer-storefront)** and keep its source links.
- Use **[Amazon Influencer](https://apify.com/maximedupre/amazon-influencer-storefronts/examples/amazon-influencer)** to review public creator profile details from a supplied target.
- Explore a supplied storefront with **[Amazon Influencer Program](https://apify.com/maximedupre/amazon-influencer-storefronts/examples/amazon-influencer-program)** and export its public collection data.

#### 📋 Public storefront data

Each saved row keeps a record type, source page, and capture time. A storefront row can include creator identity, biography, affiliate disclosure, social links, public activity counts, section summaries, collections, and videos. A direct collection row keeps the known collection and its creator context. Product expansion adds visible product details inside a collection, and video output adds public video details when enabled. Counts shown by the source are separate from the number of records or products extracted. Fields that the source does not show may be absent.

#### ▶️ Check a storefront or Idea List

1. Choose `Influencer storefronts` to inspect a list of public storefront URLs or handles, or choose `Idea List collection` for one known collection URL.
2. Add the storefront targets or collection URL. A full URL keeps its own Amazon marketplace. Set a marketplace and optional locale when you use handles.
3. Add marketplace, top-creator, affiliate disclosure, curation, or activity filters when you want to keep only matching public signals.
4. Turn on collection expansion for visible recommended product records, or turn on creator videos when you need those records.
5. Set `Maximum items to process` for a bounded run. Leave it empty to return all available results until the public source is exhausted.
6. Start the run and open the dataset and target outcome links in the output.

The Actor reads public Amazon pages and does not need an Amazon login. One run uses one shared extraction scope for its submitted storefront list.

#### ⚙️ Input

Use the input to inspect several storefronts with one shared scope or one known Idea List. Fields for the other target type are not used.

**Input fields**

| Field | Type | What it does |
|---|---|---|
| `target` | string | Chooses `storefronts` for a list of URLs or handles, or `collection` for one public Idea List or collection URL. |
| `storefronts` | array of strings | Adds one or more public Amazon storefront URLs or handles. The same scope, marketplace, and locale apply to every entry. |
| `marketplace` | string | Sets the Amazon marketplace for entries that are handles. A full URL keeps its own marketplace. |
| `locale` | string | Optionally sets locale context for storefront handles. The source may ignore it when the storefront does not support locale selection. |
| `includeVideos` | boolean | When `true`, returns public creator-video records for storefront targets and adds the matching video event. |
| `filterMarketplace` | string | Keeps only storefronts that report the selected public marketplace. Leave it empty to keep all marketplaces. |
| `topCreatorFilter` | string | Keeps any storefront, one with a public top-creator signal, or one without that signal. |
| `affiliateStatusFilter` | string | Keeps any storefront, one with a public affiliate disclosure, or one without that disclosure. |
| `curationFilter` | string | Keeps any storefront, one with a public curation signal, or one without that signal. |
| `activityFilter` | string | Keeps any storefront, one with public activity signals, or one without those signals. |
| `collectionUrl` | string | Adds one public Amazon Idea List or collection URL for the `collection` target. |
| `expandCollections` | boolean | When `true`, expands visible public collections into recommended product records. Profile and collection context are returned either way. |
| `maxItems` | integer | Stops after this many output records are processed. Leave it empty to return all available results until the public source is exhausted. |

**Example input**

The following JSON is copied from the successful Hosted QA default-input run on the current beta build.

```json
{
  "target": "storefronts",
  "storefronts": [
    "sweetsavingsandthings"
  ],
  "includeVideos": false,
  "expandCollections": false,
  "maxItems": 1
}
```

#### 🧾 Output

The run output includes links to the default dataset and to target outcomes. The dataset can contain storefront rows or direct collection rows.

**Run links**

| Field | Type | What it does |
|---|---|---|
| `dataset` | string | Links to the default dataset with successful storefront and collection rows. |
| `targetOutcomes` | string | Links to a key-value record with one status and any errors for each submitted target. |

**Storefront rows**

| Field | Type | What it does |
|---|---|---|
| `recordType` | string | Identifies this row as a `storefront` row. |
| `sourceUrl` | string | Public Amazon storefront page used for the row. |
| `capturedAt` | string | Time when the public source data was captured. |
| `creator` | object | Public creator details shown on the storefront. |
| `creator.creatorId` | string | Public creator identifier. |
| `creator.name` | string | Public creator name shown on the storefront. |
| `creator.bio` | string | Public creator biography when shown. |
| `creator.storefrontUrl` | string | Public URL of the creator storefront. |
| `creator.marketplace` | string | Amazon marketplace reported by the storefront. |
| `creator.locale` | string | Locale used or shown by the storefront when available. |
| `creator.affiliateDisclosure` | string | Public affiliate disclosure text when shown. |
| `creator.isTopCreator` | boolean | Says whether the storefront shows a public top-creator signal. |
| `creator.hasCuration` | boolean | Says whether the storefront shows a public curation signal. |
| `creator.socialLinks` | array of objects | Public social links shown on the storefront. |
| `creator.socialLinks[].platform` | string | Name of the social platform. |
| `creator.socialLinks[].url` | string | Public social profile URL. |
| `creator.activityCounts` | array of objects | Public activity counts shown on the storefront. |
| `creator.activityCounts[].name` | string | Name of the activity count shown by the source. |
| `creator.activityCounts[].value` | integer | Non-negative activity count shown by the source. |
| `sectionSummaries` | array of objects | Public storefront sections and the counts shown for them. |
| `sectionSummaries[].name` | string | Name of a storefront section. |
| `sectionSummaries[].type` | string | Kind of section, such as a list or video section. |
| `sectionSummaries[].visibleCount` | integer | Count shown by the source for the section, not the number of returned rows. |
| `collections` | array of objects | Public Idea Lists or other collections shown by the source. |
| `collections[].collectionId` | string | Public collection identifier. |
| `collections[].curationId` | string | Public curation identifier when available. |
| `collections[].type` | string | Collection type reported by the source. |
| `collections[].title` | string | Public collection title. |
| `collections[].url` | string | Public URL of the collection. |
| `collections[].imageUrls` | array of strings | Public collection image URLs shown by the source. |
| `collections[].itemCount` | integer | Number of items declared by the source for the collection. |
| `collections[].postCount` | integer | Number of posts declared by the source for the collection. |
| `collections[].extractedProductCount` | integer | Number of visible products actually extracted from the collection. |
| `collections[].products` | array of objects | Visible products extracted from the collection when product expansion is on. |
| `collections[].products[].productId` | string | Public product identifier. |
| `collections[].products[].title` | string | Public product title shown by the source. |
| `collections[].products[].brand` | string | Product brand shown by the source. |
| `collections[].products[].url` | string | Public product page URL. |
| `collections[].products[].imageUrls` | array of strings | Public product image URLs shown by the source. |
| `collections[].products[].displayPrice` | string | Price text shown by the source. |
| `collections[].products[].availabilityText` | string | Availability text shown by the source. |
| `collections[].products[].deliveryText` | string | Delivery text shown by the source. |
| `collections[].products[].creatorNote` | string | Creator annotation shown with the product. |
| `videos` | array of objects | Public creator videos shown when video output is enabled. |
| `videos[].videoId` | string | Public video identifier. |
| `videos[].url` | string | Public video page URL. |
| `videos[].title` | string | Public creator-video title. |
| `videos[].duration` | string | Video duration shown by the source. |
| `videos[].thumbnailUrl` | string | Public video thumbnail URL. |
| `videos[].productIds` | array of strings | Public product identifiers linked to the video. |
| `videos[].engagementCounts` | array of objects | Visible engagement counts shown for the video. |
| `videos[].engagementCounts[].name` | string | Name of the engagement count shown by the source. |
| `videos[].engagementCounts[].value` | integer | Non-negative engagement count shown by the source. |

**Example storefront row**

This is a genuine storefront row from a successful current-beta run.

```json
{
  "recordType": "storefront",
  "sourceUrl": "https://www.amazon.ca/shop/cookingwithalison",
  "capturedAt": "2026-08-25T21:23:43.803Z",
  "creator": {
    "creatorId": "amzn1.account.AHONLPDQTFUOJK6INT7XER2TWY3Q",
    "name": "Cooking with Alison's Favourite Amazon Products",
    "bio": "Favourite products by the owner of a recipe blog & dog lover",
    "storefrontUrl": "https://www.amazon.ca/shop/cookingwithalison",
    "marketplace": "amazon.ca",
    "locale": "en_CA",
    "affiliateDisclosure": "Earns commissions",
    "isTopCreator": false,
    "hasCuration": false,
    "socialLinks": [],
    "activityCounts": [
      {
        "name": "collection_likes",
        "value": 0
      },
      {
        "name": "collection_likes",
        "value": 0
      },
      {
        "name": "collection_likes",
        "value": 0
      },
      {
        "name": "collection_likes",
        "value": 0
      },
      {
        "name": "collection_likes",
        "value": 1
      },
      {
        "name": "collection_likes",
        "value": 0
      }
    ]
  },
  "sectionSummaries": [
    {
      "name": "All",
      "type": "all",
      "visibleCount": 6
    },
    {
      "name": "Idea Lists",
      "type": "list",
      "visibleCount": 6
    }
  ],
  "collections": [
    {
      "collectionId": "amzn1.ideas.1T33Z576PM7TY",
      "type": "idea_list",
      "title": "Home, Smart Home Devices, Décor, Electronics",
      "url": "https://www.amazon.ca/shop/cookingwithalison/list/1T33Z576PM7TY?tag=alisfoocookwi-20",
      "imageUrls": [
        "https://m.media-amazon.com/images/I/71vHVn35RnL._AC_._US550_SCLZZZZZZZ_.jpg"
      ],
      "itemCount": 149,
      "products": []
    }
  ],
  "videos": []
}
```

**Video-enabled storefront row**

This is a shortened genuine storefront row from a current-beta run with creator videos. It keeps one returned video. The `"..."` values mark omitted biography, activity, and additional video data.

```json
{
  "recordType": "storefront",
  "sourceUrl": "https://www.amazon.com/shop/sweetsavingsandthings",
  "capturedAt": "2026-08-25T21:22:59.938Z",
  "creator": {
    "creatorId": "amzn1.account.AGZWUMUYS5FHOJHF2CPDZQ6UFFOA",
    "name": "Sweet Savings and Things",
    "bio": "...",
    "storefrontUrl": "https://www.amazon.com/shop/sweetsavingsandthings",
    "marketplace": "amazon.com",
    "locale": "en_US",
    "affiliateDisclosure": "Earns revenue",
    "isTopCreator": true,
    "hasCuration": true,
    "socialLinks": [
      {
        "platform": "pinterest",
        "url": "https://www.pinterest.com/sweetsavingsandthings/"
      }
    ],
    "activityCounts": "..."
  },
  "sectionSummaries": [
    {
      "name": "All",
      "type": "all",
      "visibleCount": 3427
    },
    {
      "name": "Idea Lists",
      "type": "list",
      "visibleCount": 16
    },
    {
      "name": "Photos",
      "type": "photo",
      "visibleCount": 4
    },
    {
      "name": "Videos",
      "type": "video",
      "visibleCount": 10
    }
  ],
  "collections": [
    {
      "collectionId": "amzn1.ideas.2E7LAQURU41SP",
      "type": "idea_list",
      "title": "Products From Reels",
      "url": "https://www.amazon.com/shop/sweetsavingsandthings/list/2E7LAQURU41SP?tag=sweetsaving0b-20",
      "imageUrls": [
        "https://m.media-amazon.com/images/I/71lVPnXQnRL._AC_._US550_SCLZZZZZZZ_.jpg"
      ],
      "itemCount": 395,
      "products": []
    }
  ],
  "videos": [
    {
      "videoId": "amzn1.vse.video.06bd71fe2af449fdbd0ca863eb772558",
      "url": "https://www.amazon.com/vdp/06bd71fe2af449fdbd0ca863eb772558?creator_attr_token=Y29tcEN0eElkPWFpcHN0b3JlZnJvbnRzdmMtMjAyNi0wNC0wOS1xeE1yJnRhZz1zd2VldHNhdmluZ3NvLTIwJmxpbmtDb2RlPXNzYyZhc2NfaXRlbS1pZD1hbXpuMS52c2UudmlkZW8uMDZiZDcxZmUyYWY0NDlmZGJkMGNhODYzZWI3NzI1NTguaW5jbHVkZUxpbWl0ZWRWaXNpYmlsaXR5&tag=sweetsavingso-20",
      "title": "Airtap vent booster fan review Worth every penny!",
      "duration": "0:11",
      "thumbnailUrl": "https://m.media-amazon.com/images/I/71nzI47-XoL._AC_._SX500_SCLZZZZZZZ_.jpg",
      "productIds": [
        "B0792R5KJF"
      ],
      "engagementCounts": []
    },
    "..."
  ]
}
```

**Collection rows**

| Field | Type | What it does |
|---|---|---|
| `recordType` | string | Identifies this row as a `collection` row. |
| `sourceUrl` | string | Public Amazon Idea List or collection page used for the row. |
| `capturedAt` | string | Time when the public source data was captured. |
| `creator` | object | Public creator context shown with the collection. |
| `creator.creatorId` | string | Public creator identifier. |
| `creator.name` | string | Public creator name when shown. |
| `creator.bio` | string | Public creator biography when shown. |
| `creator.storefrontUrl` | string | Public URL of the creator storefront. |
| `creator.marketplace` | string | Amazon marketplace reported by the source. |
| `creator.locale` | string | Locale used or shown by the source when available. |
| `creator.affiliateDisclosure` | string | Public affiliate disclosure text when shown. |
| `creator.isTopCreator` | boolean | Says whether the source shows a public top-creator signal. |
| `creator.hasCuration` | boolean | Says whether the source shows a public curation signal. |
| `creator.socialLinks` | array of objects | Public social links shown by the source. |
| `creator.socialLinks[].platform` | string | Name of the social platform. |
| `creator.socialLinks[].url` | string | Public social profile URL. |
| `creator.activityCounts` | array of objects | Public activity counts shown by the source. |
| `creator.activityCounts[].name` | string | Name of the activity count. |
| `creator.activityCounts[].value` | integer | Non-negative activity count. |
| `sectionSummaries` | array of objects | Public storefront sections when the source provides them. |
| `sectionSummaries[].name` | string | Name of a storefront section. |
| `sectionSummaries[].type` | string | Kind of storefront section. |
| `sectionSummaries[].visibleCount` | integer | Count shown by the source for the section. |
| `collections` | array of objects | The directly targeted public collection and its collection data. |
| `collections[].collectionId` | string | Public collection identifier. |
| `collections[].curationId` | string | Public curation identifier when available. |
| `collections[].type` | string | Collection type reported by the source. |
| `collections[].title` | string | Public collection title. |
| `collections[].url` | string | Public URL of the collection. |
| `collections[].imageUrls` | array of strings | Public collection image URLs. |
| `collections[].itemCount` | integer | Number of items declared by the source. |
| `collections[].postCount` | integer | Number of posts declared by the source. |
| `collections[].extractedProductCount` | integer | Number of visible products actually extracted. |
| `collections[].products` | array of objects | Visible products extracted from the collection when expansion is on. |
| `collections[].products[].productId` | string | Public product identifier. |
| `collections[].products[].title` | string | Public product title. |
| `collections[].products[].brand` | string | Product brand shown by the source. |
| `collections[].products[].url` | string | Public product page URL. |
| `collections[].products[].imageUrls` | array of strings | Public product image URLs. |
| `collections[].products[].displayPrice` | string | Price text shown by the source. |
| `collections[].products[].availabilityText` | string | Availability text shown by the source. |
| `collections[].products[].deliveryText` | string | Delivery text shown by the source. |
| `collections[].products[].creatorNote` | string | Creator annotation shown with the product. |
| `videos` | array of objects | Public creator videos when the collection run includes them. |
| `videos[].videoId` | string | Public video identifier. |
| `videos[].url` | string | Public video page URL. |
| `videos[].title` | string | Public creator-video title. |
| `videos[].duration` | string | Video duration shown by the source. |
| `videos[].thumbnailUrl` | string | Public video thumbnail URL. |
| `videos[].productIds` | array of strings | Public product identifiers linked to the video. |
| `videos[].engagementCounts` | array of objects | Visible engagement counts shown for the video. |
| `videos[].engagementCounts[].name` | string | Name of the engagement count. |
| `videos[].engagementCounts[].value` | integer | Non-negative engagement count. |

**Example collection row**

This is a genuine direct-collection row from a successful current-beta run with one visible product.

```json
{
  "recordType": "collection",
  "sourceUrl": "https://www.amazon.com/shop/sweetsavingsandthings/list/2E7LAQURU41SP",
  "capturedAt": "2026-08-25T21:22:58.699Z",
  "creator": {
    "creatorId": "amzn1.account.AGZWUMUYS5FHOJHF2CPDZQ6UFFOA",
    "name": "Sweet Savings and Things",
    "storefrontUrl": "https://www.amazon.com/shop/sweetsavingsandthings",
    "marketplace": "amazon.com",
    "locale": "en_US",
    "affiliateDisclosure": "Earns revenue",
    "isTopCreator": false,
    "hasCuration": false,
    "socialLinks": [],
    "activityCounts": []
  },
  "sectionSummaries": [],
  "collections": [
    {
      "collectionId": "2E7LAQURU41SP",
      "type": "idea_list",
      "title": "Products From Reels",
      "url": "https://www.amazon.com/shop/sweetsavingsandthings/list/2E7LAQURU41SP",
      "imageUrls": [
        "https://m.media-amazon.com/images/I/71GrimGm8KL._AC_._US550_SCLZZZZZZZ_.jpg"
      ],
      "itemCount": 395,
      "extractedProductCount": 1,
      "products": [
        {
          "productId": "B0DSGDGH42",
          "title": "Shark NeverChange Compact Pro Air Purifier, HP071BRN, Winter Fog | For Bedroom, Nursery, Home Office, Dorm, HEPA-Exceeding Filter, Captures Pollutants, Pet Dander, Dust, Odor, Smoke, and More",
          "brand": "Shark",
          "url": "https://www.amazon.com/dp/B0DSGDGH42?linkCode=ssc&tag=sweetsaving0b-20&creativeASIN=B0DSGDGH42&asc_item-id=amzn1.ideas.2E7LAQURU41SP&ref_=aip_sf_list_spv_ofs_d_asin",
          "imageUrls": [
            "https://m.media-amazon.com/images/I/41kYnlpPVoL._AC_.jpg"
          ],
          "displayPrice": "$129.99",
          "deliveryText": "FREE delivery Sun, Aug 30"
        }
      ]
    }
  ],
  "videos": []
}
```

#### 💳 Pricing

The Actor uses pay-per-event pricing. A successfully saved creator profile, collection, visible recommended product, or creator video uses its matching event.

| Buyer-facing charge | When it applies |
|---|---|
| Profile | One public creator profile is saved. |
| Collection | One public Idea List or curation collection is saved. |
| Product | One visible recommended product is saved. |
| Video | One public creator video is saved. |

Product and video events apply only when those output types are saved, so turn on expansion or videos only when you need them. The current pricing configuration has no separate run-start event.

#### 🔌 Integrations

Read the dataset and target outcome links from the Apify Console or API. Store the public rows in your own workflow when you need to compare creator collections or product data over time.

https://www.youtube.com/watch?v=bNACk1\_S\_6w\&list=PLObrtcm1Kw6MUrlLNDbK9QRg8VDJg0gOW\&index=4

#### ❓ FAQ

##### Does this find Amazon influencer storefronts by keyword?

No. Add the public storefront URLs or handles that you want to inspect. This Actor does not search the full Amazon creator population.

##### Can I inspect one known Idea List?

Yes. Choose `Idea List collection` and enter its public Amazon collection URL. The returned row keeps the collection source page and creator context.

##### Can one run check several storefronts?

Yes. Add several URLs or handles to `storefronts`. They use one shared extraction scope, marketplace, and locale.

##### What happens when the source does not show a field?

That field may be absent. Source-declared counts, such as an Idea List item count, are kept separate from visible products actually extracted.

##### Can I include products and creator videos?

Yes. Turn on `expandCollections` for visible recommended product records and `includeVideos` for public creator-video records. Profile and collection context stay part of the output.

##### Can I filter by public creator signals?

Yes. Storefront targets can be filtered by marketplace, top-creator signal, affiliate disclosure, curation signal, or activity signals.

##### Do I need an Amazon login?

No. The Actor reads public storefront and collection pages and does not ask for Amazon account credentials.

##### What does an empty maximum do?

Leave `maxItems` empty to return all available results until the public source is exhausted.

### 📝 Changelog

**0.0: Initial release**

### 🆘 Support

For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~amazon-influencer-storefronts/issues) and I'll fix or implement it in less than 24h 🫡

### 🔗 Related Actors

- [ShopMy Creator Scraper](https://apify.com/maximedupre/shopmy): Compare public creator picks, collections, products, merchants, and affiliate links on another creator storefront platform.
- [Influencer Scraper](https://apify.com/maximedupre/influencer-scraper): Find public influencer profiles on TikTok, Instagram, and YouTube before checking their Amazon storefronts.
- [Amazon Price Tracker](https://apify.com/maximedupre/amazon-price-tracker): Follow public prices, ratings, availability, and seller details for product IDs or URLs found in storefront data.
- [Amazon Creator Shop Scraper](https://apify.com/crawlerbros/amazon-creator-shop-scraper): Compare another public Amazon creator storefront workflow with profile, collection, product, and video data.
- [Amazon Influencer Storefront Scraper](https://apify.com/automation-lab/amazon-influencer-storefront-scraper): Use a separate public Amazon storefront scraper when you need creator profiles, lists, curations, and ASINs.

**Made with ❤️ by Maxime Dupré**

# Actor input Schema

## `target` (type: `string`):

Choose the public Amazon source to inspect. Choose Influencer storefronts for a list of URLs or handles. Choose Idea List collection for one public collection URL.

## `storefronts` (type: `array`):

Add one or more public Amazon influencer storefront URLs or handles. The same extraction scope, marketplace, and locale apply to every entry. Use this only when Target is Influencer storefronts.

## `marketplace` (type: `string`):

Choose the Amazon marketplace for entries that are handles. A full URL keeps its own marketplace. This is used only for Influencer storefronts.

## `locale` (type: `string`):

Optionally set a locale such as en-US for storefront handles. The source may ignore it when that storefront does not support locale selection. This is used only for Influencer storefronts.

## `includeVideos` (type: `boolean`):

Turn this on to return public creator-video records from storefronts. Creator videos have a separate event charge. This is used only for Influencer storefronts.

## `filterMarketplace` (type: `string`):

Keep only storefronts that report the selected public marketplace. Leave it empty to keep all marketplaces. This is used only for Influencer storefronts.

## `topCreatorFilter` (type: `string`):

Choose whether returned storefronts must show a public top-creator signal. Any keeps both kinds. This is used only for Influencer storefronts.

## `affiliateStatusFilter` (type: `string`):

Choose whether returned storefronts must show a public affiliate disclosure. Any keeps both kinds. This is used only for Influencer storefronts.

## `curationFilter` (type: `string`):

Choose whether returned storefronts must show a public curation signal. Any keeps both kinds. This is used only for Influencer storefronts.

## `activityFilter` (type: `string`):

Choose whether returned storefronts must show public activity signals. Any keeps both kinds. This is used only for Influencer storefronts.

## `collectionUrl` (type: `string`):

Enter one public Amazon Idea List or collection URL. Use this only when Target is Idea List collection.

## `expandCollections` (type: `boolean`):

Turn this on to expand visible public collections into recommended product records. Profile and collection context are returned either way. This applies to both targets and has a separate product event charge.

## `maxItems` (type: `integer`):

Stop after this many output records are processed. Leave it empty to return all available results until the public source is exhausted. This limit applies to both targets.

## Actor input object example

```json
{
  "target": "storefronts",
  "storefronts": [
    "sweetsavingsandthings"
  ],
  "includeVideos": false,
  "expandCollections": false,
  "maxItems": 1
}
```

# Actor output Schema

## `dataset` (type: `string`):

URL of the default dataset with successful storefront and collection results.

## `targetOutcomes` (type: `string`):

URL of a key-value record with one status and any errors for each submitted target.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "target": "storefronts",
    "storefronts": [
        "sweetsavingsandthings"
    ],
    "maxItems": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("maximedupre/amazon-influencer-storefronts").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "target": "storefronts",
    "storefronts": ["sweetsavingsandthings"],
    "maxItems": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("maximedupre/amazon-influencer-storefronts").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "target": "storefronts",
  "storefronts": [
    "sweetsavingsandthings"
  ],
  "maxItems": 1
}' |
apify call maximedupre/amazon-influencer-storefronts --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,maximedupre/amazon-influencer-storefronts"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/jpIZDwlAYfd9XT1bY/builds/YVsgvC64jswuKBQjW/openapi.json