Pubrio
App · 25 actions
Search and enrich companies and people, research jobs, news and advertisements, reveal contact details, and check account usage.
Actions
| Action | What it does |
|---|---|
| Enrich company | Enrich a company record. |
| Get usage | Get workspace usage statistics. |
| Get workspace profile | Get workspace profile. |
| List company sizes | List company size options. |
| List departments | List department titles. |
| List industries | List industry verticals. |
| List locations | List available locations. |
| List management levels | List management levels. |
| List technologies | List available technologies. |
| List technology categories | List technology categories. |
| Lookup company | Look up a company by ID. |
| Lookup company advertisements | Look up company advertisements. |
| Lookup company jobs | Look up company job postings. |
| Lookup company linkedin | Look up a company by LinkedIn URL. |
| Lookup company news | Look up company news. |
| Lookup person | Look up a person by ID. |
| Lookup person linkedin | Look up a person by LinkedIn URL. |
| Lookup similar companies | Look up similar companies. |
| Reveal person contacts | Redeem a person's contact details. |
| Search advertisements | Search for company advertisements. |
| Search companies | Search for companies. |
| Search jobs | Search for job postings. |
| Search lookalike companies | Search for lookalike companies. |
| Search news | Search for company news. |
| Search people | Search for people. |
Enrich company
Enrich a company record.
Inputs
- Company ID
domain_search_idtext - A unique identifier for the company search operation.
- Domain
domaintextRequired - A company domain used for company search operations. If we receive a URL such as `www.pubrio.com` or `https://docs.pubrio.com/`, the system will convert it to `pubrio.com` for processing.
- Linkedin URL
linkedin_urltext - The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/`
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"advertisements": [],
"data": {},
"jobs": [],
"metadata": {},
"news": [],
"similar_companies": []
}
}Get usage
Get workspace usage statistics.
Inputs
None.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": {}
}
}Get workspace profile
Get workspace profile.
Inputs
None.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": {}
}
}List company sizes
List company size options.
Inputs
None.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": []
}
}List departments
List department titles.
Inputs
None.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": []
}
}List industries
List industry verticals.
Inputs
None.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": []
}
}List locations
List available locations.
Inputs
None.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": []
}
}List management levels
List management levels.
Inputs
None.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": []
}
}List technologies
List available technologies.
Inputs
None.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": []
}
}List technology categories
List technology categories.
Inputs
None.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": []
}
}Lookup company
Look up a company by ID.
Inputs
- Company ID
domain_search_idtext - A unique identifier for the company search operation.
- Domain
domaintextRequired - A company domain used for company search operations. If we receive a URL such as `www.pubrio.com` or `https://docs.pubrio.com/`, the system will convert it to `pubrio.com` for processing.
- Linkedin URL
linkedin_urltext - The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/`
- Is enrichment available
is_enrichment_availabletrue/false - Run realtime enrichment when the stored record is incomplete. Consumes credits. The response echoes whether it ran in `metadata.is_enrichment_available`.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": {},
"metadata": {}
}
}Lookup company advertisements
Look up company advertisements.
Inputs
- Advertisement search ID
advertisement_search_idtextRequired - A unique identifier for the advertisement search result. Used to reference specific advertisements returned from the ads search endpoint.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": {}
}
}Lookup company jobs
Look up company job postings.
Inputs
- Job search ID
job_search_idtextRequired - A unique identifier for the company job search operation.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": {}
}
}Lookup company linkedin
Look up a company by LinkedIn URL.
Inputs
- Linkedin URL
linkedin_urltextRequired - The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/`
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": {}
}
}Lookup company news
Look up company news.
Inputs
- News search ID
news_search_idtextRequired - A unique identifier for the company news search operation.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": {}
}
}Lookup person
Look up a person by ID.
Inputs
- Person ID
people_search_idtextRequired - A unique identifier for the people search operation.
- Linkedin URL
linkedin_urltext - The fully formed URL of the LinkedIn user profile. URL begin with `http` and contain `linkedin.com/in/` or `linkedin.com/pub/`
- Is enrichment available
is_enrichment_availabletrue/false - Run realtime enrichment when the stored record is incomplete. fills in contact details, employment history and social profiles. Consumes credits. Leave unset for a cache-only read.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": {},
"metadata": {}
}
}Lookup person linkedin
Look up a person by LinkedIn URL.
Inputs
- Linkedin URL
linkedin_urltextRequired - The fully formed URL of the LinkedIn user profile. URL begin with `http` and contain `linkedin.com/in/` or `linkedin.com/pub/`
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": {}
}
}Lookup similar companies
Look up similar companies.
Inputs
- Company ID
domain_search_idtext - A unique identifier for the company search operation.
- Domain
domaintextRequired - A company domain used for company search operations. If we receive a URL such as `www.pubrio.com` or `https://docs.pubrio.com/`, the system will convert it to `pubrio.com` for processing.
- Linkedin URL
linkedin_urltext - The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/`
- Is enrichment available
is_enrichment_availabletrue/false - Run realtime enrichment when the stored record is incomplete. Consumes credits. The response echoes whether it ran in `metadata.is_enrichment_available`.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": {},
"metadata": {}
}
}Reveal person contacts
Redeem a person's contact details.
Inputs
- Person ID
people_search_idtextRequired - A unique identifier for the people search operation.
- Linkedin URL
linkedin_urltext - The fully formed URL of the LinkedIn user profile. URL begin with `http` and contain `linkedin.com/in/` or `linkedin.com/pub/`
- People contact types
people_contact_typeslistRequired - Which contact details to redeem. Use exactly `email-work`, `email-personal` and/or `phone`. resolve the live list from the `people contact type` endpoint under the Filters tab. **Unrecognised values are not rejected.** A misspelling such as `work_email` returns HTTP 200 with `emails: null`, `phones: null` and `total_credit_cost: 0`. identical to a person genuinely having no contact data. If redemptions look universally empty, check these slugs first.One or more of:
email-work,email-personal,phone.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": {
"peoples": []
}
}
}Search advertisements
Search for company advertisements.
Inputs
- Company locations
company_locationslist - The location of the company headquarters. Check out `location` endpoints under the Filters tab for more information.
- Domains
domainslist - List of company domains used for company and people search operations. If we receive a URL such as `www.pubrio.com` or `https://docs.pubrio.com/`, the system will convert it to `pubrio.com` for processing.
- Per page
per_pagenumber - Records per page. Defaults to 25, which is also the ceiling on most plans. the limit is your subscription's `max_search_per_page`, returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416** with code `41676` (or `41613` on company and people search), not a clamped result set.From 1 to 25. Default:
25. - Page
pagenumber - Page number, starting at 1. The ceiling is your subscription's `max_search_page` (`max_company_search_page` for company search), returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416**.At least 1. Default:
1.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": {
"advertisements": [],
"pagination": {
"is_estimated": false,
"is_timeout": false,
"page": 1,
"per_page": 1,
"total_display_pages": 1,
"total_entries": 1,
"total_pages": 1
}
},
"metadata": {
"applied_source_types": [],
"coverage_notes": [],
"skipped_source_types": [],
"unsupported_source_types": []
}
}
}Search companies
Search for companies.
Inputs
- Company name
company_nametext - Filter search results to include a specific company name. If the value you enter for this parameter does not match with a company's name, the company will not appear in search results, even if it matches other parameters. Partial matches are accepted.
- Domains
domainslist - List of company domains used for company and people search operations. If we receive a URL such as `www.pubrio.com` or `https://docs.pubrio.com/`, the system will convert it to `pubrio.com` for processing.
- Company filters
company_filtersobject - Wrapper object for company-level filters. Recommended grouping that visually separates which keys filter the *person* (top-level) from which filter the *company*. Accepts the same keys as the top-level company filters (e.g. `technologies`, `verticals`, `vertical_categories`, `vertical_sub_categories`, `categories`, `keywords`, `founded_dates`, `employees`, `revenues`, `company_locations`, `company_exclude_locations`, `company_places`, `company_exclude_places`, `companies`, `domains`, `company_li
- Keywords
keywordslist - A list of keywords to filter companies by relevance, specialties, or descriptions.
- Query
querytext - Natural-language search. When provided, Pubrio interprets it into the company filters below: industry (and industries to leave out), specialty, technology (and tools to leave out), social profiles, HQ country, region or city, head-count, revenue, founded year, roles being hired and where, news events such as "recently expanded", advertising (platform, format, target country, ad counts, impressions, dates, rank in one country) and cloud hosting (provider, server countries and cities, host and ser
- Per page
per_pagenumber - Records per page. Defaults to 25, which is also the ceiling on most plans. the limit is your subscription's `max_search_per_page`, returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416** with code `41676` (or `41613` on company and people search), not a clamped result set.From 1 to 25. Default:
25. - Page
pagenumber - Page number, starting at 1. The ceiling is your subscription's `max_search_page` (`max_company_search_page` for company search), returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416**.At least 1. Default:
1.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": {},
"metadata": {}
}
}Search jobs
Search for job postings.
Inputs
- Company locations
company_locationslist - The location of the company headquarters. Check out `location` endpoints under the Filters tab for more information.
- Domains
domainslist - List of company domains used for company and people search operations. If we receive a URL such as `www.pubrio.com` or `https://docs.pubrio.com/`, the system will convert it to `pubrio.com` for processing.
- Search term
search_termtext - A string of words over which we want to filter the results.
- Departments
departmentslist - Department slugs or names, e.g. `master_sales` or `Sales` (any case), from [Departments](/en/api-reference/endpoint/departments/departments). Matches jobs whose title carries any of them; a value the catalog does not name matches nothing.
- Per page
per_pagenumber - Records per page. Defaults to 25, which is also the ceiling on most plans. the limit is your subscription's `max_search_per_page`, returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416** with code `41676` (or `41613` on company and people search), not a clamped result set.From 1 to 25. Default:
25. - Page
pagenumber - Page number, starting at 1. The ceiling is your subscription's `max_search_page` (`max_company_search_page` for company search), returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416**.At least 1. Default:
1.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": {
"jobs": [],
"pagination": {
"is_estimated": false,
"is_timeout": false,
"page": 1,
"per_page": 1,
"total_display_pages": 1,
"total_entries": 1,
"total_pages": 1
}
},
"metadata": {
"filters": {},
"ignored_fields": [],
"profile": {}
}
}
}Search lookalike companies
Search for lookalike companies.
Inputs
- Company ID
domain_search_idtext - A unique identifier for the company search operation.
- Domain
domaintextRequired - A company domain used for company search operations. If we receive a URL such as `www.pubrio.com` or `https://docs.pubrio.com/`, the system will convert it to `pubrio.com` for processing.
- Linkedin URL
linkedin_urltext - The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/`
- Per page
per_pagenumber - Records per page. Defaults to 25, which is also the ceiling on most plans. the limit is your subscription's `max_search_per_page`, returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416** with code `41676` (or `41613` on company and people search), not a clamped result set.From 1 to 25. Default:
25. - Page
pagenumber - Page number, starting at 1. The ceiling is your subscription's `max_search_page` (`max_company_search_page` for company search), returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416**.At least 1. Default:
1.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": {},
"metadata": {}
}
}Search news
Search for company news.
Inputs
- Company locations
company_locationslist - The location of the company headquarters. Check out `location` endpoints under the Filters tab for more information.
- Domains
domainslist - List of company domains used for company and people search operations. If we receive a URL such as `www.pubrio.com` or `https://docs.pubrio.com/`, the system will convert it to `pubrio.com` for processing.
- Search term
search_termtext - A string of words over which we want to filter the results.
- Per page
per_pagenumber - Records per page. Defaults to 25, which is also the ceiling on most plans. the limit is your subscription's `max_search_per_page`, returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416** with code `41676` (or `41613` on company and people search), not a clamped result set.From 1 to 25. Default:
25. - Page
pagenumber - Page number, starting at 1. The ceiling is your subscription's `max_search_page` (`max_company_search_page` for company search), returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416**.At least 1. Default:
1. - Query
querytext - A plain-English request. It is turned into filters (`company_names`, `company_roles`, `categories`, `search_terms`, `locations`, `published_dates`, …), which are combined with any filters you send and returned in `metadata.filters` so you can check them.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": {
"news": [],
"pagination": {
"is_estimated": false,
"is_timeout": false,
"page": 1,
"per_page": 1,
"total_display_pages": 1,
"total_entries": 1,
"total_pages": 1
}
},
"metadata": {
"filters": {},
"ignored_fields": [],
"profile": {}
}
}
}Search people
Search for people.
Inputs
- Search term
search_termtext - A string of words over which we want to filter the results.
- People name
people_nametext - Filter search results to include a specific people name.
- People titles
people_titleslist - Job titles associated with the individuals you aim to locate. The results will also encompass job titles that include similar terminology, even if they do not match exactly. For instance, searching for `software engineer` may yield results for individuals with the title `senior software engineer`.
- Management levels
management_levelslist - Reporting tier of the person. The C-suite slug is `c_suite`, not `c_level`. An unknown slug matches nobody. Full list from the `management level` endpoint under Filters.One or more of:
c_suite(C suite),director,entry,founder,head,intern,manager,owner,partner,senior,vp. - Departments
departmentslist - The department field can search for people in specific areas of expertise. Check out `department` endpoints under the Filters tab for more information.
- People locations
people_locationslist - The location where people live. Check out `location` endpoints under the Filters tab for more information.
- Company locations
company_locationslist - The location of the company headquarters. Check out `location` endpoints under the Filters tab for more information.
- Domains
domainslist - List of company domains used for company and people search operations. If we receive a URL such as `www.pubrio.com` or `https://docs.pubrio.com/`, the system will convert it to `pubrio.com` for processing.
- Company filters
company_filtersobject - Wrapper object for company-level filters. Recommended grouping that visually separates which keys filter the *person* (top-level) from which filter the *company*. Accepts the same keys as the top-level company filters (e.g. `technologies`, `verticals`, `vertical_categories`, `vertical_sub_categories`, `categories`, `keywords`, `founded_dates`, `employees`, `revenues`, `company_locations`, `company_exclude_locations`, `company_places`, `company_exclude_places`, `companies`, `domains`, `company_li
- Per page
per_pagenumber - Records per page. Defaults to 25, which is also the ceiling on most plans. the limit is your subscription's `max_search_per_page`, returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416** with code `41676` (or `41613` on company and people search), not a clamped result set.From 1 to 25. Default:
25. - Page
pagenumber - Page number, starting at 1. The ceiling is your subscription's `max_search_page` (`max_company_search_page` for company search), returned by [Profile](/en/api-reference/endpoint/profile/profile). Exceeding it returns **HTTP 416**.At least 1. Default:
1. - Query
querytext - Natural-language search. When provided, Pubrio interprets it into the person and company filters below (job role, seniority, department, location, industry, company size, and more). Any explicit filters you also pass take precedence over the interpreted ones. Leave empty to search purely by the structured filters.
- Keywords
keywordslist - A list of keywords to filter companies by relevance, specialties, or descriptions.
Outputs
dataobject- The result returned by Pubrio.
Example output
{
"data": {
"data": {},
"metadata": {}
}
}