Pubrio

App · 25 actions

Search and enrich companies and people, research jobs, news and advertisements, reveal contact details, and check account usage.

Actions

ActionWhat it does
Enrich companyEnrich a company record.
Get usageGet workspace usage statistics.
Get workspace profileGet workspace profile.
List company sizesList company size options.
List departmentsList department titles.
List industriesList industry verticals.
List locationsList available locations.
List management levelsList management levels.
List technologiesList available technologies.
List technology categoriesList technology categories.
Lookup companyLook up a company by ID.
Lookup company advertisementsLook up company advertisements.
Lookup company jobsLook up company job postings.
Lookup company linkedinLook up a company by LinkedIn URL.
Lookup company newsLook up company news.
Lookup personLook up a person by ID.
Lookup person linkedinLook up a person by LinkedIn URL.
Lookup similar companiesLook up similar companies.
Reveal person contactsRedeem a person's contact details.
Search advertisementsSearch for company advertisements.
Search companiesSearch for companies.
Search jobsSearch for job postings.
Search lookalike companiesSearch for lookalike companies.
Search newsSearch for company news.
Search peopleSearch for people.

Enrich company

Enrich a company record.

Inputs

Company IDdomain_search_idtext
A unique identifier for the company search operation.
DomaindomaintextRequired
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 URLlinkedin_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 IDdomain_search_idtext
A unique identifier for the company search operation.
DomaindomaintextRequired
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 URLlinkedin_urltext
The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/`
Is enrichment availableis_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 IDadvertisement_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 IDjob_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 URLlinkedin_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 IDnews_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 IDpeople_search_idtextRequired
A unique identifier for the people search operation.
Linkedin URLlinkedin_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 availableis_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 URLlinkedin_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 IDdomain_search_idtext
A unique identifier for the company search operation.
DomaindomaintextRequired
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 URLlinkedin_urltext
The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/`
Is enrichment availableis_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 IDpeople_search_idtextRequired
A unique identifier for the people search operation.
Linkedin URLlinkedin_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 typespeople_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 locationscompany_locationslist
The location of the company headquarters. Check out `location` endpoints under the Filters tab for more information.
Domainsdomainslist
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 pageper_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.
Pagepagenumber
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 namecompany_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.
Domainsdomainslist
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 filterscompany_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
Keywordskeywordslist
A list of keywords to filter companies by relevance, specialties, or descriptions.
Queryquerytext
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 pageper_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.
Pagepagenumber
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 locationscompany_locationslist
The location of the company headquarters. Check out `location` endpoints under the Filters tab for more information.
Domainsdomainslist
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 termsearch_termtext
A string of words over which we want to filter the results.
Departmentsdepartmentslist
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 pageper_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.
Pagepagenumber
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 IDdomain_search_idtext
A unique identifier for the company search operation.
DomaindomaintextRequired
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 URLlinkedin_urltext
The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/`
Per pageper_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.
Pagepagenumber
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 locationscompany_locationslist
The location of the company headquarters. Check out `location` endpoints under the Filters tab for more information.
Domainsdomainslist
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 termsearch_termtext
A string of words over which we want to filter the results.
Per pageper_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.
Pagepagenumber
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.
Queryquerytext
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 termsearch_termtext
A string of words over which we want to filter the results.
People namepeople_nametext
Filter search results to include a specific people name.
People titlespeople_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 levelsmanagement_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.
Departmentsdepartmentslist
The department field can search for people in specific areas of expertise. Check out `department` endpoints under the Filters tab for more information.
People locationspeople_locationslist
The location where people live. Check out `location` endpoints under the Filters tab for more information.
Company locationscompany_locationslist
The location of the company headquarters. Check out `location` endpoints under the Filters tab for more information.
Domainsdomainslist
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 filterscompany_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 pageper_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.
Pagepagenumber
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.
Queryquerytext
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.
Keywordskeywordslist
A list of keywords to filter companies by relevance, specialties, or descriptions.

Outputs

dataobject
The result returned by Pubrio.
Example output
{
  "data": {
    "data": {},
    "metadata": {}
  }
}

On this page