# Pubrio Documentation: English Get Started API Documentation

> Pubrio API documentation — market expansion intelligence: detect when companies enter new markets via typed, dated signals across 200+ markets, with company & people enrichment, search, lookup, and real-time monitors. REST API reference, guides, and concept docs.

## API Documentation

### API Documentation

- [Pubrio API Overview](https://docs.pubrio.com/en/api-reference/introduction.md): Complete Pubrio REST API reference — endpoints for company and people enrichment, search, lookup, redeem, real-time monitors, and more.
- [Authentication](https://docs.pubrio.com/en/api-reference/authentication.md): Authenticate Pubrio API requests using the `pubrio-api-key` header — setup, key management, and security best practices.
- [Rate limit](https://docs.pubrio.com/en/api-reference/rate-limits.md): Rate limit to ensure the stability and reliability.
- [Status Codes / Errors](https://docs.pubrio.com/en/api-reference/status-codes.md): Pubrio employs HTTP status / error codes to signify the outcome of your requests.
- [Enums & Constants](https://docs.pubrio.com/en/api-reference/enums.md): Every fixed value the Pubrio API accepts or returns — seniority ranks, job functions, ad sources and formats, reach tiers, signal types, management levels — on one page.
- [Logo API](https://docs.pubrio.com/en/api-reference/logo-api.md): Free, public company logo lookup by domain. Embed company logos in your CRM, dashboards, marketing pages, or sequences with a simple URL — no API key required.

### Endpoint

#### Profile (Workspace)

- [Profile Details](https://docs.pubrio.com/en/api-reference/endpoint/profile/profile.md): Retrieve the current workspace profile details including plan information and settings.
- [Profile Usage](https://docs.pubrio.com/en/api-reference/endpoint/profile/profile-usage.md): Retrieve credit usage and quota statistics for the current workspace profile.
- [User Details](https://docs.pubrio.com/en/api-reference/endpoint/user/user.md): Retrieve details about the currently authenticated user.

#### API Keys

- [List API Request Logs](https://docs.pubrio.com/en/api-reference/endpoint/api-keys/logs.md): Retrieve a paginated list of API request logs for the workspace. Each entry summarizes a single request made with a `pubrio-api-key`, including the path, method, status code, duration, response size, and credit cost. Use the [Look up log details](/api-reference/endpoint/api-keys/logs_lookup) endpoin…
- [Look up API Request Log](https://docs.pubrio.com/en/api-reference/endpoint/api-keys/logs_lookup.md): Retrieve the full request body, request headers, response body, and response size for a specific API request log entry. Use this to inspect what was sent or returned for a given `query_log_id` discovered via the list endpoint.
- [Daily API Usage](https://docs.pubrio.com/en/api-reference/endpoint/api-keys/usage_daily.md): Retrieve a daily breakdown of API requests and credits consumed by the workspace within a date range. The response includes a per-day timeseries and a stacked per-endpoint series suitable for building usage charts.
- [API Usage Breakdown](https://docs.pubrio.com/en/api-reference/endpoint/api-keys/usage_breakdown.md): Retrieve a breakdown of API requests and credits consumed within a date range, grouped both by individual API key (`by_key`) and by endpoint (`by_endpoint`). Useful for identifying the highest-traffic keys and the most credit-intensive endpoints across the workspace.

#### Enrichment

- [Company Lookup Enrichment](https://docs.pubrio.com/en/api-reference/endpoint/companies/enrichment.md): Realtime company enrichment. Returns the company record plus its recent hiring, media, advertising and similar-company signals in one call.

#### Lookalike

- [Lookalike Companies Search](https://docs.pubrio.com/en/api-reference/endpoint/companies/similar.md): **Deprecated.** Use `POST /companies/search/similar` instead. The request body is the same; results are returned in `data.lookalikes` with a `data.pagination` object.
- [Search Similar Companies](https://docs.pubrio.com/en/api-reference/endpoint/companies/search_similar.md): Find companies similar to a reference company. Supply exactly one singular identifier (`domain_search_id`, `domain`, `linkedin_url` or another `*_url`). Each row carries a `similarity_score` between 0 and 1.
- [Search Similar People](https://docs.pubrio.com/en/api-reference/endpoint/people/search_similar.md): Find people similar to a reference person or title. Supply one reference (`people_search_id`, `linkedin_url`, `linkedin_urls`, `peoples` or `people_titles`). Each person carries a `similarity_score` between 0 and 1. The reference only sets what similar means; every other filter narrows the results.

#### Lookup

- [Company Lookup](https://docs.pubrio.com/en/api-reference/endpoint/companies/lookup.md): Retrieve detailed information about a specific company using their Pubrio search ID, domain, or LinkedIn URL.
- [Lookalike Company Lookup (Alias)](https://docs.pubrio.com/en/api-reference/endpoint/companies/similar_lookup.md): Legacy alias of Company Lookup: returns the single company record for a Pubrio search ID, domain, or LinkedIn URL. To find similar companies, use Similar Company Search.
- [Company Job Lookup](https://docs.pubrio.com/en/api-reference/endpoint/companies/job_lookup.md): Retrieve job posting details for a specific company using a job search ID.
- [Company News Lookup](https://docs.pubrio.com/en/api-reference/endpoint/companies/news_lookup.md): Retrieve news article details for a specific company using a news search ID.
- [Company Advertisement Lookup](https://docs.pubrio.com/en/api-reference/endpoint/companies/advertisements_lookup.md): Retrieve advertisement details for a specific company using an advertisement search ID. The response includes the resolved `destination_url`, the original `raw_link_url`, and, for Meta ads, `publisher_platforms`.
- [Company Cloud Footprint Lookup](https://docs.pubrio.com/en/api-reference/endpoint/companies/cloud_footprints_lookup.md): Return a single cloud footprint row by its identifier, with its cloud regions, cities and a recent sample of the infrastructure behind it. See the [Cloud Footprint Search guide](/en/developer-guides/search/cloud-footprint-search).
- [Company Technology Lookup](https://docs.pubrio.com/en/api-reference/endpoint/companies/technology_lookup.md): Retrieve detailed information about a specific technology used by companies.
- [People Lookup](https://docs.pubrio.com/en/api-reference/endpoint/people/lookup.md): Retrieve detailed information about a specific person using their Pubrio search ID or LinkedIn URL.

#### Search

- [Company Search](https://docs.pubrio.com/en/api-reference/endpoint/companies/search.md): Search the Pubrio database for companies matching specified criteria such as industry, size, location, and technologies.
- [Company Job Search](https://docs.pubrio.com/en/api-reference/endpoint/companies/job_search.md): Search job postings. See the [Job Search guide](/en/developer-guides/search/job-search).
- [Company News Search](https://docs.pubrio.com/en/api-reference/endpoint/companies/news_search.md): Search news about companies. See the [News Search guide](/en/developer-guides/search/news-search).
- [Company Advertisement Search](https://docs.pubrio.com/en/api-reference/endpoint/companies/advertisements_search.md): Search advertisements run by companies. See the [Advertisement Search guide](/en/developer-guides/search/advertisement-search).
- [Company Cloud Footprint Search](https://docs.pubrio.com/en/api-reference/endpoint/companies/cloud_footprints_search.md): Search the public cloud and hosting footprint of companies: which providers, countries and regions they run infrastructure in. Each row is one company at one provider in one country. See the [Cloud Footprint Search guide](/en/developer-guides/search/cloud-footprint-search).
- [People Search](https://docs.pubrio.com/en/api-reference/endpoint/people/search.md): Search the Pubrio database for people matching specified criteria such as job title, location, company, and seniority.

#### Insights

- [Company Job Insights](https://docs.pubrio.com/en/api-reference/endpoint/companies/job_insights.md): Aggregated hiring-signal insights for a company over a date window: posting volume, seniority distribution, top functions/departments/locations, and a weekly time series.
- [Company News Insights](https://docs.pubrio.com/en/api-reference/endpoint/companies/news_insights.md): Aggregated news-signal insights for a company over a date window: mention volume, top topics and sources, category and market breakdowns, and a weekly time series.
- [Company Advertisement Insights](https://docs.pubrio.com/en/api-reference/endpoint/companies/advertisements_insights.md): Aggregated advertising-signal insights for a company over a date window: active and launched ad counts, channel and placement mix, creative samples, audience reach as a tier distribution, and a weekly time series. Reach is reported as a distribution across tiers, never as a single summed figure.
- [Company Cloud Footprint Insights](https://docs.pubrio.com/en/api-reference/endpoint/companies/cloud_footprints_insights.md): One company's cloud footprint in a single call: totals, top providers, countries and regions, weekly new hosts, the latest hosts, and flags for changes worth acting on. See the [Cloud Footprint Insights guide](/en/developer-guides/search/cloud-footprint-insights).

#### Expansion

- [Expansion Overview](https://docs.pubrio.com/en/api-reference/endpoint/expansions/dashboard.md): Market-level expansion KPIs — per-market stage counts and top cross-border flows. Aggregated, not paginated. Answers `408` when the request cannot finish in time.
- [Expansion Search](https://docs.pubrio.com/en/api-reference/endpoint/expansions/market_lookup.md): Find companies expanding into one or more markets using firmographic and signal filters or a plain-language query, with optional AI match explanations grounded in each company's real signals. Send at least one of `tos`, `froms`, `companies` or `query`.
- [Company Expansion Detail](https://docs.pubrio.com/en/api-reference/endpoint/expansions/company_lookup.md): In-depth expansion profile for a single company — current stage, signals, market presence, and stage-transition history — for one market or aggregated across all markets.
- [Compare Company Expansions](https://docs.pubrio.com/en/api-reference/endpoint/expansions/company_compare.md): Compare the expansion footprint of several companies side by side, with optional comparable peers for a target company.
- [Batch Company Expansion Summaries](https://docs.pubrio.com/en/api-reference/endpoint/expansions/company_summaries.md): Ready-to-render expansion summaries for a batch of companies, prepared for side-by-side comparison without client-side aggregation.
- [Company Signal Events](https://docs.pubrio.com/en/api-reference/endpoint/expansions/company_pulse_events.md): Enriched, paginated drill-down into the signal events driving a single company's expansion.
- [Expansion Rankings](https://docs.pubrio.com/en/api-reference/endpoint/expansions/company_markers.md): Lightweight ranked list of company/market pairs by expansion score — suited to map or heatmap rendering.
- [Expansion Signal Search](https://docs.pubrio.com/en/api-reference/endpoint/expansions/signal_search.md): Raw, paginated expansion signal rows — the dated evidence behind each company's stage, with source and evidence URL.

#### Redeem

- [Redeem People - Single](https://docs.pubrio.com/en/api-reference/endpoint/redeem/people.md): Spend credits to unlock full contact details (email, phone) for a specific person.
- [Redeem People - Bulk](https://docs.pubrio.com/en/api-reference/endpoint/redeem/people/batch.md): Submit a batch request to unlock contact details for multiple people at once.
- [Redeem People - Bulk Status](https://docs.pubrio.com/en/api-reference/endpoint/redeem/people/batch/query.md): Check the status and results of a previously submitted batch redeem request.
- [Contact Lookup - Single](https://docs.pubrio.com/en/api-reference/endpoint/redeem/people/contact/lookup.md): Reverse-lookup a person by email, phone, or first and last name plus domain or company. Returns the matched person's `people_search_id` and base details, plus `match` metadata describing how the match was made. Charges 1 credit per billable match.
- [Contact Lookup - Bulk](https://docs.pubrio.com/en/api-reference/endpoint/redeem/people/contact/lookup/batch.md): Batch version of `/redeem/people/contact/lookup`. Submit up to your subscription's bulk size limit in a single request. Each entry in `peoples` accepts the same identifiers as the single-lookup body. Charges 1 credit per billable match. Duplicate inputs (the same email, phone, or name + company sent…

#### LinkedIn

- [LinkedIn Company Lookup (Realtime)](https://docs.pubrio.com/en/api-reference/endpoint/companies/linkedin_lookup.md): Retrieve company details using a LinkedIn company page URL. Provides real-time data retrieval.
- [LinkedIn People Lookup (Realtime)](https://docs.pubrio.com/en/api-reference/endpoint/people/linkedin_lookup.md): Retrieve person details using a LinkedIn profile URL. Provides real-time data retrieval.

#### Channels

##### Types

- [Channel Template Type](https://docs.pubrio.com/en/api-reference/endpoint/channels/types/template_types.md): Retrieve available channel types for outreach templates.

##### Templates

- [Channel Templates](https://docs.pubrio.com/en/api-reference/endpoint/channels/templates/templates.md): Retrieve a list of all channel outreach templates in the workspace.
- [Create Channel Template](https://docs.pubrio.com/en/api-reference/endpoint/channels/templates/create.md): Create a new outreach channel template with specified parameters.
- [Create Channel Template Version](https://docs.pubrio.com/en/api-reference/endpoint/channels/templates/create_version.md): Create a new version of an existing channel template.
- [Set Default Channel Template](https://docs.pubrio.com/en/api-reference/endpoint/channels/templates/default.md): Retrieve the default channel template for the workspace.
- [Channel Template Lookup](https://docs.pubrio.com/en/api-reference/endpoint/channels/templates/lookup.md): Retrieve details of a specific channel template by ID.
- [Update Channel Template](https://docs.pubrio.com/en/api-reference/endpoint/channels/templates/update.md): Update an existing channel template's configuration.
- [Delete Channel Template](https://docs.pubrio.com/en/api-reference/endpoint/channels/templates/delete.md): Delete a channel template from the workspace.

#### Monitor

- [Get Monitor List](https://docs.pubrio.com/en/api-reference/endpoint/monitors/monitors.md): Retrieve a list of all monitors in the workspace.
- [Create Monitor](https://docs.pubrio.com/en/api-reference/endpoint/monitors/create.md): Create a data monitor: an always-on watch that continuously surfaces the business signals you care about — new job postings, news, advertisements, or market-expansion moves — from the companies and filters you define, enriches each match with company and contact data, and delivers it to your destina…
- [Interpret Monitor](https://docs.pubrio.com/en/api-reference/endpoint/monitors/interpret.md): Preview a monitor before you build it — turn a plain-language request (in any language) into a validated **draft** configuration you can inspect, adjust, and then submit to [Create Monitor](/en/api-reference/endpoint/monitors/create). It's safe to call as often as you need: it only drafts, and never…
- [Update Monitor](https://docs.pubrio.com/en/api-reference/endpoint/monitors/update.md): Update an existing monitor's configuration and detection rules.
- [Duplicate Monitor](https://docs.pubrio.com/en/api-reference/endpoint/monitors/duplicate.md): Create a copy of an existing monitor with the same configuration.
- [Delete Monitor](https://docs.pubrio.com/en/api-reference/endpoint/monitors/delete.md): Delete a monitor from the workspace.
- [Monitor Lookup](https://docs.pubrio.com/en/api-reference/endpoint/monitors/lookup.md): Retrieve detailed information about a specific monitor.
- [Monitor Signature Reveal](https://docs.pubrio.com/en/api-reference/endpoint/monitors/signature_reveal.md): Retrieve the webhook signing secret for a monitor.
- [Monitor Validate Webhook](https://docs.pubrio.com/en/api-reference/endpoint/monitors/webhook_validate.md): Send a signed test payload to a webhook URL and report whether it was accepted.

##### Statistics

- [Monitor Statistics](https://docs.pubrio.com/en/api-reference/endpoint/monitors/statistics.md): Retrieve a workspace-wide overview of monitor trigger statistics. There is no monitor_id parameter — figures are aggregated across all monitors in the workspace (watchlist-backed monitors are excluded).
- [Monitor Statistic Logs](https://docs.pubrio.com/en/api-reference/endpoint/monitors/statistics_logs.md): Retrieve a paginated list of detection logs for a specific monitor.
- [Monitor Statistic Log Lookup](https://docs.pubrio.com/en/api-reference/endpoint/monitors/statistics_logs_lookup.md): Retrieve details of a specific monitor detection log entry.
- [Monitor Statistics Chart](https://docs.pubrio.com/en/api-reference/endpoint/monitors/statistics_chart.md): Retrieve chart-ready time-series statistics data for a monitor.

##### Process

- [Monitor Process Try](https://docs.pubrio.com/en/api-reference/endpoint/monitors/process_try.md): Run a saved monitor by id, or run an unsaved ad-hoc configuration by passing the config inline; with monitor_id, inline fields override the saved monitor for this run.
- [Monitor Process Retry](https://docs.pubrio.com/en/api-reference/endpoint/monitors/process_retry.md): Retry a failed monitor processing run.

#### Filters

- [Technologies](https://docs.pubrio.com/en/api-reference/endpoint/technologies/technologies.md): Retrieve the list of technologies available for search filters.
- [Technology Categories](https://docs.pubrio.com/en/api-reference/endpoint/technologies/categories.md): Retrieve the list of technology categories for filtering.
- [Locations](https://docs.pubrio.com/en/api-reference/endpoint/locations/locations.md): Retrieve the list of locations available for search filters.
- [Company Size](https://docs.pubrio.com/en/api-reference/endpoint/company-size/company-size.md): Retrieve the list of company size categories for filtering.
- [Management Levels](https://docs.pubrio.com/en/api-reference/endpoint/management-levels/management-levels.md): Retrieve the list of management and seniority levels for filtering.
- [Departments](https://docs.pubrio.com/en/api-reference/endpoint/departments/departments.md): Retrieve the list of department titles for filtering.
- [Department Function](https://docs.pubrio.com/en/api-reference/endpoint/departments/function.md): Retrieve the list of department functions for filtering.
- [Verticals](https://docs.pubrio.com/en/api-reference/endpoint/verticals/verticals.md): Retrieve the list of industry verticals for filtering.
- [Vertical Categories](https://docs.pubrio.com/en/api-reference/endpoint/verticals/vertical_categories.md): Retrieve the list of vertical categories for filtering.
- [Vertical Sub-Categories](https://docs.pubrio.com/en/api-reference/endpoint/verticals/vertical_sub_categories.md): Retrieve the list of vertical sub-categories for filtering.
- [News Categories](https://docs.pubrio.com/en/api-reference/endpoint/news/categories.md): Retrieve the list of news article categories for filtering.
- [News Galleries](https://docs.pubrio.com/en/api-reference/endpoint/news/galleries.md): Retrieve the list of news galleries for filtering.
- [News Languages](https://docs.pubrio.com/en/api-reference/endpoint/news/languages.md): Retrieve the list of available languages for news filtering.
- [Expansion Filters](https://docs.pubrio.com/en/api-reference/endpoint/expansions/types.md): Reference catalog for the expansion taxonomy — stages, signal types, strengths, polarities, momentum, and freshness — used to resolve the values returned by the other expansion endpoints.

#### Miscellaneous

- [Timezones](https://docs.pubrio.com/en/api-reference/endpoint/timezones/timezones.md): Retrieve the list of supported timezones.

## OpenAPI Specs

- [en-openapi](/en/api-reference/en-openapi.json)