# HubSpot Solutions Partner Scraper - Agency Leads (`scrapesage/hubspot-solutions-partner-scraper`) Actor

Scrape the HubSpot Solutions Partner directory: agency name, partner tier, website, location, services, industries served, certifications, rating & reviews. Filter by tier, industry, service, language, budget & country. Optional email enrichment & monitoring. No login or API key.

- **URL**: https://apify.com/scrapesage/hubspot-solutions-partner-scraper.md
- **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community)
- **Categories:** Lead generation, Automation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $8.00 / 1,000 partner scrapeds

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

## HubSpot Solutions Partner Scraper — Agency & Partner Leads (Tiers, Reviews, Website)

Extract the **entire HubSpot Solutions Partner directory** — the 7,000+ agencies and service partners HubSpot certifies — as clean, structured, **ready-to-contact B2B leads**. Get each agency's **partner tier (Elite / Diamond / Platinum / Gold), website, office location, services, industries served, certifications, client rating & review count**, and optionally crawl their website for **emails, phones and social links**.

No login, no cookies, no API key, no browser — fast JSON extraction straight from HubSpot's public directory API.

### Why this HubSpot partner scraper?

HubSpot's directory is a goldmine of high-intent B2B prospects — every listing is a marketing/sales/RevOps/CRM agency that actively sells services and buys martech. Most generic agency scrapers stop at a name and a logo. This actor ships the **richest dataset in the category**:

| Data | Generic scrapers | This actor |
|---|---|---|
| Partner tier (Elite / Diamond / Platinum / Gold) | ❌ | ✅ |
| Agency **website** | partial | ✅ |
| Office / remote locations (city, state, country) | ❌ | ✅ |
| Services offered (CRM, onboarding, SEO, paid ads…) | ❌ | ✅ |
| Industries & regions served | ❌ | ✅ |
| HubSpot certifications + count | ❌ | ✅ |
| Supported integrations (count) | ❌ | ✅ |
| Client rating + review count | ❌ | ✅ |
| Sample client reviews (title, rating, text) | ❌ | ✅ opt-in |
| Public **emails / phones / socials** from the agency site | ❌ | ✅ opt-in |
| Lead score (0–100) per agency | ❌ | ✅ |
| Server-side filters: tier, industry, service, language, budget | ❌ | ✅ |
| Monitoring mode (only new / changed partners) | ❌ | ✅ |

### Use cases

- **Lead generation for martech & SaaS** — HubSpot Solutions Partners are active buyers and resellers: target them for complementary apps, integrations, data, training, white-label services and co-selling. Score by tier (`partnerTier`), client traction (`reviewCount`, `rating`) and reach (`enrichEmails`).
- **Partner-channel recruiting** — find agencies by tier, service line, industry focus and region to recruit into your own partner program.
- **Competitive & ecosystem intelligence** — map the HubSpot agency landscape: who's Elite, what they specialise in, which integrations they support, how reviewed they are.
- **Agency M&A / roll-ups** — build a sourcing list of agencies by tier, certifications, services and geography.
- **Recruiting & sales prospecting** — reach decision-makers at thousands of vetted agencies with website + enriched contact data.

### How to use

1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor.
2. Open the **HubSpot Solutions Partner Scraper**, choose your filters (tier, industry, service, country…) and click **Start**.
3. Watch results stream into the dataset table.
4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2).

### Input

```json
{
    "partnerTiers": ["elite", "diamond"],
    "industries": ["ECOMMERCE"],
    "services": ["HubSpot Onboarding", "CRM Implementation"],
    "countries": ["US"],
    "maxItems": 100,
    "includeProfileDetails": true,
    "includeReviews": false,
    "enrichEmails": false
}
````

- **partnerTiers** — keep only Elite / Diamond / Platinum / Gold partners (a strong size signal). Empty = all tiers.
- **industries** — keep only agencies serving these client industries (e.g. `ECOMMERCE`, `HEALTH`, `FINANCE_INSURANCE`).
- **services** — keep only agencies offering these services (e.g. `HubSpot Onboarding`, `CRM Implementation`, `Search Engine Optimization`).
- **languages / minBudget** — filter by working language(s) and minimum project budget band.
- **countries / locations** — keep only agencies in these countries (ISO codes) or city/region strings. Applied after fetching each profile.
- **searchQuery** — keyword across name, description, services and industries.
- **minRating / minReviews** — quality thresholds.
- **maxItems** *(default 100)* — cap on partner records for the run.
- **includeProfileDetails** *(default true)* — website, location, services, industries, certifications, integration count, publish dates.
- **includeReviews** *(default false)* — also fetch sample client reviews per agency.
- **enrichEmails** *(default false)* — crawl each agency's website (home + contact/about) for public emails, phones and socials.
- **monitorMode** *(default false)* — emit only agencies new or changed since previous runs.

### Output

One record per partner agency (`type: "partner"`):

```json
{
    "type": "partner",
    "companyName": "Bluleadz | GTM Strategy & HubSpot Implementation",
    "slug": "bluleadz",
    "profileUrl": "https://ecosystem.hubspot.com/marketplace/solutions/bluleadz",
    "listingId": 30344484,
    "partnerTier": "elite",
    "tierRank": 4,
    "partnerType": "partner",
    "description": "As HubSpot's most reviewed Elite partner, Bluleadz bridges the gap between strategy and execution…",
    "website": "https://www.bluleadz.com",
    "rating": 4.92,
    "adjustedRating": 4.9,
    "reviewCount": 1099,
    "logoUrl": "https://www.bluleadz.com/hubfs/Bluleadz-Logo.png",
    "city": "Tampa",
    "state": "FL",
    "country": "US",
    "locations": [
        { "city": "Tampa", "state": "FL", "country": "US", "full": "Tampa, FL, USA" },
        { "city": "Orlando", "state": "FL", "country": "US", "full": "Orlando, FL, USA" }
    ],
    "services": ["CRM Implementation", "CRM Migration", "HubSpot Onboarding", "Programmable Automation"],
    "serviceCount": 24,
    "industriesServed": ["Technology - software", "Consulting/advisory", "Manufacturing"],
    "regionsServed": ["North America", "Europe, Middle East & Africa (EMEA)", "South America"],
    "languages": ["en", "es"],
    "minimumBudget": "Any budget",
    "clientCompanySizes": ["11 to 25", "51 to 200", "201 to 1,000"],
    "certifications": ["Social Media Marketing Certification Course", "Inbound Certification"],
    "certificationCount": 7,
    "integrationCount": 51,
    "worksWithBreeze": false,
    "firstPublishedAt": "2026-03-26T00:43:40.240Z",
    "lastPublishedAt": "2026-04-23T13:22:14.544Z",
    "leadScore": 96,
    "scrapedAt": "2026-06-24T15:30:00.000Z"
}
```

With `enrichEmails` on, records also carry `emails`, `phones` and `socials`. With `includeReviews` on, records carry a `reviews` array.

### Automate & schedule

Run this actor on autopilot and pull results into your own stack:

- **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, manage schedules over REST.
- **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs.
- **[Schedules](https://docs.apify.com/platform/schedules)** — run it daily/weekly to catch newly listed or upgraded partners in a tier, industry or country; perfect for partner-recruiting and lead pipelines.
- **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes.

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

const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' });

const run = await client.actor('scrapesage/hubspot-solutions-partner-scraper').call({
    partnerTiers: ['elite', 'diamond'],
    countries: ['US'],
    maxItems: 200,
    enrichEmails: true,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} HubSpot partner leads`);
```

### Integrate with any app

Connect the dataset to 5,000+ apps — no code required:

- **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios.
- **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new partner leads straight into your CRM.
- **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored segment gains a new partner.
- **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet.
- **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse.
- **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases.

### Use with AI assistants (MCP)

The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find Elite HubSpot ecommerce agencies in the US with contact emails" and let it run this scraper for you.

### More scrapers from scrapesage

Build a complete **B2B agency & partner-ecosystem lead stack**:

- **[Xero Advisor Scraper](https://apify.com/scrapesage/xero-advisor-scraper)** — Xero-certified accountant & bookkeeper firm leads.
- **[Clutch Scraper](https://apify.com/scrapesage/clutch-scraper)** — agency profiles, reviews and B2B leads from Clutch.
- **[DesignRush Scraper](https://apify.com/scrapesage/designrush-scraper)** — agency directory leads with services, rates and contacts.
- **[B2B Agency Scraper](https://apify.com/scrapesage/b2b-agency-scraper)** — agency leads with services and contact data.
- **[LinkedIn Company Scraper](https://apify.com/scrapesage/linkedin-company-scraper)** — company firmographics and leads.
- **[LinkedIn Jobs Scraper](https://apify.com/scrapesage/linkedin-jobs-scraper)** — job postings as hiring-intent signals.
- **[Website Contact Scraper](https://apify.com/scrapesage/website-contact-scraper)** — emails, phones and socials from any domain list.
- **[TaxBuzz Scraper](https://apify.com/scrapesage/taxbuzz-scraper)** — tax & accounting professional leads.
- **[Google Maps Scraper](https://apify.com/scrapesage/google-maps-scraper)** — local business leads with contact details.

### Tips

- **Fast, focused runs**: filter server-side by `partnerTiers`, `industries`, `services`, `languages` or `minBudget` — these narrow the directory before any profile is fetched.
- **Country / location filters** are applied after fetching each profile (HubSpot has no public location facet), so they scan more listings. Raise `maxScan` if you target a small country.
- **Direct contacts**: turn on `enrichEmails` to add public emails, phones and socials from each agency's website — HubSpot does not publish them on the listing.
- **Recurring monitoring**: combine [Schedules](https://docs.apify.com/platform/schedules) with `monitorMode` to track only newly listed or upgraded partners.
- **Proxies**: keep the default Apify Proxy (automatic) — the directory API is served cleanly over datacenter IPs.

### FAQ

**What is a HubSpot Solutions Partner?** An agency or consultancy in HubSpot's official partner program (tiered Elite → Gold) that implements HubSpot and sells marketing, sales, CRM, RevOps and web services. The directory lists 7,000+ of them worldwide.

**Does it need the HubSpot API or a login?** No. It reads HubSpot's public directory search and listing endpoints — no API key, login, cookies or browser.

**Where do the emails come from?** Never from HubSpot (the listing has no email). With `enrichEmails` on, the actor visits the agency's own public website and extracts publicly listed contact details — the same thing a human visitor would see.

**Can I filter to one country or city?** Yes — set `countries` (ISO codes) and/or `locations`. Because HubSpot has no public location facet, these are applied after fetching each profile; raise `maxScan` for a small country.

**Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive).

**How do I monitor new partners automatically?** Create a [Schedule](https://docs.apify.com/platform/schedules) and turn on `monitorMode`; optionally add a [webhook](https://docs.apify.com/platform/integrations/webhooks) or [Zapier zap](https://docs.apify.com/platform/integrations/zapier) to push new partner leads into your CRM as they appear.

**A field is null — why?** Some agencies don't publish a state/postal code (remote-only), a budget band, or have no reviews yet. Fields are `null` only when the data genuinely doesn't exist on the listing, not because the scraper skipped them.

**Is scraping HubSpot's directory legal?** This actor collects publicly available data only. You are responsible for using the data in compliance with applicable laws (GDPR/CCPA for personal data) and HubSpot's terms.

### Need help?

Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained.

# Actor input Schema

## `partnerTiers` (type: `array`):

Keep only agencies at these HubSpot Solutions Partner tiers — a strong size / commitment signal. Leave empty for all tiers (the directory lists Elite, Diamond, Platinum and Gold partners).

## `industries` (type: `array`):

Keep only agencies that serve one of these client industries. Leave empty for all.

## `services` (type: `array`):

Keep only agencies that offer one of these services. Leave empty for all.

## `languages` (type: `array`):

Keep only agencies that work in one of these languages (ISO codes). Leave empty for all.

## `minBudget` (type: `string`):

Keep only agencies that accept projects in this budget band.

## `searchQuery` (type: `string`):

Optional keyword to match the agency name, description, services or industries (e.g. "ecommerce", "RevOps", "Shopify", "healthcare"). Applied to each profile after fetching it.

## `countries` (type: `array`):

Keep only agencies headquartered in these countries (ISO codes, e.g. US, GB, CA, AU). Applied after fetching each profile, so it scans more listings — raise "Max listings to scan" if you filter to a small country.

## `locations` (type: `array`):

Optional city or state/region filters (e.g. "Texas", "London", "New York", "Toronto"). Matched against each agency's office locations. Applied after fetching each profile.

## `minRating` (type: `integer`):

Keep only agencies with at least this average client rating (1-5). Leave empty for all.

## `minReviews` (type: `integer`):

Keep only agencies with at least this many client reviews. Leave empty for all.

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

Cap on partner records across the whole run.

## `includeProfileDetails` (type: `boolean`):

Fetch each agency's full profile for website, office location, services, industries served, regions, languages, certifications, integration count and publish dates (one extra request per partner). Recommended — the website and location only exist on the profile. Country / location filters require this.

## `includeReviews` (type: `boolean`):

Opt-in: also fetch sample client reviews for each agency (title, rating, text, date, reviewer). Adds one request per partner.

## `maxReviewsPerPartner` (type: `integer`):

How many client reviews to fetch per agency when reviews are on.

## `enrichEmails` (type: `boolean`):

Opt-in: visit each agency's own website (home + a contact/about page) to extract public emails, phones and social links. HubSpot does not publish direct emails on the listing, so this is the way to obtain contact details.

## `maxEmailPagesPerSite` (type: `integer`):

How many pages of each agency's website to scan for contact details when enrichment is on (home page plus likely contact/about pages).

## `maxScan` (type: `integer`):

Safety ceiling on how many listings to scan when country / location filters are active (they are evaluated after fetching each profile). Increase it to fill the cap for a small country.

## `monitorMode` (type: `boolean`):

Remember which partners were already returned and emit ONLY agencies not seen (or changed) since previous runs. Pairs with Apify Schedules to track new HubSpot partners and listing changes over time.

## `monitorStoreName` (type: `string`):

Named key-value store that holds the 'already seen' partner ids for monitoring mode. Use a different name per tracked segment to keep histories separate.

## `proxyConfiguration` (type: `object`):

Proxy settings. The HubSpot directory API is served cleanly over datacenter IPs, so Apify Proxy (automatic) is the default and cheapest option. Blocked requests retry automatically on a fresh IP.

## Actor input object example

```json
{
  "partnerTiers": [],
  "industries": [],
  "services": [],
  "languages": [],
  "minBudget": "",
  "countries": [],
  "maxItems": 100,
  "includeProfileDetails": true,
  "includeReviews": false,
  "maxReviewsPerPartner": 10,
  "enrichEmails": false,
  "maxEmailPagesPerSite": 3,
  "maxScan": 1500,
  "monitorMode": false,
  "monitorStoreName": "hubspot-partner-monitor",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

All scraped partner records in the default dataset — agency name, tier, website, location, services, industries, certifications, rating, review count, profile URL and lead score.

# 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 = {
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapesage/hubspot-solutions-partner-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "maxItems": 100 }

# Run the Actor and wait for it to finish
run = client.actor("scrapesage/hubspot-solutions-partner-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 '{
  "maxItems": 100
}' |
apify call scrapesage/hubspot-solutions-partner-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "HubSpot Solutions Partner Scraper - Agency Leads",
        "description": "Scrape the HubSpot Solutions Partner directory: agency name, partner tier, website, location, services, industries served, certifications, rating & reviews. Filter by tier, industry, service, language, budget & country. Optional email enrichment & monitoring. No login or API key.",
        "version": "0.1",
        "x-build-id": "oNslZeZ5VJymFTBYV"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapesage~hubspot-solutions-partner-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapesage-hubspot-solutions-partner-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/scrapesage~hubspot-solutions-partner-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scrapesage-hubspot-solutions-partner-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/scrapesage~hubspot-solutions-partner-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scrapesage-hubspot-solutions-partner-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": {
                    "partnerTiers": {
                        "title": "Partner tiers",
                        "type": "array",
                        "description": "Keep only agencies at these HubSpot Solutions Partner tiers — a strong size / commitment signal. Leave empty for all tiers (the directory lists Elite, Diamond, Platinum and Gold partners).",
                        "items": {
                            "type": "string",
                            "enum": [
                                "elite",
                                "diamond",
                                "platinum",
                                "gold"
                            ],
                            "enumTitles": [
                                "Elite",
                                "Diamond",
                                "Platinum",
                                "Gold"
                            ]
                        },
                        "default": []
                    },
                    "industries": {
                        "title": "Industries served (optional)",
                        "type": "array",
                        "description": "Keep only agencies that serve one of these client industries. Leave empty for all.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "ECOMMERCE",
                                "TECHNOLOGY_SOFTWARE",
                                "MARKETING_SERVICES",
                                "FINANCE_INSURANCE",
                                "BANKING_FINANCIAL_SERVICES",
                                "HEALTH",
                                "MEDICAL_WELLNESS",
                                "REAL_ESTATE",
                                "MANUFACTURING",
                                "CONSULTING_ADVISORY",
                                "BUSINESS_SERVICES_GENERAL",
                                "EDUCATION",
                                "NON_PROFIT",
                                "CONSTRUCTION_RENOVATION",
                                "RETAIL",
                                "CONSUMER_PRODUCTS",
                                "CONSUMER_SERVICES",
                                "HOSPITALITY",
                                "TOURISM_TRAVEL",
                                "LEGAL_SERVICES",
                                "MEDIA_PUBLISHING",
                                "ENTERTAINMENT",
                                "RECRUITING_STAFFING",
                                "AUTOMOTIVE_TRANSPORT",
                                "TRANSPORTATION_STORAGE",
                                "TELECOM_MOBILE_COMMUNICATIONS",
                                "TECHNOLOGY_HARDWARE_STORAGE",
                                "DATA_PROCESSING_HOSTING",
                                "ELECTRONICS",
                                "ENERGY",
                                "OIL_GAS",
                                "UTILITIES",
                                "GOVERNMENT",
                                "ARCHITECTURE",
                                "SHIPPING",
                                "WASTE_MANAGEMENT",
                                "OTHER"
                            ],
                            "enumTitles": [
                                "Ecommerce",
                                "Technology - software",
                                "Marketing services",
                                "Finance & insurance",
                                "Banking/financial services",
                                "Health",
                                "Medical & wellness",
                                "Real estate",
                                "Manufacturing",
                                "Consulting/advisory",
                                "Business services - general",
                                "Education",
                                "Nonprofit",
                                "Construction & renovation",
                                "Retail",
                                "Consumer products",
                                "Consumer services",
                                "Hospitality",
                                "Tourism/travel",
                                "Legal services",
                                "Media & publishing",
                                "Entertainment",
                                "Recruiting/staffing",
                                "Automotive & transport",
                                "Transportation & storage",
                                "Telecom & mobile communications",
                                "Technology - hardware & storage",
                                "Data processing & hosting",
                                "Electronics",
                                "Energy",
                                "Oil & gas",
                                "Utilities",
                                "Government",
                                "Architecture",
                                "Shipping",
                                "Waste management",
                                "Other"
                            ]
                        },
                        "default": []
                    },
                    "services": {
                        "title": "Services offered (optional)",
                        "type": "array",
                        "description": "Keep only agencies that offer one of these services. Leave empty for all.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "HubSpot Onboarding",
                                "CRM Implementation",
                                "CRM Migration",
                                "Marketing Hub Professional Onboarding",
                                "Marketing Hub Enterprise Onboarding",
                                "Sales Hub Professional Onboarding",
                                "Sales Hub Enterprise Onboarding",
                                "Service Hub Professional Onboarding",
                                "Service Hub Enterprise Onboarding",
                                "CMS Professional Onboarding",
                                "CMS Enterprise Onboarding",
                                "Full Inbound Marketing Services",
                                "Email Marketing",
                                "Paid Advertising",
                                "Search Engine Optimization",
                                "Social Media",
                                "Content Creation",
                                "Account based marketing",
                                "Branding",
                                "Public Relations",
                                "Video Production",
                                "Website Design",
                                "Website Development",
                                "Website Migration",
                                "Custom API Integrations",
                                "Programmable Automation",
                                "Revenue Hub Implementation",
                                "CPQ Implementation",
                                "Billing and Payments Implementation",
                                "Sales Enablement",
                                "Sales Coaching and Training",
                                "Sales and Marketing Alignment",
                                "Customer Marketing",
                                "Conversational Marketing",
                                "Community Management",
                                "Help Desk Implementation",
                                "Knowledge Base Development",
                                "Customer Success Training",
                                "Customer Support Training",
                                "Customer Survey and Analysis"
                            ]
                        },
                        "default": []
                    },
                    "languages": {
                        "title": "Languages (optional)",
                        "type": "array",
                        "description": "Keep only agencies that work in one of these languages (ISO codes). Leave empty for all.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "en",
                                "es",
                                "fr",
                                "de",
                                "pt",
                                "it",
                                "nl",
                                "sv",
                                "da",
                                "no",
                                "fi",
                                "pl",
                                "ru",
                                "ja",
                                "zh",
                                "ko",
                                "ar",
                                "tr",
                                "he",
                                "cs",
                                "ro",
                                "el",
                                "th",
                                "id",
                                "hi"
                            ],
                            "enumTitles": [
                                "English",
                                "Spanish",
                                "French",
                                "German",
                                "Portuguese",
                                "Italian",
                                "Dutch",
                                "Swedish",
                                "Danish",
                                "Norwegian",
                                "Finnish",
                                "Polish",
                                "Russian",
                                "Japanese",
                                "Chinese",
                                "Korean",
                                "Arabic",
                                "Turkish",
                                "Hebrew",
                                "Czech",
                                "Romanian",
                                "Greek",
                                "Thai",
                                "Indonesian",
                                "Hindi"
                            ]
                        },
                        "default": []
                    },
                    "minBudget": {
                        "title": "Minimum project budget (optional)",
                        "enum": [
                            "",
                            "LOWER",
                            "MIDDLE",
                            "UPPER",
                            "ANY"
                        ],
                        "type": "string",
                        "description": "Keep only agencies that accept projects in this budget band.",
                        "default": ""
                    },
                    "searchQuery": {
                        "title": "Keyword (optional)",
                        "type": "string",
                        "description": "Optional keyword to match the agency name, description, services or industries (e.g. \"ecommerce\", \"RevOps\", \"Shopify\", \"healthcare\"). Applied to each profile after fetching it."
                    },
                    "countries": {
                        "title": "Countries (optional)",
                        "type": "array",
                        "description": "Keep only agencies headquartered in these countries (ISO codes, e.g. US, GB, CA, AU). Applied after fetching each profile, so it scans more listings — raise \"Max listings to scan\" if you filter to a small country.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "US",
                                "GB",
                                "CA",
                                "AU",
                                "IN",
                                "DE",
                                "FR",
                                "ES",
                                "NL",
                                "BR",
                                "IT",
                                "MX",
                                "IE",
                                "SE",
                                "ZA",
                                "SG",
                                "AE",
                                "NZ",
                                "PL",
                                "PT",
                                "BE",
                                "DK",
                                "CH",
                                "AT",
                                "NO",
                                "FI",
                                "PH",
                                "CO",
                                "AR",
                                "CL"
                            ],
                            "enumTitles": [
                                "United States",
                                "United Kingdom",
                                "Canada",
                                "Australia",
                                "India",
                                "Germany",
                                "France",
                                "Spain",
                                "Netherlands",
                                "Brazil",
                                "Italy",
                                "Mexico",
                                "Ireland",
                                "Sweden",
                                "South Africa",
                                "Singapore",
                                "United Arab Emirates",
                                "New Zealand",
                                "Poland",
                                "Portugal",
                                "Belgium",
                                "Denmark",
                                "Switzerland",
                                "Austria",
                                "Norway",
                                "Finland",
                                "Philippines",
                                "Colombia",
                                "Argentina",
                                "Chile"
                            ]
                        },
                        "default": []
                    },
                    "locations": {
                        "title": "Locations (optional)",
                        "type": "array",
                        "description": "Optional city or state/region filters (e.g. \"Texas\", \"London\", \"New York\", \"Toronto\"). Matched against each agency's office locations. Applied after fetching each profile.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "minRating": {
                        "title": "Minimum rating (optional)",
                        "minimum": 1,
                        "maximum": 5,
                        "type": "integer",
                        "description": "Keep only agencies with at least this average client rating (1-5). Leave empty for all."
                    },
                    "minReviews": {
                        "title": "Minimum review count (optional)",
                        "minimum": 1,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Keep only agencies with at least this many client reviews. Leave empty for all."
                    },
                    "maxItems": {
                        "title": "Max results (partners)",
                        "minimum": 1,
                        "maximum": 50000,
                        "type": "integer",
                        "description": "Cap on partner records across the whole run.",
                        "default": 100
                    },
                    "includeProfileDetails": {
                        "title": "Include full profile details",
                        "type": "boolean",
                        "description": "Fetch each agency's full profile for website, office location, services, industries served, regions, languages, certifications, integration count and publish dates (one extra request per partner). Recommended — the website and location only exist on the profile. Country / location filters require this.",
                        "default": true
                    },
                    "includeReviews": {
                        "title": "Include client reviews",
                        "type": "boolean",
                        "description": "Opt-in: also fetch sample client reviews for each agency (title, rating, text, date, reviewer). Adds one request per partner.",
                        "default": false
                    },
                    "maxReviewsPerPartner": {
                        "title": "Max reviews per partner",
                        "minimum": 1,
                        "maximum": 50,
                        "type": "integer",
                        "description": "How many client reviews to fetch per agency when reviews are on.",
                        "default": 10
                    },
                    "enrichEmails": {
                        "title": "Enrich emails from agency website",
                        "type": "boolean",
                        "description": "Opt-in: visit each agency's own website (home + a contact/about page) to extract public emails, phones and social links. HubSpot does not publish direct emails on the listing, so this is the way to obtain contact details.",
                        "default": false
                    },
                    "maxEmailPagesPerSite": {
                        "title": "Max website pages per agency (email enrichment)",
                        "minimum": 1,
                        "maximum": 6,
                        "type": "integer",
                        "description": "How many pages of each agency's website to scan for contact details when enrichment is on (home page plus likely contact/about pages).",
                        "default": 3
                    },
                    "maxScan": {
                        "title": "Max listings to scan",
                        "minimum": 100,
                        "maximum": 20000,
                        "type": "integer",
                        "description": "Safety ceiling on how many listings to scan when country / location filters are active (they are evaluated after fetching each profile). Increase it to fill the cap for a small country.",
                        "default": 1500
                    },
                    "monitorMode": {
                        "title": "Monitoring mode - only new partners",
                        "type": "boolean",
                        "description": "Remember which partners were already returned and emit ONLY agencies not seen (or changed) since previous runs. Pairs with Apify Schedules to track new HubSpot partners and listing changes over time.",
                        "default": false
                    },
                    "monitorStoreName": {
                        "title": "Monitor store name",
                        "type": "string",
                        "description": "Named key-value store that holds the 'already seen' partner ids for monitoring mode. Use a different name per tracked segment to keep histories separate.",
                        "default": "hubspot-partner-monitor"
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Proxy settings. The HubSpot directory API is served cleanly over datacenter IPs, so Apify Proxy (automatic) is the default and cheapest option. Blocked requests retry automatically on a fresh IP.",
                        "default": {
                            "useApifyProxy": true
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
