// docs

Glassdoor PDP

Extrai detalhes completos de vaga (PDP) do Glassdoor, com fallback para JSON-LD quando necessário.

Nota importante: alguns campos podem retornar null em produção, dependendo da página de origem. Nesta documentação, os exemplos de output são preenchidos intencionalmente com valores não nulos para facilitar integração.

Chamada HTTP

cURL

curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://www.glassdoor.com.br/job-listing/desenvolvedor-full-stack-j%C3%BAnior-comerc-energia-JV_IC2479061_KO0,31_KE32,46.htm?jl=1009999255417",
  "target": "glassdoor.com.br",
  "type": "pdp"
}'

Chamada MCP

A mesma seam também aparece no MCP hospedado como uma tool dedicada. Os argumentos reaproveitam os campos do extract, mas target e type já ficam fixos pela tool.

Ver guia completo do MCP

Endpoint

POST /v1/mcp

Tool name

glassdoor_com_br_pdp

Auth

Bearer ou X-API-Key

glassdoor_com_br_pdp tools/call

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "glassdoor_com_br_pdp",
    "arguments": {
      "url": "https://www.glassdoor.com.br/job-listing/desenvolvedor-full-stack-j%C3%BAnior-comerc-energia-JV_IC2479061_KO0,31_KE32,46.htm?jl=1009999255417",
      "executionId": "exec_example_123"
    }
  }
}

Possibilidades de input

Campos suportados nesta API do POST /v1/extract, com regras específicas de obrigatoriedade e condicionais.

Campo	Tipo	Status	Regra	Default	Exemplo
url URL alvo da extração. Para alguns PLPs pode ser omitida quando a API monta a URL a partir de outros campos.	string (URL)	Obrigatório	Obrigatorio para este seam.	-	https://www.mercadolivre.com.br/p/MLB123456
target Fonte alvo da extração.	enum	Obrigatório	Sempre obrigatorio no payload e deve combinar com o seam.	-	mercadolivre.com.br
type Tipo da extração: pdp, idp, plp, review ou places.	enum	Obrigatório	Sempre obrigatorio no payload e deve combinar com o seam.	-	pdp

Exemplos de request

PDP por URL da vaga

Consulta de vaga individual no Glassdoor.

PDP por URL da vaga

{
  "url": "https://www.glassdoor.com.br/job-listing/desenvolvedor-full-stack-j%C3%BAnior-comerc-energia-JV_IC2479061_KO0,31_KE32,46.htm?jl=1009999255417",
  "target": "glassdoor.com.br",
  "type": "pdp"
}

Schema de response (leaf paths)

Mapa de paths de saída com tipo esperado para esta API.

responseSchema

{
  "requestId": "string (uuid)",
  "executionId": "string (uuid)",
  "data.source": "string",
  "data.type": "string",
  "data.parser": "string",
  "data.url": "string",
  "data.requestUrl": "string",
  "data.extractedAt": "string (iso datetime)",
  "data.data.listingId": "number",
  "data.data.title": "string",
  "data.data.normalizedJobTitle": "string",
  "data.data.locationName": "string",
  "data.data.locationType": "string",
  "data.data.jobLocationType": "string",
  "data.data.ageInDays": "number",
  "data.data.easyApply": "boolean",
  "data.data.sponsoredJob": "boolean",
  "data.data.sponsoredEmployer": "boolean",
  "data.data.datePublished": "string",
  "data.data.validThrough": "string",
  "data.data.description": "string",
  "data.data.employmentType": "string",
  "data.data.industry": "string",
  "data.data.directApply": "boolean",
  "data.data.payCurrency": "string",
  "data.data.payPeriod": "string",
  "data.data.salarySource": "string",
  "data.data.salaryRange.p10": "number",
  "data.data.salaryRange.p50": "number",
  "data.data.salaryRange.p90": "number",
  "data.data.applyUrl": "string",
  "data.data.jobLink": "string",
  "data.data.seoUrl": "string",
  "data.data.employer.id": "number",
  "data.data.employer.name": "string",
  "data.data.employer.shortName": "string",
  "data.data.employer.rating": "number",
  "data.data.employer.reviewCount": "number",
  "data.data.employer.logoUrl": "string",
  "data.data.benefits[]": "string",
  "data.data.applicantLocationRequirements[]": "string",
  "data.data.rawLocation.id": "number",
  "data.data.rawLocation.name": "string",
  "data.data.rawLocation.type": "string",
  "data.data.companyRatings.overallRating": "number",
  "data.data.companyRatings.workLifeBalanceRating": "number",
  "data.data.companyRatings.compensationAndBenefitsRating": "number",
  "data.data.companyRatings.careerOpportunitiesRating": "number",
  "data.data.companyRatings.cultureAndValuesRating": "number",
  "data.data.companyRatings.seniorManagementRating": "number"
}

Exemplo de response

responseExample

{
  "requestId": "3ec4f41a-a71d-4f3e-bf8f-a08a39f011a6",
  "executionId": "f6e5010a-e45e-40a8-8aa2-422ebae09cab",
  "data": {
    "source": "glassdoor.com.br",
    "type": "jdp",
    "parser": "next_flight",
    "url": "https://www.glassdoor.com.br/job-listing/desenvolvedor-full-stack-j%C3%BAnior-comerc-energia-JV_IC2479061_KO0,31_KE32,46.htm?jl=1009999255417",
    "requestUrl": "https://www.glassdoor.com.br/partner/jobListing.htm?jobListingId=1009999255417",
    "extractedAt": "2026-02-28T20:15:00.000Z",
    "data": {
      "listingId": 1009999255417,
      "title": "Desenvolvedor Full Stack Júnior",
      "normalizedJobTitle": "Desenvolvedor Full Stack",
      "locationName": "Trabalho remoto",
      "locationType": "S",
      "jobLocationType": "TELECOMMUTE",
      "ageInDays": 9,
      "easyApply": true,
      "sponsoredJob": false,
      "sponsoredEmployer": false,
      "datePublished": "2026-02-03T00:00:00.000Z",
      "validThrough": "2026-03-10T00:00:00.000Z",
      "description": "Descricao completa da vaga no formato JSON-LD.",
      "employmentType": "FULL_TIME",
      "industry": "Financeiro",
      "directApply": true,
      "payCurrency": "BRL",
      "payPeriod": "MONTHLY",
      "salarySource": "EMPLOYER_PROVIDED",
      "salaryRange": {
        "p10": 9000,
        "p50": 12000,
        "p90": 15000
      },
      "applyUrl": "https://www.glassdoor.com.br/partner/jobListing.htm?tgt=APPLY_START&jobListingId=1009999255417",
      "jobLink": "https://www.glassdoor.com.br/partner/jobListing.htm?jobListingId=1009999255417",
      "seoUrl": "https://www.glassdoor.com.br/job-listing/desenvolvedor-full-stack-j%C3%BAnior-comerc-energia-JV_IC2479061_KO0,31_KE32,46.htm?jl=1009999255417",
      "employer": {
        "id": 2759194,
        "name": "Comerc Energia",
        "shortName": "Comerc Energia",
        "rating": 2.6,
        "reviewCount": 198,
        "logoUrl": "https://media.example.com/jeitto-square.png"
      },
      "benefits": [
        "Vale refeicao",
        "Plano de saude"
      ],
      "applicantLocationRequirements": [
        "Brazil"
      ],
      "rawLocation": {
        "id": 12226,
        "name": "Trabalho remoto",
        "type": "S"
      },
      "companyRatings": {
        "overallRating": 2.6,
        "workLifeBalanceRating": 2.8,
        "compensationAndBenefitsRating": 3.3,
        "careerOpportunitiesRating": 2.6,
        "cultureAndValuesRating": 2.7,
        "seniorManagementRating": 2.2
      }
    }
  }
}

Referência completa de campos

Path	Tipo	Descrição	Exemplo
data.data.ageInDays	number	Idade da vaga em dias.	9
data.data.applicantLocationRequirements[]	string	Restricoes geograficas para candidatura.	Brazil
data.data.applyUrl	string	URL para candidatura.	https://www.glassdoor.com.br/partner/jobListing.htm?tgt=APPLY_START&jobListingId=1009999255417
data.data.benefits[]	string	Lista de beneficios encontrados.	Vale refeicao
data.data.companyRatings.careerOpportunitiesRating	number	Nota de oportunidades de carreira.	2.6
data.data.companyRatings.compensationAndBenefitsRating	number	Nota de remuneracao e beneficios.	3.3
data.data.companyRatings.cultureAndValuesRating	number	Nota de cultura e valores.	2.7
data.data.companyRatings.overallRating	number	Nota geral da empresa.	2.6
data.data.companyRatings.seniorManagementRating	number	Nota de lideranca/gestao.	2.2
data.data.companyRatings.workLifeBalanceRating	number	Nota de equilibrio vida/trabalho.	2.8
data.data.datePublished	string	Data de publicacao da vaga.	2026-02-03T00:00:00.000Z
data.data.description	string	Descricao textual da vaga.	Descricao completa da vaga no formato JSON-LD.
data.data.directApply	boolean	Indica se a candidatura e direta.	true
data.data.easyApply	boolean	Indica se permite candidatura rapida.	true
data.data.employer.id	number	Identificador do empregador.	2759194
data.data.employer.logoUrl	string	URL do logo do empregador.	https://media.example.com/jeitto-square.png
data.data.employer.name	string	Nome do empregador.	Comerc Energia
data.data.employer.rating	number	Nota do empregador.	2.6
data.data.employer.reviewCount	number	Quantidade de avaliacoes do empregador.	198
data.data.employer.shortName	string	Nome curto do empregador.	Comerc Energia
data.data.employmentType	string	Tipo de contratacao da vaga.	FULL_TIME
data.data.industry	string	Setor/industria associado a vaga.	Financeiro
data.data.jobLink	string	URL alternativa interna de job listing.	https://www.glassdoor.com.br/partner/jobListing.htm?jobListingId=1009999255417
data.data.jobLocationType	string	Tipo de localizacao do JobPosting (ex.: TELECOMMUTE).	TELECOMMUTE
data.data.listingId	number	Identificador da vaga no Glassdoor.	1009999255417
data.data.locationName	string	Nome textual da localizacao.	Trabalho remoto
data.data.locationType	string	Tipo de localizacao da vaga.	S
data.data.normalizedJobTitle	string	Titulo normalizado do cargo.	Desenvolvedor Full Stack
data.data.payCurrency	string	Moeda de salario.	BRL
data.data.payPeriod	string	Periodo de pagamento (ex.: MONTHLY).	MONTHLY
data.data.rawLocation.id	number	Identificador bruto de localizacao no payload.	12226
data.data.rawLocation.name	string	Nome bruto de localizacao no payload.	Trabalho remoto
data.data.rawLocation.type	string	Tipo bruto de localizacao no payload.	S
data.data.salaryRange.p10	number	Percentil inferior da faixa salarial.	9000
data.data.salaryRange.p50	number	Percentil mediano da faixa salarial.	12000
data.data.salaryRange.p90	number	Percentil superior da faixa salarial.	15000
data.data.salarySource	string	Fonte da informacao salarial.	EMPLOYER_PROVIDED
data.data.seoUrl	string	URL SEO publica da vaga.	https://www.glassdoor.com.br/job-listing/desenvolvedor-full-stack-j%C3%BAnior-comerc-energia-JV_IC2479061_KO0,31_KE32,46.htm?jl=1009999255417
data.data.sponsoredEmployer	boolean	Indica se o empregador e patrocinado.	false
data.data.sponsoredJob	boolean	Indica se a vaga e patrocinada.	false
data.data.title	string	Titulo da vaga.	Desenvolvedor Full Stack Júnior
data.data.validThrough	string	Data limite de validade da vaga.	2026-03-10T00:00:00.000Z
data.extractedAt	string (iso datetime)	Data/hora ISO da extração.	2026-02-28T20:15:00.000Z
data.parser	string	Parser utilizado internamente para extrair o resultado.	next_flight
data.requestUrl	string	URL efetivamente requisitada no upstream.	https://www.glassdoor.com.br/partner/jobListing.htm?jobListingId=1009999255417
data.source	string	Origem dos dados extraidos.	glassdoor.com.br
data.type	string	Tipo normalizado do retorno para detalhe de vaga.	jdp
data.url	string	URL canonica da vaga.	https://www.glassdoor.com.br/job-listing/desenvolvedor-full-stack-j%C3%BAnior-comerc-energia-JV_IC2479061_KO0,31_KE32,46.htm?jl=1009999255417
executionId	string (uuid)	Campo executionId retornado no payload de resposta.	f6e5010a-e45e-40a8-8aa2-422ebae09cab
requestId	string (uuid)	Campo requestId retornado no payload de resposta.	3ec4f41a-a71d-4f3e-bf8f-a08a39f011a6

Erros comuns

Status	errorCode	Quando acontece
400	INVALID_PAYLOAD	JSON inválido ou violação das regras de validação do payload.
401	UNAUTHORIZED	Header Authorization ausente ou token/chave inválida.
402	INSUFFICIENT_CREDITS	Saldo de créditos insuficiente para a API solicitada.
403	FORBIDDEN	Usuário sem acesso ou API temporariamente desabilitada.
409	EXECUTION_CONFLICT	executionId conflita com uma execução em estado incompatível.
429	RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS	Limite de taxa ou limite de requisições em voo excedido.
5xx	UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_INVOCATION_FAILED / WORKER_FUNCTION_ERROR / WORKER_INVALID_RESPONSE / INTERNAL_ERROR	Falha de servidor no worker, provider/proxy ou gateway. Nesses casos os créditos são estornados automaticamente.