# HubSpot App Marketplace Scraper (`automation-lab/hubspot-app-marketplace-scraper`) Actor Extract HubSpot App Marketplace apps, vendors, ratings, install counts, pricing signals, and public app detail fields. - **URL**: https://apify.com/automation-lab/hubspot-app-marketplace-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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 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 App Marketplace Scraper Extract app listings, vendors, install counts, ratings, pricing signals, support links, and public listing details from the HubSpot App Marketplace. Use this actor when you need a structured dataset of HubSpot ecosystem apps for lead generation, partner research, competitive intelligence, category monitoring, or sales enablement. --- ### What does HubSpot App Marketplace Scraper do? HubSpot App Marketplace Scraper collects public app records from `ecosystem.hubspot.com/marketplace/apps`. It uses HubSpot's public marketplace RPC endpoints instead of slow browser automation. That means runs are fast, low-cost, and suitable for repeat monitoring. The actor can scrape: - App names - Vendor and provider names - Marketplace URLs - App summaries and overview text - Install counts - Ratings and review counts - HubSpot certification signals - Product and connection types - Category labels and search terms - Pricing plan labels when listed - Company, support, setup, terms, and privacy URLs - Feature names and feature descriptions - Screenshots and app icons ### Who is it for? This actor is useful for teams that sell to, partner with, or analyze HubSpot ecosystem vendors. Typical users include: - SaaS sales teams building HubSpot app vendor lead lists - Partnership teams mapping integration opportunities - RevOps teams tracking tools used in the HubSpot ecosystem - Market researchers monitoring category growth - Agencies comparing apps in CRM, email, ecommerce, or automation categories - Product marketers watching competitor positioning - Data teams enriching internal vendor databases ### Why use this actor? The HubSpot Marketplace is valuable but not convenient to export manually. This actor turns public listing pages into normalized JSON records. You can run it once for a category export or schedule it to detect new apps and listing changes. Benefits: - No login required - No browser rendering required - Public marketplace data only - Clean fields ready for CSV, Excel, API, or BI tools - Works with search phrases, category filters, and marketplace URLs - Includes detail fields that are usually hidden behind client-side rendering ### Data fields The default dataset contains one item per HubSpot app. | Field | Description | | --- | --- | | `listingId` | HubSpot listing ID | | `appName` | App listing name | | `vendorName` | Vendor/company name | | `providerName` | Provider from search results | | `summary` | Short listing tagline | | `overviewText` | Cleaned listing overview | | `marketplaceUrl` | Public HubSpot Marketplace listing URL | | `installCount` | Public install count | | `rating` | Average rating when available | | `reviewCount` | Number of reviews when available | | `certified` | Whether HubSpot marks the app as certified | | `categoryLabels` | Public category labels | | `pricingPlans` | Pricing plan labels when visible | | `companyUrl` | Vendor website URL | | `supportUrl` | Vendor support URL | | `supportEmail` | Support email or support contact value | | `features` | Feature names and descriptions | | `screenshots` | Screenshot URLs | ### How much does it cost to scrape HubSpot Marketplace apps? The actor uses pay-per-event pricing. You pay a small start fee and a per-app fee for each saved app record. Because the actor uses HTTP calls to public HubSpot marketplace endpoints, compute usage is low. A small test run with 100 apps is the recommended first run. Exact billing is shown by Apify before and after each run. ### Input options You can control the scrape with these inputs: - `searchQueries` — marketplace search phrases such as `email marketing` or `sales automation` - `categories` — HubSpot category values such as `EMAIL`, `CRM`, or `MARKETING_AUTOMATION` - `startUrls` — HubSpot Marketplace URLs with `eco_search` or `eco_CATEGORY` query params - `maxItems` — maximum apps to save - `includeDetails` — fetch detailed app records for support links, overview, features, and screenshots - `requestDelayMs` — optional delay between requests ### Example input ```json { "searchQueries": ["sales automation", "email marketing"], "maxItems": 100, "includeDetails": true, "requestDelayMs": 150 } ```` ### Category example ```json { "categories": ["EMAIL", "CRM"], "maxItems": 200, "includeDetails": true } ``` Useful category values include: - `EMAIL` - `CRM` - `MARKETING_AUTOMATION` - `E_COMMERCE` - `DATA_QUALITY_BACKUP` - `CUSTOMER_SUCCESS` - `HELP_DESK` - `ACCOUNTING` - `ADVERTISING` - `COLLABORATION` ### Marketplace URL example ```json { "startUrls": [ { "url": "https://ecosystem.hubspot.com/marketplace/search?eco_search=crm&eco_CATEGORY=CRM" } ], "maxItems": 100, "includeDetails": true } ``` ### Output example ```json { "listingId": 30050897, "appName": "Gmail", "vendorName": "HubSpot", "summary": "Bring HubSpot to your inbox with the HubSpot integration for Gmail.", "marketplaceUrl": "https://ecosystem.hubspot.com/marketplace/listing/gmail", "installCount": 527170, "rating": 3.99, "reviewCount": 3418, "certified": true, "categoryLabels": ["Email"], "companyUrl": "https://www.hubspot.com/", "supportUrl": "https://help.hubspot.com/" } ``` ### How to run 1. Open the actor on Apify. 2. Enter search queries, categories, or HubSpot Marketplace URLs. 3. Set `maxItems` to the number of app records you need. 4. Keep `includeDetails` enabled if you need support links and feature text. 5. Run the actor. 6. Export the dataset as JSON, CSV, Excel, XML, or via API. ### Tips for best results Start with a narrow query when researching a niche. Use category filters when you want broad category coverage. Use `includeDetails: false` for a quick install-count and rating scan. Use `includeDetails: true` for lead generation and vendor enrichment. Schedule recurring runs to monitor new apps in a category. ### Integrations The dataset works well with common Apify integrations. Examples: - Export HubSpot app leads to Google Sheets. - Send new vendors to a CRM enrichment workflow. - Compare install counts and reviews in a BI dashboard. - Trigger alerts when new apps appear in a category. - Feed app descriptions into an internal competitive-intelligence database. ### API usage Run the actor from Node.js: ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/hubspot-app-marketplace-scraper').call({ searchQueries: ['crm'], maxItems: 100, includeDetails: true, }); console.log(run.defaultDatasetId); ``` ### Python API usage ```python from apify_client import ApifyClient client = ApifyClient('YOUR_APIFY_TOKEN') run = client.actor('automation-lab/hubspot-app-marketplace-scraper').call(run_input={ 'categories': ['EMAIL'], 'maxItems': 100, 'includeDetails': True, }) print(run['defaultDatasetId']) ``` ### cURL API usage ```bash curl "https://api.apify.com/v2/acts/automation-lab~hubspot-app-marketplace-scraper/runs?token=$APIFY_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"searchQueries":["sales automation"],"maxItems":100,"includeDetails":true}' ``` ### MCP usage Use this actor from Claude or other MCP-compatible tools through Apify MCP. MCP server URL: ```text https://mcp.apify.com/?tools=automation-lab/hubspot-app-marketplace-scraper ``` Claude Code setup: ```bash claude mcp add apify-hubspot-marketplace "https://mcp.apify.com/?tools=automation-lab/hubspot-app-marketplace-scraper" ``` Claude Desktop JSON config: ```json { "mcpServers": { "apify-hubspot-marketplace": { "url": "https://mcp.apify.com/?tools=automation-lab/hubspot-app-marketplace-scraper" } } } ``` Example prompts: - "Scrape the top 100 HubSpot CRM apps and summarize the largest vendors." - "Find HubSpot Marketplace apps in the email category with public support URLs." - "Monitor new HubSpot marketing automation apps every week." ### Common workflows Lead generation workflow: 1. Search a HubSpot category. 2. Export app names, vendors, websites, and support contacts. 3. Enrich companies in your CRM. 4. Assign outreach by category or install count. Competitive monitoring workflow: 1. Run the same query weekly. 2. Compare install counts, ratings, and summaries. 3. Track new entrants and changed messaging. ### Troubleshooting If a run returns fewer records than expected, increase `maxItems` and check whether your category or search phrase is too narrow. If category filters return zero records, use HubSpot's uppercase category values such as `EMAIL`, `CRM`, or `MARKETING_AUTOMATION`. If detail fields are not needed, disable `includeDetails` for faster exports. ### Limitations This actor extracts public marketplace data only. It does not log in to HubSpot. It does not install apps. It does not collect private customer data. Some fields are optional because HubSpot vendors do not publish every contact, pricing, or support field. ### Legality This actor is designed to collect publicly available business listing information from the HubSpot App Marketplace. You are responsible for using exported data in compliance with applicable laws, HubSpot terms, and your own data governance rules. Avoid spam and respect opt-out requests when using vendor contact information. ### Related scrapers Other automation-lab actors that may pair well with this actor: - https://apify.com/automation-lab/website-contact-finder - https://apify.com/automation-lab/g2-scraper - https://apify.com/automation-lab/github-marketplace-scraper - https://apify.com/automation-lab/zoom-app-marketplace-scraper ### FAQ Can I scrape all HubSpot apps? Yes. Leave `searchQueries` and `categories` empty, set `maxItems`, and keep `includeDetails` enabled if you need full public listing details. Can I scrape only one category? Yes. Use the `categories` input with values such as `EMAIL` or `CRM`. Does it need proxies? No proxy is required for normal runs because the actor uses public HubSpot marketplace endpoints. Does it return emails? It returns the public `supportEmail` value when a vendor publishes it. Some vendors use support URLs instead of email addresses. ### Changelog - Initial version: public HubSpot App Marketplace listing and detail extraction. # Actor input Schema ## `searchQueries` (type: `array`): HubSpot Marketplace search phrases. Leave empty to scrape all app listings. ## `categories` (type: `array`): Optional HubSpot category filter values, for example EMAIL, CRM, MARKETING\_AUTOMATION, E\_COMMERCE, DATA\_QUALITY\_BACKUP, CUSTOMER\_SUCCESS. ## `startUrls` (type: `array`): Optional HubSpot Marketplace URLs. The actor parses eco\_search, eco\_CATEGORY, and page query parameters. ## `maxItems` (type: `integer`): Maximum app listings to save across all searches and URLs. ## `includeDetails` (type: `boolean`): Fetch each app's public detail record for overview, support links, pricing plan labels, features, and screenshots. ## `requestDelayMs` (type: `integer`): Delay between HubSpot public RPC requests. Increase this if you run very large exports. ## Actor input object example ```json { "searchQueries": [ "sales automation", "email marketing" ], "categories": [], "startUrls": [ { "url": "https://ecosystem.hubspot.com/marketplace/apps" } ], "maxItems": 10, "includeDetails": true, "requestDelayMs": 150 } ``` # Actor output Schema ## `overview` (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 = { "searchQueries": [ "sales automation", "email marketing" ], "categories": [], "startUrls": [ { "url": "https://ecosystem.hubspot.com/marketplace/apps" } ], "maxItems": 10, "includeDetails": true, "requestDelayMs": 150 }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/hubspot-app-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 = { "searchQueries": [ "sales automation", "email marketing", ], "categories": [], "startUrls": [{ "url": "https://ecosystem.hubspot.com/marketplace/apps" }], "maxItems": 10, "includeDetails": True, "requestDelayMs": 150, } # Run the Actor and wait for it to finish run = client.actor("automation-lab/hubspot-app-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 '{ "searchQueries": [ "sales automation", "email marketing" ], "categories": [], "startUrls": [ { "url": "https://ecosystem.hubspot.com/marketplace/apps" } ], "maxItems": 10, "includeDetails": true, "requestDelayMs": 150 }' | apify call automation-lab/hubspot-app-marketplace-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/hubspot-app-marketplace-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "HubSpot App Marketplace Scraper", "description": "Extract HubSpot App Marketplace apps, vendors, ratings, install counts, pricing signals, and public app detail fields.", "version": "0.1", "x-build-id": "n6tUIU0FQc9vrhoFR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~hubspot-app-marketplace-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-hubspot-app-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/automation-lab~hubspot-app-marketplace-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-hubspot-app-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/automation-lab~hubspot-app-marketplace-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-hubspot-app-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": { "searchQueries": { "title": "🔎 Search queries", "type": "array", "description": "HubSpot Marketplace search phrases. Leave empty to scrape all app listings.", "items": { "type": "string" } }, "categories": { "title": "🏷️ Category filters", "type": "array", "description": "Optional HubSpot category filter values, for example EMAIL, CRM, MARKETING_AUTOMATION, E_COMMERCE, DATA_QUALITY_BACKUP, CUSTOMER_SUCCESS.", "items": { "type": "string" } }, "startUrls": { "title": "🌐 Marketplace URLs", "type": "array", "description": "Optional HubSpot Marketplace URLs. The actor parses eco_search, eco_CATEGORY, and page query parameters.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum apps", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum app listings to save across all searches and URLs.", "default": 10 }, "includeDetails": { "title": "Fetch app details", "type": "boolean", "description": "Fetch each app's public detail record for overview, support links, pricing plan labels, features, and screenshots.", "default": true }, "requestDelayMs": { "title": "Request delay (ms)", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Delay between HubSpot public RPC requests. Increase this if you run very large exports.", "default": 150 } } }, "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 } } } } } } } } } } ```