Skip to main content
POST
Buscar vagas de emprego

Autorizações

pubrio-api-key
string
header
obrigatório

Um token de API exclusivo que representa as ações que você realiza por meio da API e as permissões e operações correspondentes. Você pode criá-lo na seção Configurações.

Corpo

application/json
locations
string[]

O padrão ISO 3166-1 alpha-2 (cca2) é usado para filtrar localizações. Consulte os endpoints location na aba Filters para mais informações.

Exemplo:
exclude_locations
string[]

Códigos de localização ISO 3166-1 alpha-2 (cca2) a serem excluídos dos resultados de vagas. Consulte os endpoints de location na aba Filters para ver os códigos válidos.

Exemplo:
location_ids
integer[]

País da vaga pelo location_id da Pubrio (endpoint Locations; também presente em cada linha). Alternativa a locations.

Exemplo:
company_locations
string[]

A localização da sede da empresa. Consulte os endpoints de location na aba Filters para mais informações.

Exemplo:
companies
string<uuid>[]

Uma lista de identificadores únicos (domain_search_id) usada para operações de busca de empresas e pessoas.

domains
string[]

Lista de domínios de empresas usada para operações de busca de empresas e pessoas. Se recebermos uma URL como www.pubrio.com ou https://docs.pubrio.com/, o sistema a converterá para pubrio.com para processamento.

Exemplo:
linkedin_urls
string[]

A URL completa do perfil da empresa no LinkedIn. A URL começa com http e contém linkedin.com/company/

Exemplo:
search_term
string

Uma string de palavras pela qual queremos filtrar os resultados.

Exemplo:

"pubrio"

search_terms
string[]

Array de strings de palavras-chave para filtrar vagas de emprego. Cada termo é comparado com o conteúdo da vaga. Use search_term para uma única string ou search_terms para várias palavras-chave.

Exemplo:
titles
string[]

Cargos associados aos indivíduos que você deseja localizar.

Os resultados também incluirão cargos que contenham terminologia semelhante, mesmo que não correspondam exatamente. Por exemplo, buscar por software engineer pode retornar resultados de indivíduos com o cargo senior software engineer.

Exemplo:
functions
string[]

Slugs de função derivados do cargo, por exemplo engineering, sales, marketing, finance, product_management — os mesmos valores retornados pelas linhas em functions. Slugs desconhecidos não correspondem a nada. Lista completa: Enums & Constants.

Exemplo:
seniority_ranks
enum<integer>[]

Nível de senioridade extraído do cargo: 1 júnior, 2 sênior, 3 gerente, 4 diretor, 5 executivo. Valores fora do intervalo 1–5 são ignorados e o filtro é descartado. As linhas retornam seu nível em seniority_rank (0 = não classificado).

Opções disponíveis:
1,
2,
3,
4,
5
Exemplo:
posted_dates
string[]

Intervalo de datas de publicação. O valor máximo é o dia atual. Os limites do dia seguem o fuso horário do seu workspace.

Exemplo:
launch_dates
string<date>[]

Janela inclusiva [from, to] (UTC) sobre a data de lançamento: posting_date, ou o dia de ingestão quando ausente. Corresponde à forma como o Job Insights contabiliza. Uma única data corresponde a esse dia.

Required array length: 1 - 2 elements
Exemplo:
created_at
string<date-time>

Ingerido neste instante ou depois (UTC). Data ou timestamp ISO. Para sincronizações incrementais, informe o created_at do seu registro armazenado mais recente.

Exemplo:

"2026-09-02T12:00:00Z"

is_realtime_enrichment
boolean
padrão:false

Ativa o enriquecimento em tempo real para uma única consulta com escopo de empresa (filtrada por domain_search_id, domains ou linkedin_urls). Quando a busca inicial retorna zero resultados, o endpoint extrai a fonte, persiste os registros e executa a busca novamente antes de responder. Sujeito a um prazo limite por rota.

Exemplo:

true

is_ascending_order
boolean
padrão:false

Direção da ordenação. Por padrão, os resultados são retornados do mais recente para o mais antigo; defina true para do mais antigo para o mais recente. Não há sort_by neste endpoint — a chave de ordenação é fixa e está indicada na descrição do endpoint.

Exemplo:

false

per_page
integer
padrão:25

Registros por página. O padrão é 25, que também é o teto na maioria dos planos — o limite é o max_search_per_page da sua assinatura, retornado por Profile. Excedê-lo retorna HTTP 416 com o código 41676 (ou 41613 na busca de empresas e pessoas), não um conjunto de resultados limitado.

Intervalo necessário: x <= 25
Exemplo:

25

page
integer
padrão:1

Número da página, começando em 1. O teto é o max_search_page da sua assinatura (max_company_search_page para busca de empresas), retornado por Profile. Excedê-lo retorna HTTP 416.

Exemplo:

1

Resposta

Resposta bem-sucedida contendo os detalhes da busca de vagas de empresas.

metadata
object

Contexto da requisição.

data
object
Última modificação em 4 de setembro de 2026