# Pubrio

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

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/pubrio

## Actions

### Enrich company

Enrich a company record.

**Inputs**

- Company ID (`domain_search_id`, text): A unique identifier for the company search operation.
- Domain (`domain`, text, required): 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_url`, text): The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/`

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "advertisements": [],
    "data": {},
    "jobs": [],
    "metadata": {},
    "news": [],
    "similar_companies": []
  }
}
```

### Get usage

Get workspace usage statistics.

**Inputs**: None.

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": {}
  }
}
```

### Get workspace profile

Get workspace profile.

**Inputs**: None.

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": {}
  }
}
```

### List company sizes

List company size options.

**Inputs**: None.

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": []
  }
}
```

### List departments

List department titles.

**Inputs**: None.

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": []
  }
}
```

### List industries

List industry verticals.

**Inputs**: None.

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": []
  }
}
```

### List locations

List available locations.

**Inputs**: None.

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": []
  }
}
```

### List management levels

List management levels.

**Inputs**: None.

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": []
  }
}
```

### List technologies

List available technologies.

**Inputs**: None.

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": []
  }
}
```

### List technology categories

List technology categories.

**Inputs**: None.

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": []
  }
}
```

### Lookup company

Look up a company by ID.

**Inputs**

- Company ID (`domain_search_id`, text): A unique identifier for the company search operation.
- Domain (`domain`, text, required): 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_url`, text): The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/`
- Is enrichment available (`is_enrichment_available`, true/false): Run realtime enrichment when the stored record is incomplete. Consumes credits. The response echoes whether it ran in `metadata.is_enrichment_available`.

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": {},
    "metadata": {}
  }
}
```

### Lookup company advertisements

Look up company advertisements.

**Inputs**

- Advertisement search ID (`advertisement_search_id`, text, required): A unique identifier for the advertisement search result. Used to reference specific advertisements returned from the ads search endpoint.

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": {}
  }
}
```

### Lookup company jobs

Look up company job postings.

**Inputs**

- Job search ID (`job_search_id`, text, required): A unique identifier for the company job search operation.

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": {}
  }
}
```

### Lookup company linkedin

Look up a company by LinkedIn URL.

**Inputs**

- Linkedin URL (`linkedin_url`, text, required): The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/`

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": {}
  }
}
```

### Lookup company news

Look up company news.

**Inputs**

- News search ID (`news_search_id`, text, required): A unique identifier for the company news search operation.

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": {}
  }
}
```

### Lookup person

Look up a person by ID.

**Inputs**

- Person ID (`people_search_id`, text, required): A unique identifier for the people search operation.
- Linkedin URL (`linkedin_url`, text): 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_available`, true/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**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": {},
    "metadata": {}
  }
}
```

### Lookup person linkedin

Look up a person by LinkedIn URL.

**Inputs**

- Linkedin URL (`linkedin_url`, text, required): The fully formed URL of the LinkedIn user profile. URL begin with `http` and contain `linkedin.com/in/` or `linkedin.com/pub/`

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": {}
  }
}
```

### Lookup similar companies

Look up similar companies.

**Inputs**

- Company ID (`domain_search_id`, text): A unique identifier for the company search operation.
- Domain (`domain`, text, required): 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_url`, text): The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/`
- Is enrichment available (`is_enrichment_available`, true/false): Run realtime enrichment when the stored record is incomplete. Consumes credits. The response echoes whether it ran in `metadata.is_enrichment_available`.

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": {},
    "metadata": {}
  }
}
```

### Reveal person contacts

Redeem a person's contact details.

**Inputs**

- Person ID (`people_search_id`, text, required): A unique identifier for the people search operation.
- Linkedin URL (`linkedin_url`, text): 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_types`, list, required): 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**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": {
      "peoples": []
    }
  }
}
```

### Search advertisements

Search for company advertisements.

**Inputs**

- Company locations (`company_locations`, list): The location of the company headquarters. Check out `location` endpoints under the Filters tab for more information.
- Domains (`domains`, list): 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_page`, number): 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 (`page`, number): 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**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "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_name`, text): 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 (`domains`, list): 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_filters`, object): 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 (`keywords`, list): A list of keywords to filter companies by relevance, specialties, or descriptions.
- Query (`query`, text): 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_page`, number): 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 (`page`, number): 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**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": {},
    "metadata": {}
  }
}
```

### Search jobs

Search for job postings.

**Inputs**

- Company locations (`company_locations`, list): The location of the company headquarters. Check out `location` endpoints under the Filters tab for more information.
- Domains (`domains`, list): 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_term`, text): A string of words over which we want to filter the results.
- Departments (`departments`, list): 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_page`, number): 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 (`page`, number): 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**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "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_id`, text): A unique identifier for the company search operation.
- Domain (`domain`, text, required): 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_url`, text): The fully formed URL of the LinkedIn company profile. URL begin with `http` and contain `linkedin.com/company/`
- Per page (`per_page`, number): 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 (`page`, number): 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**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": {},
    "metadata": {}
  }
}
```

### Search news

Search for company news.

**Inputs**

- Company locations (`company_locations`, list): The location of the company headquarters. Check out `location` endpoints under the Filters tab for more information.
- Domains (`domains`, list): 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_term`, text): A string of words over which we want to filter the results.
- Per page (`per_page`, number): 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 (`page`, number): 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 (`query`, text): 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**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "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_term`, text): A string of words over which we want to filter the results.
- People name (`people_name`, text): Filter search results to include a specific people name.
- People titles (`people_titles`, list): 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_levels`, list): 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 (`departments`, list): 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_locations`, list): The location where people live. Check out `location` endpoints under the Filters tab for more information.
- Company locations (`company_locations`, list): The location of the company headquarters. Check out `location` endpoints under the Filters tab for more information.
- Domains (`domains`, list): 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_filters`, object): 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_page`, number): 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 (`page`, number): 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 (`query`, text): 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 (`keywords`, list): A list of keywords to filter companies by relevance, specialties, or descriptions.

**Outputs**

- `data` (object): The result returned by Pubrio.

**Example output**

```json
{
  "data": {
    "data": {},
    "metadata": {}
  }
}
```
