# ShopMy Creator Scraper (`maximedupre/shopmy`) Actor

Collect public ShopMy creator picks from submitted profiles. Get creator, collection, product, brand, price, merchant, affiliate link, destination link, and click data without a ShopMy login.

- **URL**: https://apify.com/maximedupre/shopmy.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

from $2.65 / 1,000 product picks

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/platform/actors/running/actors-in-store#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

### 🛍️ Turn ShopMy creator picks into useful product data

Built for brands, affiliate teams, and creator researchers, this ShopMy Creator Scraper collects public product picks from the creator profiles you add. Get creator, collection, product, brand, price, merchant, affiliate link, destination link, and click data in one dataset without a ShopMy login.

- Collect paid campaign picks with **[ShopMy Paid Collaborations](https://apify.com/maximedupre/shopmy/examples/shopmy-paid-collaborations)**.
- Find high-interest picks with **[ShopMy Popular Products](https://apify.com/maximedupre/shopmy/examples/shopmy-popular-products)**.
- Export product details with **[ShopMy Product Scraper](https://apify.com/maximedupre/shopmy/examples/shopmy-product-scraper)**.
- Study public profiles with **[ShopMy Creator Scraper](https://apify.com/maximedupre/shopmy/examples/shopmy-creator-scraper)**.
- Save public picks with **[ShopMy Scraper](https://apify.com/maximedupre/shopmy/examples/shopmy-scraper)**.
- Review public product links with **[ShopMy Affiliate](https://apify.com/maximedupre/shopmy/examples/shopmy-affiliate)**.
- Research creator picks for the **[ShopMy Affiliate Program](https://apify.com/maximedupre/shopmy/examples/shopmy-affiliate-program)**.

#### 📦 What data does the Actor return?

Each saved row is one unique product pick. It can include creator and collection details, product and brand names, price and currency, images, merchant links, affiliate links, destination links, and public click totals. If the same source pick appears again, only its first eligible match is saved.

#### ▶️ How to run the Actor

1. Add one or more public ShopMy creator profile URLs.
2. Choose latest, popular, or paid collaboration picks.
3. Set a work limit, or leave it empty to return all available picks until ShopMy has no more.
4. Click **Start**. Open the dataset when the run ends.

If one profile is invalid, unavailable, or has no eligible picks, the Actor keeps working on the other profiles.

#### 🔧 Input

| Field | Type | What it does |
|---|---|---|
| `creatorUrls` | array of objects | Adds one or more public ShopMy creator profile URLs. Each object has a required `url` field. |
| `pickType` | string | Chooses `latest`, `popular`, or `paidCollaboration`. A creator may not have every view. |
| `maxItems` | integer | Stops after this many unique picks are saved in total. Leave it empty to return all available picks until the source is exhausted. |

```json
{
  "creatorUrls": [
    {
      "url": "https://shopmy.us/catfoor"
    }
  ],
  "pickType": "latest",
  "maxItems": 3
}
```

#### 📤 Output

All picks use the same output shape. Some fields may be missing when ShopMy does not show that data.

| Field | Type | What it does |
|---|---|---|
| `pickId` | string | ShopMy ID for the pick. |
| `pickType` | string | View that first found the pick. |
| `creatorUrl` | string | Submitted profile URL that first found the pick. |
| `creatorId` | string | ShopMy creator ID. |
| `creatorName` | string | Public creator name. |
| `creatorHandle` | string | Public ShopMy handle. |
| `creatorBio` | string | Public profile bio. |
| `creatorImageUrl` | string | Public profile image URL. |
| `collectionId` | string | ShopMy collection ID. |
| `collectionName` | string | Collection name. |
| `collectionDescription` | string | Public collection description. |
| `collectionUrl` | string | Public ShopMy collection URL. |
| `productId` | string | Product ID shown by ShopMy. |
| `productName` | string | Product name shown by ShopMy. |
| `brandName` | string | Product brand shown by ShopMy. |
| `price` | number | Product price when shown. |
| `currency` | string | Three-letter currency code. |
| `productImageUrl` | string | Product image URL. |
| `productPageUrl` | string | Public ShopMy page for the pick. |
| `merchantName` | string | Merchant selling the product. |
| `affiliateUrl` | string | Affiliate link for the pick. |
| `destinationUrl` | string | Final merchant product page. |
| `clickCount` | integer | Public click or engagement total. |

```json
{
  "pickId": "211",
  "pickType": "latest",
  "creatorUrl": "https://shopmy.us/catfoor",
  "creatorId": "357227",
  "creatorName": "Cat Foor",
  "creatorHandle": "catfoor",
  "creatorImageUrl": "https://production-shopmyshelf-uploads.s3.us-east-2.amazonaws.com/img-user-deres-357227-1764963858211",
  "productId": "211",
  "productName": "Limitless Lash Mascara",
  "brandName": "ILIA Beauty",
  "price": 29,
  "currency": "USD",
  "productImageUrl": "https://production-shopmyshelf-uploads.s3.us-east-2.amazonaws.com/pretty-prod-1783702427983",
  "productPageUrl": "https://shopmy.us/shop/product/211",
  "merchantName": "ILIA Beauty",
  "affiliateUrl": "https://apiv3.shopmy.us/api/redirect_click?clickId=22971669-160f-47d6-8ce8-126918da5259&cid=%3Ccustom_id%3E&url=https%3A%2F%2Filiabeauty.com%2Fproducts%2Flimitless-lash-lengthening-mascara",
  "destinationUrl": "https://iliabeauty.com/products/limitless-lash-lengthening-mascara",
  "clickCount": 163414
}
```

#### 💳 Pricing

You are charged for each unique creator product pick saved to the dataset. Later copies of the same source pick are ignored, and they are not saved again.

#### 🔌 Integrations

Send the dataset to Google Sheets, Slack, Make, Zapier, webhooks, or your own app through the Apify API.

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

#### ❓ FAQ

##### Can I choose popular or paid collaboration picks?

Yes. Set `pickType` to `popular` or `paidCollaboration`. A creator may not have every view.

##### Do I need a ShopMy account?

No. The Actor reads public creator profiles and does not access private or login-only data.

##### Can it find ShopMy creators for me?

No. Add the public profile URLs you want to collect.

##### What happens when I add the same pick more than once?

The first eligible match is saved. Later copies of that source pick are ignored.

##### What is ShopMy data useful for?

Brands and affiliate teams can study public creator picks, product links, merchants, prices, and engagement totals. This Actor does not explain creator requirements, review applications, or check whether ShopMy is legit.

### 📝 Changelog

#### 0.0: Initial release

- Collect public ShopMy creator picks with product, brand, price, merchant, affiliate link, destination link, and click data.

### 🆘 Support

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

### 🔗 Related Actors

- [Social Media Stats Checker](https://apify.com/maximedupre/social-media-stats-checker) — Compare public creator profile stats across major social networks.
- [ShopMy Creator Scraper — Brand Picks, Products & Affiliate Data](https://apify.com/vsekar91/shopmy-creator-scraper) — Compare another way to collect ShopMy creator picks and collection data.
- [ShopMy Scraper: Creator Picks, Brands & Clicks](https://apify.com/getascraper/shopmy-creator-scraper) — Compare another ShopMy pick and click data workflow.
- [Stan.store Creator Scraper — Products, Prices & Profile](https://apify.com/vsekar91/stan-store-creator-scraper) — Research products sold through another creator storefront.
- [Amazon Influencer & Deals Scraper](https://apify.com/sian.agency/amazon-influencer-deals-scraper) — Study public Amazon influencer storefronts and curated lists.

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

# Actor input Schema

## `creatorUrls` (type: `array`):

Add public ShopMy creator profile URLs. Each profile keeps its creator and collection details with its product picks.

## `pickType` (type: `string`):

Choose the ShopMy view to collect. A creator may not have every view.

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

Stop after saving this many unique product picks in total. Leave empty to collect all available picks.

## Actor input object example

```json
{
  "creatorUrls": [
    {
      "url": "https://shopmy.us/catfoor"
    }
  ],
  "pickType": "latest",
  "maxItems": 3
}
```

# Actor output Schema

## `results` (type: `string`):

Open the saved ShopMy product picks in the dataset.

# 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 = {
    "creatorUrls": [
        {
            "url": "https://shopmy.us/catfoor"
        }
    ],
    "maxItems": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("maximedupre/shopmy").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 = {
    "creatorUrls": [{ "url": "https://shopmy.us/catfoor" }],
    "maxItems": 3,
}

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

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

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

```

## CLI example

```bash
echo '{
  "creatorUrls": [
    {
      "url": "https://shopmy.us/catfoor"
    }
  ],
  "maxItems": 3
}' |
apify call maximedupre/shopmy --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=maximedupre/shopmy",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

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