# Klaviyo Partner Directory Scraper (`piotrv1001/klaviyo-partner-directory-scraper`) Actor The Klaviyo Partner Directory Scraper extracts Klaviyo agency profiles from connect.klaviyo.com, capturing names, websites, partner tiers, badges, services, specializations, office locations, client brands, testimonials, and ratings — ideal for B2B lead generation and agency market research. - **URL**: https://apify.com/piotrv1001/klaviyo-partner-directory-scraper.md - **Developed by:** [FalconScrape](https://apify.com/piotrv1001) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $15.00 / 1,000 partner profiles This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ### 🤝 Klaviyo Partner Directory Scraper Extract the complete **[Klaviyo Service Partner Directory](https://connect.klaviyo.com/)** — every certified Klaviyo agency, consultancy, and solution partner — as clean, structured data. The **Klaviyo Partner Directory Scraper** turns a curated list of pre-qualified email/SMS, lifecycle, and e-commerce agencies into a ready-to-use lead and market-research dataset. Run it on the Apify platform to get API access, scheduling, integrations, and monitoring out of the box, and export your results to **JSON, CSV, Excel, or HTML** in one click. ### ✨ What does Klaviyo Partner Directory Scraper do? - 🏢 **Full partner profiles** — name, website, headline, full bio, and logo for every listed agency. - 🥇 **Tier & credibility signals** — partner tier (Platinum/Gold/Silver Master), badges, and featured status. - 🛠️ **Services & specializations** — capabilities, e-commerce platform expertise, industries, brand-size focus, and serviced regions, grouped by category. - 📍 **Locations** — country, region, and city for each office. - ⭐ **Social proof** — client brands, testimonials, ratings, and review counts where available. - 🌐 **Enrichment-ready websites** — every partner exposes its real external website domain, perfect for piping into email-enrichment tools to build a contact list. ### 💼 Why use Klaviyo Partner Directory Scraper? - **Agency lead generation** — build a targeted list of vetted, Klaviyo-certified agencies to partner with, recruit, or sell to. - **Competitive & market research** — analyze the agency landscape by tier, region, services, and client portfolios. - **Partnership & recruitment** — find specialists by platform (Shopify, Shopify Plus), industry, or region. - **Sales prospecting** — combine each partner's website with enrichment services to reach decision-makers directly. Because partners are **certified by Klaviyo**, the data is pre-qualified — every record is a real, active agency, not a noisy generic listing. ### 🛠️ How to use the Klaviyo Partner Directory Scraper 1. **Set how many partners you want** — adjust **Maximum partners** (default 50, or set to 0 to scrape the entire directory). 2. **Click Start** — the scraper discovers and collects partner profiles automatically. No URLs to paste. 3. **Export your data** — download the dataset as JSON, CSV, Excel, or HTML, or pull it via the Apify API. ### 📥 Input The input is intentionally simple — see the **Input** tab: | Field | Description | | --- | --- | | **Maximum partners** (`maxItems`) | Maximum number of partners to scrape. Set to `0` for the full directory. Default: `50`. | | **Proxy configuration** (`proxyConfiguration`) | Standard Apify proxy settings. The default works for most runs. | Example input: ```json { "maxItems": 50, "proxyConfiguration": { "useApifyProxy": false } } ```` ### 📊 Output Each partner becomes one structured record. You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. Example (trimmed): ```json { "url": "https://connect.klaviyo.com/partner/1r", "slug": "1r", "name": "1r", "website": "https://1r.agency/", "headline": "1r is a certified Klaviyo partner", "descriptionText": "1r is a global, full-service agency that partners with innovators and creators to power commerce...", "logo": "https://s3-us-west-1.amazonaws.com/partnerpage.prod/media/directories/images/...png", "tier": "Platinum Master", "badges": ["Advisor: Platinum"], "featured": false, "rating": null, "numberOfReviews": null, "primaryLocation": "New York, United States", "locations": [{ "country": "United States", "region": "New York", "city": null }], "services": [ { "category": "Ecommerce Platform Expertise", "name": "Shopify Plus" }, { "category": "Service Capabilities", "name": "Strategy & Consulting" }, { "category": "Industry Specialization", "name": "Retail: Apparel & Beauty" } ], "clients": ["Westman Atelier", "Maison Louis Marie", "goop"], "testimonials": [], "contactUrl": "https://connect.klaviyo.com/partner/1r/contact", "ownerName": "1r Agency" } ``` #### Data fields | Field | Description | | --- | --- | | `name` / `slug` | Partner name and directory slug | | `website` | The agency's real external website (enrichment-ready) | | `headline` / `description` / `descriptionText` | Tagline and full bio (HTML and plain text) | | `logo` | Partner logo image URL | | `tier` / `badges` / `featured` | Klaviyo tier, badges, and featured flag | | `rating` / `numberOfReviews` | Review score and count, where available | | `primaryLocation` / `locations` | Office locations (country, region, city) | | `services` | Capabilities, platform expertise, industries, and regions, grouped by category | | `clients` | Client brand names shown on the profile | | `testimonials` | Client testimonials (author, position, company, text) | | `contactUrl` / `ownerName` | On-site contact page and profile owner | ### 💰 How much does it cost to scrape the Klaviyo partner directory? This Actor uses a **pay-per-result** model: you pay **$0.015 per partner** scraped — and nothing for partners you don't collect. The directory currently lists roughly **570 partners**, so collecting the **entire directory costs about $8.60**. A default run of 50 partners costs around **$0.75**. There is no separate platform usage fee to worry about — the per-result price is all-in. ### 💡 Tips - Start with the default of 50 partners to preview the data, then set **Maximum partners** to `0` to pull the full directory. - Schedule regular runs to keep your agency dataset fresh as new partners join. - Pipe the `website` field into an email-enrichment tool to turn the directory into a contactable lead list. ### ❓ FAQ **Is scraping the Klaviyo partner directory legal?** The Actor collects only publicly available information from the partner directory. As with any scraping, use the data responsibly and in compliance with applicable laws and the target site's terms. This tool is intended for legitimate market research and B2B lead generation. **Are partner email addresses included?** No. The directory does not publish partner emails or phone numbers — contact runs through an on-site form. However, every partner's external website is included, which you can enrich to recover contact details. **How many partners can I get?** The full directory (~570 partners) in a single run. Set **Maximum partners** to `0` for everything. **Something not working or missing?** Open an issue on the Actor's **Issues** tab — feedback and custom-solution requests are welcome. # Actor input Schema ## `maxItems` (type: `integer`): Maximum number of partners to scrape. Set to 0 to scrape the entire directory. ## `proxyConfiguration` (type: `object`): Proxy settings used for the scrape. The default works for most runs. ## Actor input object example ```json { "maxItems": 50, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("piotrv1001/klaviyo-partner-directory-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 = {} # Run the Actor and wait for it to finish run = client.actor("piotrv1001/klaviyo-partner-directory-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 '{}' | apify call piotrv1001/klaviyo-partner-directory-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=piotrv1001/klaviyo-partner-directory-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Klaviyo Partner Directory Scraper", "description": "The Klaviyo Partner Directory Scraper extracts Klaviyo agency profiles from connect.klaviyo.com, capturing names, websites, partner tiers, badges, services, specializations, office locations, client brands, testimonials, and ratings — ideal for B2B lead generation and agency market research.", "version": "0.0", "x-build-id": "7ThGpZPplwXgcpGxj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piotrv1001~klaviyo-partner-directory-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piotrv1001-klaviyo-partner-directory-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/piotrv1001~klaviyo-partner-directory-scraper/runs": { "post": { "operationId": "runs-sync-piotrv1001-klaviyo-partner-directory-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/piotrv1001~klaviyo-partner-directory-scraper/run-sync": { "post": { "operationId": "run-sync-piotrv1001-klaviyo-partner-directory-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": { "maxItems": { "title": "Maximum partners", "minimum": 0, "type": "integer", "description": "Maximum number of partners to scrape. Set to 0 to scrape the entire directory.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings used for the scrape. The default works for most runs.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```