# ClickBank Marketplace Scraper | Gravity, Sales, Refund Rate (`bovi/clickbank-marketplace-scraper`) Actor Scrape the ClickBank affiliate marketplace by keyword or category. Returns gravity, initial/average sale $, average rebill $, refund rate, EPC stats, and more per offer. No login required. Pay per result. - **URL**: https://apify.com/bovi/clickbank-marketplace-scraper.md - **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community) - **Categories:** Business, Marketing - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.88 / 1,000 offer-items 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use 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 For affiliate marketers, media buyers, and AI agents evaluating ClickBank offers at scale — without clicking through the marketplace UI one offer at a time. **No login required.** No ClickBank account, no API key. Pay per result (Pay Per Event). Scrape the **ClickBank affiliate marketplace** by keyword or category and get every offer's real marketplace stats — gravity, initial/average sale $, average rebill $, refund rate, EPC, conversion rate — in one structured dataset. **Pay per result.** --- ### What data you get One record per offer: - `offer_title`, `vendor`, `offer_url`, `offer_description`, `category`, `sub_category` - `gravity`, `bi_gravity` — ClickBank's affiliate-activity popularity scores - `is_recurring` — whether the offer has a rebill/subscription component - **`initial_sale_usd`, `avg_sale_usd`** — real $ earned per sale (average across affiliates) - **`avg_rebill_usd`** — average $ per rebill (0.0 for non-recurring offers — a real value, not missing data) - **`refund_rate`** — the marketplace's return/refund rate for the offer (`return_rate_source` tells you the measurement window, e.g. "90 Day Return Rate") - `initial_epc`, `average_epc`, `future_epc`, `net_epc`, `conversion_rate` — affiliate performance stats - `seller_volume`, `rank`, `score`, `activate_date` - `languages` — which locales the offer is live in (en/de/es/fr/it/pt) - `has_upsell`, `has_dollar_trial`, `mobile_enabled`, `direct_tracking`, `cpa_visible` - `affiliate_tools_url`, `affiliate_support_email`, `image_url` - `hoplink` — your personalized ClickBank tracking link, built automatically if you supply your own affiliate nickname (optional — see Input below) Every record includes `parse_confidence` (0.0–1.0) and `warnings`. --- ### Why this beats a metadata-only marketplace scrape Most marketplace scrapers only surface what's trivially visible in the page's title/description text. This actor reads ClickBank's own marketplace stats endpoint directly, so it returns the numbers that actually decide whether an offer is worth promoting: | Stat | What it tells you | |---|---| | `initial_sale_usd` / `avg_sale_usd` | Real $ per sale — not a guess from price × commission % | | `avg_rebill_usd` | Real recurring $ per rebill cycle | | `refund_rate` | How often buyers refund — a high-gravity offer with a bad refund rate is a trap | These are genuine public marketplace stats (rendered on the ClickBank marketplace page for every logged-in and logged-out visitor) — not vendor-gated, not scraped from a paywalled page. --- ### How to use #### Search by keyword, ranked by gravity (default) ```json { "keyword": "weight loss", "maxResults": 50 } ```` #### Browse a whole category, ranked by average earnings per sale ```json { "category": "Health & Fitness", "sortBy": "averageEarningsPerSale", "maxResults": 100 } ``` #### Narrow to a sub-category ```json { "category": "Health & Fitness", "subCategory": "Dietary Supplements", "sortBy": "gravity", "maxResults": 50 } ``` #### Get your own personalized hoplinks ```json { "keyword": "keto diet", "affiliateNickname": "yourAffiliateNick", "maxResults": 20 } ``` *** ### Input parameters | Field | Type | Default | Description | |---|---|---|---| | `keyword` | string | `""` | Free-text search across offer titles/descriptions | | `category` | string | `""` | Marketplace category filter, e.g. `"Health & Fitness"` | | `subCategory` | string | `""` | Sub-category filter (used together with `category`) | | `sortBy` | string | `gravity` | `relevance`, `gravity`, `biGravity`, `averageEarningsPerSale`, `averageEPC`, `initialEarningsPerSale`, `futureEarnings`, `netEPC`, `conversionRate` | | `sortDescending` | boolean | `true` | Highest values first | | `maxResults` | integer | `50` | Total offers to return | | `affiliateNickname` | string | *(none)* | Optional — your ClickBank affiliate nickname, used only to build personalized `hoplink` values. The actor works fully without it. | | `proxyConfiguration` | object | RESIDENTIAL | Apify proxy — always used, works out of the box | At least one of `keyword` or `category` should be set, otherwise the marketplace's default (unfiltered, relevance-ranked) result set is returned. *** ### Output schema See "What data you get" above for the full field list. Full field reference in `.actor/dataset_schema.json`. *** ### Pricing example Pay per result (PPE). Charged once per offer record pushed. | Fetch | Records | |---|---| | Keyword search, top 50 offers | 50 | | Category browse, 100 offers | 100 | | Deep research pull, 500 offers across a category | 500 | *** ### FAQ **Does it need a ClickBank account or login?** No. The marketplace search this actor reads is publicly available — the same data any anonymous visitor to the ClickBank marketplace page sees. **What's a hoplink and why is it optional?** A hoplink is ClickBank's affiliate tracking URL format (`hop.clickbank.net/?affiliate=...&vendor=...`). If you supply your own ClickBank affiliate nickname via the `affiliateNickname` input, every record's `hoplink` field is built as your personalized tracking link. If you don't, `hoplink` is simply `null` — everything else in the record is unaffected. **Why is `avg_rebill_usd` sometimes 0?** `0.0` is the real, correct value for offers that don't have a recurring/rebill component (`is_recurring: false`). It's not missing data. **Can I sort by refund rate?** Not directly (ClickBank's marketplace API doesn't expose refund rate as a sort field), but every record includes `refund_rate` so you can filter/sort the dataset yourself after the run. ### Legal Not affiliated with ClickBank or Keynetics Inc. This actor reads ClickBank's own public marketplace endpoint. Use responsibly. # Actor input Schema ## `keyword` (type: `string`): Free-text search across offer titles/descriptions, e.g. "weight loss", "keto diet", "forex trading". Leave blank + set a category to browse a whole category instead. ## `category` (type: `string`): Optional marketplace category filter, e.g. "Health & Fitness", "Business / Investing", "E-Business & E-Marketing". Must match the category name exactly as shown on the ClickBank marketplace. ## `subCategory` (type: `string`): Optional marketplace sub-category filter (only applied together with Category), e.g. "Dietary Supplements". ## `sortBy` (type: `string`): How to rank results. Gravity = ClickBank's affiliate-activity popularity score (default). relevance = keyword match strength. ## `sortDescending` (type: `boolean`): Highest values first. Default true. ## `maxResults` (type: `integer`): Maximum number of offers to return. Default 50. ## `affiliateNickname` (type: `string`): Optional. If you supply your own ClickBank affiliate nickname, each record's hoplink field is built as your personalized tracking link (https://hop.clickbank.net/?affiliate=\&vendor=). Leave blank and the actor still returns full data — hoplink is simply null. ## `proxyConfiguration` (type: `object`): Apify proxy used for every request (required — the actor always runs through a proxy, never a bare connection). RESIDENTIAL is the default and works out of the box. ## Actor input object example ```json { "keyword": "weight loss", "sortBy": "gravity", "sortDescending": true, "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): Dataset containing ClickBank Marketplace Scraper records (offer\_title, vendor, category, gravity, initial\_sale\_usd, avg\_sale\_usd, avg\_rebill\_usd, refund\_rate, and more). # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keyword": "weight loss", "sortBy": "gravity", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("bovi/clickbank-marketplace-scraper").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keyword": "weight loss", "sortBy": "gravity", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("bovi/clickbank-marketplace-scraper").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 '{ "keyword": "weight loss", "sortBy": "gravity", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call bovi/clickbank-marketplace-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bovi/clickbank-marketplace-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ClickBank Marketplace Scraper | Gravity, Sales, Refund Rate", "description": "Scrape the ClickBank affiliate marketplace by keyword or category. Returns gravity, initial/average sale $, average rebill $, refund rate, EPC stats, and more per offer. No login required. Pay per result.", "version": "0.1", "x-build-id": "BMktnaJF9GOWhl1E1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bovi~clickbank-marketplace-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bovi-clickbank-marketplace-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/bovi~clickbank-marketplace-scraper/runs": { "post": { "operationId": "runs-sync-bovi-clickbank-marketplace-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/bovi~clickbank-marketplace-scraper/run-sync": { "post": { "operationId": "run-sync-bovi-clickbank-marketplace-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "keyword": { "title": "Keyword", "type": "string", "description": "Free-text search across offer titles/descriptions, e.g. \"weight loss\", \"keto diet\", \"forex trading\". Leave blank + set a category to browse a whole category instead." }, "category": { "title": "Category", "type": "string", "description": "Optional marketplace category filter, e.g. \"Health & Fitness\", \"Business / Investing\", \"E-Business & E-Marketing\". Must match the category name exactly as shown on the ClickBank marketplace." }, "subCategory": { "title": "Sub-category", "type": "string", "description": "Optional marketplace sub-category filter (only applied together with Category), e.g. \"Dietary Supplements\"." }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "gravity", "biGravity", "averageEarningsPerSale", "averageEPC", "initialEarningsPerSale", "futureEarnings", "netEPC", "conversionRate" ], "type": "string", "description": "How to rank results. Gravity = ClickBank's affiliate-activity popularity score (default). relevance = keyword match strength." }, "sortDescending": { "title": "Sort descending", "type": "boolean", "description": "Highest values first. Default true.", "default": true }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of offers to return. Default 50." }, "affiliateNickname": { "title": "Your ClickBank affiliate nickname (optional)", "type": "string", "description": "Optional. If you supply your own ClickBank affiliate nickname, each record's hoplink field is built as your personalized tracking link (https://hop.clickbank.net/?affiliate=&vendor=). Leave blank and the actor still returns full data — hoplink is simply null." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy used for every request (required — the actor always runs through a proxy, never a bare connection). RESIDENTIAL is the default and works out of the box." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```