# 🛒 Apify Store API: commercial intelligence on every Apify Store Actor

Extract pricing, usage trends, reliability, ratings, and categories for every public Actor in the Apify Store, as clean structured JSON.

- **Actor landing page:** https://apify.com/johnvc/store-actor-intelligence-api?fpr=9n7kx3
- **Get a free API key:** https://apify.com?fpr=9n7kx3

This API reads the Apify Store and returns one row per Actor with the data that actually matters for analysis: the pricing model and per-event price ladder, total and 7/30/90-day active users, total runs and builds, a 30-day success rate, bookmark counts, and review ratings, plus the title, developer, categories, and description. Filter by keyword, category, pricing model, or developer, or sweep the entire Store in a single run. Built for market research, competitor tracking, pricing analysis, and AI agents.

## 🎬 Video Walkthrough

[![Watch the walkthrough](https://img.youtube.com/vi/jREWahDGhJM/maxresdefault.jpg)](https://www.youtube.com/watch?v=jREWahDGhJM)

## 🚀 Quick Start (Python + uv)

**Prerequisites:** Python 3.11+ and a free Apify API key (https://apify.com?fpr=9n7kx3).

```bash
# 1. Install uv if you do not have it
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. Clone and enter the repo
git clone https://github.com/johnisanerd/Apify-Store-API.git
cd Apify-Store-API

# 3. Install dependencies
uv sync

# 4. Add your API key
cp .env.example .env        # then paste your APIFY_API_TOKEN

# 5. Run the example
uv run python store-api-example.py
```

## ✨ Why use this API

- **The whole catalog, structured.** One run returns every public Store Actor as JSON, no manual copying from listing pages.
- **Real commercial signals.** Pricing model, per-event prices, total and monthly users, run volume, and a computed 30-day success rate, all in one row.
- **Filter or sweep.** Narrow by keyword, category, pricing model, or developer, or set `maxItems: 0` to pull the entire Store.
- **Track changes over time.** Run it on a schedule to watch pricing moves, new entrants, and reliability trends across the marketplace.
- **MCP-ready.** Hand it to Claude, Cursor, or ChatGPT as a live tool (see the install sections below).
- **Cheapest in its class.** Pay-per-result pricing with no per-run fee, so even a full-catalog sweep costs very little. See the current price on the Store card.

## 🧪 Usage Examples

Basic (top Actors in one category):

```json
{
  "category": "AI",
  "sortBy": "popularity",
  "maxItems": 25
}
```

Advanced (free social-media Actors, with full README and input schema for each):

```json
{
  "search": "instagram",
  "category": "SOCIAL_MEDIA",
  "pricingModel": "FREE",
  "sortBy": "popularity",
  "maxItems": 10,
  "includeDetails": true
}
```

## ⚙️ Input Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `search` | string | No | (none) | Keyword filter across title, name, description, developer, and README. |
| `category` | enum | No | (all) | One of 25 Store categories: AI, AGENTS, AUTOMATION, BUSINESS, DEVELOPER_TOOLS, ECOMMERCE, LEAD_GENERATION, MARKETING, NEWS, SEO_TOOLS, SOCIAL_MEDIA, TRAVEL, REAL_ESTATE, JOBS, EDUCATION, GAMES, VIDEOS, SPORTS, INTEGRATIONS, MCP_SERVERS, OPEN_SOURCE, FOR_CREATORS, COVID_19, DEVELOPER_EXAMPLES, OTHER. |
| `pricingModel` | enum | No | (all) | FREE, FLAT_PRICE_PER_MONTH, PRICE_PER_DATASET_ITEM, or PAY_PER_EVENT. |
| `username` | string | No | (all) | Filter to one developer handle (e.g. `apify`). |
| `sortBy` | enum | No | `relevance` | relevance, popularity, newest, or lastUpdate. |
| `maxItems` | integer | No | `1000` | Maximum Actors to return. Set to `0` for the entire Store (~33,000+). |
| `offset` | integer | No | `0` | Skip this many Actors first (resume or shard a large run). |
| `includeDetails` | boolean | No | `false` | Also pull each Actor's full README and input schema (1-2 extra calls per Actor). |

## 📦 Output Format

Each dataset item is one Store Actor. Representative row:

```json
{
  "result_type": "actor",
  "actorId": "aYG0l9s7dbB7j3gbS",
  "name": "website-content-crawler",
  "username": "apify",
  "title": "Website Content Crawler",
  "url": "https://apify.com/apify/website-content-crawler?fpr=9n7kx3",
  "categories": ["AI", "DEVELOPER_TOOLS", "BUSINESS"],
  "totalUsers": 21786,
  "monthlyUsers": 3355,
  "totalUsers7Days": 1307,
  "totalUsers90Days": 7260,
  "totalRuns": 4894213,
  "totalBuilds": 202,
  "runs30DaysTotal": 511458,
  "runs30DaysSucceeded": 496871,
  "successRate30Days": 97.15,
  "bookmarkCount": 491,
  "reviewRating": 4.8,
  "pricingModel": "FREE",
  "apifyMarginPercentage": 0.2,
  "scrapedAt": "2026-06-29T18:00:00+00:00"
}
```

With `includeDetails: true`, each row also carries `readme`, `inputSchema`, `seoTitle`, `seoDescription`, `isDeprecated`, and `latestVersion`.

## Install in Claude Cowork Desktop

![Install in Claude Cowork Desktop](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_claude_desktop.png)

Cowork is the desktop app's automation mode. To give it the Apify Store API as a tool, add the Apify MCP server as a connector.

1. Open the Claude desktop app and go to **Settings → Connectors** (or **Settings → Developer → Edit Config** to edit `claude_desktop_config.json` directly).
   - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
   - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
2. Add the Apify MCP server, preloaded with only this Actor:

```json
{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/store-actor-intelligence-api"
      ]
    }
  }
}
```

3. Restart the app. When Cowork first calls the tool, complete the OAuth prompt in your browser, or add your Apify API token in the connector settings to skip OAuth.
4. In a Cowork chat, confirm the tool is available and ask it to run the Apify Store API.

Download the desktop app and start a free trial: https://claude.ai/referral/uIlpa7nPLg
More help: https://docs.apify.com/platform/integrations/claude-desktop

## Install in Claude Code

![Install in Claude Code](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_claude_code.png)

Claude Code is the command-line tool. Add the Actor's MCP server with one command:

```bash
claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/store-actor-intelligence-api"
```

To use a token instead of browser OAuth:

```bash
claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/store-actor-intelligence-api" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"
```

Then verify with `claude mcp list`, or run `/mcp` inside a session. Ask Claude Code to call the Apify Store API.

Try Claude Code free: https://claude.ai/referral/uIlpa7nPLg
Claude Code MCP docs: https://code.claude.com/docs/en/mcp

## Install in Claude (website)

![Install in Claude (website)](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_claude_ai.png)

On claude.ai you add Apify as a connector, then enable just this Actor's tool.

1. Go to **Settings → Connectors → Browse connectors** and search for **Apify MCP server**. Install it (enable or update if prompted).
2. When connecting, authenticate with your Apify API token, and enable the tool `johnvc/store-actor-intelligence-api`.
3. In any chat, open **+ → Connectors** and turn on **Apify**.
4. Alternatively, choose **Add custom connector** and paste the full MCP URL `https://mcp.apify.com/?tools=actors,docs,johnvc/store-actor-intelligence-api`, using OAuth when prompted.
5. Ask Claude to run the Apify Store API.

Open Claude on the web: https://claude.ai/referral/uIlpa7nPLg

## Install in Cursor

![Install in Cursor](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_cursor.png)

Cursor reads MCP servers from a project file at `.cursor/mcp.json`.

1. In your project, create `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/store-actor-intelligence-api"
    }
  }
}
```

2. If you prefer token auth over browser OAuth, add a header:

```json
{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/store-actor-intelligence-api",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}
```

3. Open **Cursor → Settings → MCP** and confirm the **apify** server is connected (green dot).
4. In Composer or Chat, ask Cursor to call the Apify Store API.

New to Cursor? Get it here: https://cursor.com/referral?code=XQP4VBLI3NNX

## Install in ChatGPT

![Install in ChatGPT](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_ChatGPT.png)

ChatGPT connects to the Apify MCP server through Developer mode (available on ChatGPT Pro, Plus, Business, Enterprise, and Education plans).

1. Click your profile icon, then go to **Settings > Apps**. If you do not see a **Create app** button, open **Advanced settings** and enable **Developer mode**.
2. Click **Create app** and fill out the form:
   - **Name:** Apify
   - **MCP Server URL:** `https://mcp.apify.com/?tools=actors,docs,johnvc/store-actor-intelligence-api`
   - **Authentication:** OAuth
3. Click **Create** and authorize the connection with Apify.
4. To use the app in a conversation, click **+** in the chat, choose **Developer mode**, and select **Apify**.

More help: https://docs.apify.com/platform/integrations/mcp

---

Made with care by [johnvc on Apify](https://apify.com/johnvc?fpr=9n7kx3).

<!-- ask-ai:start -->
## 🤖 Ask an AI assistant about this Actor

Open a ready-to-send prompt about the Apify Store API in the AI of your choice:

- 💬 [ChatGPT](https://chatgpt.com/?q=Using%20the%20Apify%20Store%20API%20on%20Apify%20%28https://apify.com/johnvc/store-actor-intelligence-api?fpr=9n7kx3%29%2C%20walk%20me%20through%20this%20use%20case:%20%22Best%20App%20Store%20Scrapers%20on%20Apify%20%282026%29%22.%20Show%20me%20the%20input%20JSON%2C%20the%20output%20fields%2C%20and%20how%20to%20automate%20it%20with%20the%20API%20or%20MCP.)
- 🧠 [Claude](https://claude.ai/new?q=Using%20the%20Apify%20Store%20API%20on%20Apify%20%28https://apify.com/johnvc/store-actor-intelligence-api?fpr=9n7kx3%29%2C%20walk%20me%20through%20this%20use%20case:%20%22Best%20App%20Store%20Scrapers%20on%20Apify%20%282026%29%22.%20Show%20me%20the%20input%20JSON%2C%20the%20output%20fields%2C%20and%20how%20to%20automate%20it%20with%20the%20API%20or%20MCP.)
- 🔍 [Perplexity](https://www.perplexity.ai/search?q=Using%20the%20Apify%20Store%20API%20on%20Apify%20%28https://apify.com/johnvc/store-actor-intelligence-api?fpr=9n7kx3%29%2C%20walk%20me%20through%20this%20use%20case:%20%22Best%20App%20Store%20Scrapers%20on%20Apify%20%282026%29%22.%20Show%20me%20the%20input%20JSON%2C%20the%20output%20fields%2C%20and%20how%20to%20automate%20it%20with%20the%20API%20or%20MCP.)
- 🅒 [Copilot](https://copilot.microsoft.com/?q=Using%20the%20Apify%20Store%20API%20on%20Apify%20%28https://apify.com/johnvc/store-actor-intelligence-api?fpr=9n7kx3%29%2C%20walk%20me%20through%20this%20use%20case:%20%22Best%20App%20Store%20Scrapers%20on%20Apify%20%282026%29%22.%20Show%20me%20the%20input%20JSON%2C%20the%20output%20fields%2C%20and%20how%20to%20automate%20it%20with%20the%20API%20or%20MCP.)
<!-- ask-ai:end -->

Last Updated: 2026.09.22