# Pubrio - Business Data Layer for AI (`pubrio/pubrio-api`) Actor We build the glocalized business data layer for AI agents and revenue teams. Pubrio provides B2B data intelligence APIs covering company firmographics, people profiles, verified contact details, job postings, news, and advertisement signals across global markets. - **URL**: https://apify.com/pubrio/pubrio-api.md - **Developed by:** [King Lai](https://apify.com/pubrio) (community) - **Categories:** AI, Lead generation, Jobs - **Stats:** 1 total users, 1 monthly users, 31.3% runs succeeded, 1 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $0.01 / 1,000 results 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 ### Pubrio — B2B Data Intelligence API Pubrio is an Apify Actor that provides comprehensive B2B data intelligence by accessing 51 API endpoints covering company firmographics, people profiles, verified contact details, job postings, news articles, advertisements, and intent signals across global markets. It supports queryable filters (location, industry, department, seniority, technology, revenue, headcount, founding year), pagination, and advanced cross-signal filtering to produce structured records with company metadata, people enrichment, contact reveal (email and phone), signal monitoring with webhook/email delivery, and reference data lookups. Responses are returned as structured JSON records saved to the default dataset and key-value store. ### Use cases - **Lead generation and prospecting** — Search companies by industry, location, technology stack, and headcount, then find decision-makers by title, department, and seniority with verified email and phone reveal - **Account-based marketing (ABM)** — Enrich target accounts with full firmographic data, find lookalike companies, and monitor hiring/news/ad signals for buying intent - **Sales intelligence** — Track job postings, executive movements, funding news, and advertisement campaigns to identify companies actively investing in your category - **Competitive intelligence** — Monitor competitor hiring patterns, ad spend, news coverage, and technology adoption across markets - **Market research** — Analyze company distribution by geography, industry vertical, revenue range, and founding year for market sizing and segmentation - **Automated signal monitoring** — Set up webhook or email monitors to get real-time alerts when target companies post jobs, appear in news, or launch ad campaigns ### How to use 1. Get your API key from [dashboard.pubrio.com](https://dashboard.pubrio.com) 2. Select an **operation** (e.g. `search-companies`, `search-people`, `reveal-contact`) 3. Pass your **parameters** as a JSON object ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `apiKey` | string | Yes | Your Pubrio API key | | `operation` | string | Yes | One of 51 operations (see below) | | `parameters` | object | No | Operation-specific parameters as JSON | ### Input examples #### Search companies in Singapore with 50-200 employees ```json { "apiKey": "your-api-key", "operation": "search-companies", "parameters": { "locations": ["SG"], "keywords": "SaaS", "employees": [50, 200], "page": 1, "per_page": 25 } } ```` #### Find VPs of Engineering at target companies ```json { "apiKey": "your-api-key", "operation": "search-people", "parameters": { "domains": ["stripe.com", "shopify.com"], "management_levels": ["vp", "director"], "departments": ["master_engineering"], "page": 1, "per_page": 25 } } ``` #### Reveal verified email for a contact ```json { "apiKey": "your-api-key", "operation": "reveal-contact", "parameters": { "people_search_id": "uuid-from-search-result", "people_contact_types": ["email-work", "phone"] } } ``` #### Enrich a company by domain ```json { "apiKey": "your-api-key", "operation": "enrich-company", "parameters": { "domain": "hubspot.com" } } ``` #### Search recent job postings ```json { "apiKey": "your-api-key", "operation": "search-jobs", "parameters": { "titles": ["Software Engineer", "Data Scientist"], "locations": ["US", "GB"], "posted_dates": ["2026-01-01", "2026-04-07"], "page": 1, "per_page": 25 } } ``` #### Create a signal monitor with webhook delivery ```json { "apiKey": "your-api-key", "operation": "create-monitor", "parameters": { "name": "Competitor hiring tracker", "detection_mode": "company_first", "signal_types": ["jobs", "news"], "destination_type": "webhook", "webhook_url": "https://your-webhook.com/pubrio", "domains": ["competitor1.com", "competitor2.com"], "frequency_minute": 1440 } } ``` ### All 51 operations #### Company (6) | Operation | Description | |-----------|-------------| | `search-companies` | Search companies by name, domain, location, industry, technology, headcount, revenue, founding year | | `lookup-company` | Look up a company by domain, LinkedIn URL, or ID | | `enrich-company` | Enrich company with full firmographic data (uses credits) | | `linkedin-company-lookup` | Look up a company by LinkedIn URL | | `find-similar-companies` | Find lookalike companies similar to a given company | | `lookup-technology` | Look up technologies used by a company | #### People (7) | Operation | Description | |-----------|-------------| | `search-people` | Search professionals by name, title, department, seniority, location, company | | `lookup-person` | Look up a person by LinkedIn URL or people search ID | | `enrich-person` | Enrich person with full professional details (uses credits) | | `linkedin-person-lookup` | Real-time LinkedIn person lookup by URL | | `reveal-contact` | Reveal verified email or phone for a person (uses credits) | | `batch-redeem-contacts` | Batch reveal contacts for multiple people at once (uses credits) | | `query-batch-redeem` | Check the status and results of a batch contact reveal | #### Signals (7) | Operation | Description | |-----------|-------------| | `search-jobs` | Search job postings by title, location, keyword, company, and date | | `lookup-job` | Look up detailed information about a specific job posting | | `search-news` | Search company news and press releases by category, location, and date | | `lookup-news` | Look up detailed information about a specific news article | | `search-ads` | Search company advertisements by keyword, headline, and target location | | `lookup-advertisement` | Look up detailed information about a specific advertisement | | `lookalike-lookup` | Look up a lookalike company result by ID | #### Filters & Reference Data (14) | Operation | Description | |-----------|-------------| | `get-locations` | Get all available location codes | | `get-departments` | Get all department title codes | | `get-department-functions` | Get all department function codes | | `get-management-levels` | Get all management/seniority level codes | | `get-company-sizes` | Get all company size range codes | | `get-timezones` | Get all timezone codes | | `get-news-categories` | Get all news category codes | | `get-news-galleries` | Get all news gallery codes | | `get-news-languages` | Get all news language codes | | `search-technologies` | Search technology names by keyword | | `search-technology-categories` | Search technology categories by keyword | | `search-verticals` | Search industry verticals by keyword | | `search-vertical-categories` | Search vertical categories by keyword | | `search-vertical-sub-categories` | Search vertical sub-categories by keyword | #### Signal Monitors (14) | Operation | Description | |-----------|-------------| | `create-monitor` | Create a new signal monitor for jobs, news, or advertisements | | `update-monitor` | Update an existing monitor configuration | | `get-monitor` | Get details of a specific monitor | | `list-monitors` | List all monitors with pagination | | `delete-monitor` | Delete a monitor | | `duplicate-monitor` | Duplicate an existing monitor | | `test-run-monitor` | Execute a test run of a monitor | | `retry-monitor` | Retry a failed monitor trigger | | `get-monitor-stats` | Get aggregate statistics across monitors | | `get-monitor-logs` | Get trigger logs for a monitor | | `get-monitor-log-detail` | Get details of a specific log entry | | `get-monitor-chart` | Get daily trigger chart data for a monitor | | `reveal-monitor-signature` | Reveal webhook signature secret for a monitor | | `validate-webhook` | Validate a webhook destination URL | #### Profile (3) | Operation | Description | |-----------|-------------| | `get-profile` | Get account profile information | | `get-usage` | Get credit usage and subscription info | | `get-user` | Get current authenticated user details | ### Output Results are saved to the default dataset (downloadable as JSON, CSV, or Excel) and the key-value store under the `OUTPUT` key. Each run produces structured JSON records matching the Pubrio API response format. ### Pricing This Actor is free to use. API credit consumption is billed through your Pubrio account at [dashboard.pubrio.com](https://dashboard.pubrio.com). Search and filter operations are free; enrichment and contact reveal operations consume credits based on your subscription plan. ### Links - [Pubrio Website](https://pubrio.com) - [API Documentation](https://docs.pubrio.com) - [Get API Key](https://dashboard.pubrio.com) # Actor input Schema ## `apiKey` (type: `string`): Your Pubrio API key from dashboard.pubrio.com ## `operation` (type: `string`): The API operation to execute ## `parameters` (type: `object`): JSON object of parameters for the selected operation. See https://docs.pubrio.com for endpoint-specific parameters. ## Actor input object example ```json {} ``` # 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("pubrio/pubrio-api").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("pubrio/pubrio-api").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 pubrio/pubrio-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=pubrio/pubrio-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pubrio - Business Data Layer for AI", "description": "We build the glocalized business data layer for AI agents and revenue teams.\n\nPubrio provides B2B data intelligence APIs covering company firmographics, people profiles, verified contact details, job postings, news, and advertisement signals across global markets.", "version": "1.0", "x-build-id": "gBsV0rhQ3AgSryzFZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pubrio~pubrio-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pubrio-pubrio-api", "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/pubrio~pubrio-api/runs": { "post": { "operationId": "runs-sync-pubrio-pubrio-api", "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/pubrio~pubrio-api/run-sync": { "post": { "operationId": "run-sync-pubrio-pubrio-api", "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", "required": [ "apiKey", "operation" ], "properties": { "apiKey": { "title": "Pubrio API Key", "type": "string", "description": "Your Pubrio API key from dashboard.pubrio.com" }, "operation": { "title": "Operation", "enum": [ "search-companies", "lookup-company", "enrich-company", "linkedin-company-lookup", "find-similar-companies", "lookup-technology", "search-jobs", "lookup-job", "search-news", "lookup-news", "search-ads", "lookup-advertisement", "lookalike-search", "lookalike-lookup", "search-people", "lookup-person", "enrich-person", "linkedin-person-lookup", "reveal-contact", "batch-redeem-contacts", "query-batch-redeem", "get-locations", "get-departments", "get-department-functions", "get-management-levels", "get-company-sizes", "get-timezones", "get-news-categories", "get-news-galleries", "get-news-languages", "search-technologies", "search-technology-categories", "search-verticals", "search-vertical-categories", "search-vertical-sub-categories", "create-monitor", "update-monitor", "get-monitor", "list-monitors", "delete-monitor", "duplicate-monitor", "test-run-monitor", "retry-monitor", "get-monitor-stats", "get-monitor-logs", "get-monitor-log-detail", "get-monitor-chart", "reveal-monitor-signature", "validate-webhook", "get-profile", "get-usage", "get-user" ], "type": "string", "description": "The API operation to execute" }, "parameters": { "title": "Parameters", "type": "object", "description": "JSON object of parameters for the selected operation. See https://docs.pubrio.com for endpoint-specific parameters." } } }, "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 } } } } } } } } } } ```