> ## Documentation Index > Fetch the complete documentation index at: https://glasser.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Informações sobre empresas > Consulte o perfil, a stack tecnológica, o tráfego do site, empresas semelhantes, financiamento e notícias de uma empresa a partir do domínio, com uma saída normalizada entre provedores de dados. Cada ação retorna `output` normalizado. A saída nativa do Provider não é repetida nele; ela permanece no Run e pode ser lida com [Get Run](https://glasser.ai/docs/pt/api-reference/runs/get.md). `enrich` e `traffic` expõem campos de nível superior fixos; `tech_stack`, `competitors` e `news` expõem `output.items[]`; `funding` expõe `total_funding_usd` mais `items[]`. Um valor que o Provider selecionado não relata é `null`; o Glasser não o preenche. Valores monetários são sempre em USD. Leia `result_status` separadamente de `status`: `success`, `no_result`, `error` ou `pending`. Uma resposta vazia, mas válida, é `no_result` e mantém o formato da ação: cada campo é `null`, ou `items` é `[]`. `charge_usd` totaliza o `runs` desta resposta e é nulo até que todos os Runs sejam concluídos. Com `provider: auto`, o fallback pode criar vários Runs, cada um listado em `runs[]` com sua própria cobrança. Para uma consulta Similarweb pendente (`traffic` via Apify, HTTP 202), siga o [result\_url](https://glasser.ai/docs/pt/api-reference/solutions/gtm/company_intelligence/result.md) autenticado. Consulte [Seleção de Provider e cobranças](https://glasser.ai/docs/pt/api-reference/solutions/overview.md#how-provider-selection-works). ## Saída por ação Cada campo está presente em cada linha; um valor que o Provider não relata é `null`. Os campos seguem as [convenções de campos](https://glasser.ai/docs/pt/api-reference/solutions/overview.md#field-conventions). | `action` | `output` | | - | - | | `enrich` | `name`, `website`, `description`, `industry`, `employees`, `employee_range_min`, `employee_range_max`, `founded_year`, `city`, `region`, `country`, `country_code`, `linkedin_url`, `phone`, `total_funding_usd`, `revenue_usd`, `revenue_range_min_usd`, `revenue_range_max_usd`, `ownership`, `ticker`, `latest_funding_date` | | `tech_stack` | `items[]`: `name`, `categories`\[], `detection_source`, `predictleads_confidence`, `first_detected_date`, `last_detected_date` | | `traffic` | `monthly_visits`, `organic_traffic`, `paid_traffic`, `organic_keywords`, `paid_keywords`, `organic_traffic_value_usd`, `similarweb_global_rank`, `bounce_rate`, `pages_per_visit`, `avg_visit_duration_seconds` | | `competitors` | `items[]`: `domain`, `name`, `page_title`, `position`, `predictleads_similarity_score`, `exa_similarity_score`, `reason` | | `funding` | `total_funding_usd`, `items[]`: `round_date`, `round`, `amount_usd`, `investors`\[], `source_url` | | `news` | `items[]`: `title`, `url`, `source`, `published_at`, `event_date`, `date_text`, `category`, `snippet` | * `employees` e os campos de receita são estimativas do próprio Provider. `revenue_usd` é um único valor; quando um Provider fornece apenas uma faixa, ele é `null` e os limites da faixa estão em `revenue_range_min_usd` / `revenue_range_max_usd`. `employee_range_min` / `employee_range_max` funcionam da mesma forma. Uma faixa sem limite superior, como `10000+`, tem um máximo `null`. * `country` é um nome de exibição em inglês e `country_code` é um código ISO 3166-1 alpha-2. `ownership` é um dos valores `public`, `private`, `nonprofit`, `government`, `education`, `other` ou `null`; private nunca é inferido. * As pontuações do próprio modelo de um Provider trazem o nome dele e são `null` para os demais: `predictleads_similarity_score` (0–1), `exa_similarity_score` (similaridade neural da Exa), `predictleads_confidence` (0–1), `similarweb_global_rank` (1 = mais visitado). `position` é a ordem baseada em 1 na resposta do Provider. * competitors via Exa retorna páginas da web, não registros de empresas: `name` é `null` e o título da página está em `page_title`. As linhas do próprio domínio da empresa e de seus subdomínios são excluídas. * `monthly_visits` é mundial (Similarweb). `organic_traffic`, `paid_traffic` e as contagens de palavras-chave referem-se à solicitação `country` (padrão `us`). `bounce_rate` é uma fração de 0 a 1. * Datas: `*_date` e `event_date` são `YYYY-MM-DD`, `published_at` é ISO 8601 UTC e `date_text` é o texto de exibição do Google News exatamente como retornado. As datas de financiamento do LeadMagic têm precisão mensal (dia `01`). * `industry`, `categories`, `round` e `category` são rótulos no vocabulário próprio do Provider que responde e não são comparáveis entre Providers. ```json { "action": "enrich", "provider": "apollo", "status": "COMPLETED", "result_status": "success", "output": { "name": "Stripe", "website": "http://www.stripe.com", "industry": "information technology & services", "employees": 9400, "employee_range_min": null, "employee_range_max": null, "founded_year": 2010, "city": "South San Francisco", "region": "California", "country": "United States", "country_code": "US", "linkedin_url": "http://www.linkedin.com/company/stripe", "phone": "+1 415-298-5539", "total_funding_usd": 9443867423, "revenue_usd": 6935000000, "revenue_range_min_usd": null, "revenue_range_max_usd": null, "ownership": null, "ticker": null, "latest_funding_date": "2026-03-01", "description": "Stripe, Inc. is a global financial technology company…" }, "charge_usd": "0.026", "runs": [{ "provider": "apollo", "status": "COMPLETED", "charge_usd": "0.026" }], "result_url": "/v1/solutions/gtm/company_intelligence/result?token=…" } ``` ## OpenAPI ````yaml /openapi.pt.json post /v1/solutions/gtm/company_intelligence openapi: 3.1.0 info: title: Glasser version: 0.0.1 description: >- Uma chave, sem contrato, pagamento por chamada, para todas as APIs pagas adquiridas no atacado. Cada resposta contém x-request-id; cada corpo de erro contém o mesmo envelope. servers: - url: https://api.glasser.ai security: [] tags: - name: Solutions - name: Endpoints - name: Runs - name: Balance paths: /v1/solutions/gtm/company_intelligence: post: tags: - Solutions summary: Inteligência de empresas description: >- Pesquise empresas-alvo por setor, número de funcionários, sede ou tipo; encontre candidatos por nome de empresa; ou pesquise um domínio para obter seu perfil, stack de tecnologia, tráfego, empresas semelhantes, financiamento, notícias, vagas abertas e anúncios do Google. search precisa de um prompt ou filtros estruturados, lookup precisa de query (nome), e as outras ações precisam de domain. Cada ação retorna uma saída normalizada com o id, o provedor de dados e o status do ciclo de vida do último Run: search e lookup fornecem total_matches e output.items[] de empresas (um total de correspondências indisponível é null, nunca o tamanho da página); enrich e traffic fornecem campos fixos de nível superior, tech_stack / competitors / news / jobs fornecem output.items[] com campos fixos por linha, funding fornece total_funding_usd e items[], e ads fornece total_ads e items[]. A saída nativa do provedor de dados não é repetida em output; ela permanece no Run e pode ser lida com GET /v1/runs/:id. Um valor que o provedor de dados selecionado não informar é null; valores monetários estão sempre em USD. Leia result_status separadamente de status: success, no_result, error ou pending. charge_usd é o total dos runs desta resposta e é null até que todos os Runs listados sejam concluídos; runs[] contém a cobrança de cada Run. provider=auto seleciona o primeiro provedor de dados elegível e tenta o próximo somente em PROVIDER_ERROR, TIMED_OUT ou 503 na admissão; um provedor de dados nomeado nunca usa fallback. Para QUEUED/RUNNING (HTTP 202, atualmente apenas traffic via Apify), consulte por polling o result_url autenticado na origem da API. Reutilize o mesmo Idempotency-Key e os parâmetros de execução para uma nova tentativa intencional. operationId: gtm-company-intelligence parameters: - name: idempotency-key in: header schema: type: string minLength: 1 description: >- Gere um valor exclusivo para cada execução pretendida (recomenda-se um UUID). Tente novamente com a mesma chave e os mesmos parâmetros de execução para recuperar o Run original sem uma segunda cobrança. Alterar os parâmetros de execução com a mesma chave retorna 409; alterar task_id ou metadata não atualiza o Run original. required: true requestBody: content: application/json: schema: type: object properties: action: anyOf: - type: string enum: - search - lookup - enrich - tech_stack - traffic - competitors - funding - news - jobs - ads description: >- Padrão: enrich. search exige query ou um filtro estruturado; lookup exige query (nome da empresa). Todas as outras ações exigem domain. - search: descoberta de empresas por setor, faixa de número de funcionários, país ou tipo de empresa; offset faz a paginação. Filtros estruturados usam o vocabulário do Hunter; use query apenas para critérios representáveis por esses filtros. Outras condições de ICP devem ser verificadas separadamente. - lookup: candidatos por nome de empresa com paginação por página; não faça suposições entre nomes ambíguos. - enrich: perfil e dados firmográficos da empresa. - tech_stack, traffic, funding, news: os dados correspondentes da empresa. - jobs: vagas abertas encontradas nas próprias páginas de carreira da empresa; limit limita as linhas (padrão e máximo de 25), portanto a quantidade de linhas não é o total da empresa. - ads: criativos do Google Ads Transparency Center do anunciante por trás do domínio; country os restringe a uma região; sem esse campo, todas as regiões são incluídas. - competitors: empresas semelhantes. Para domínios concorrentes nos resultados do Google, use pesquisa de SEO com organic_competitors. - type: 'null' provider: anyOf: - type: string enum: - auto - apollo - pdl - hunter - prospeo - predictleads - leadmagic - builtwith - dataforseo - ahrefs - apify - exa - serper - scrapecreators description: >- Padrão auto: seleciona o primeiro provedor de dados elegível na ordem de preferência da Glasser. Um provedor de dados nomeado deve ser compatível com a solicitação e permitido pela sua Key; ele não usa fallback para outro provedor de dados. Os valores disponíveis estão listados abaixo. - type: 'null' domain: anyOf: - type: string minLength: 3 maxLength: 253 description: >- Um domínio de site, como stripe.com. Uma URL completa é aceita e reduzida ao host. - type: 'null' industries: anyOf: - type: array items: type: string minLength: 1 minItems: 1 maxItems: 20 - type: 'null' headcounts: anyOf: - type: array items: type: string enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1000 - 1001-5000 - 5001-10000 - 10001+ minItems: 1 maxItems: 8 - type: 'null' company_types: anyOf: - type: array items: type: string enum: - educational - educational institution - government agency - non profit - partnership - privately held - public company - self employed - self owned - sole proprietorship minItems: 1 maxItems: 10 - type: 'null' offset: anyOf: - type: integer minimum: 0 maximum: 10000 - type: 'null' page: anyOf: - type: integer minimum: 1 maximum: 500 - type: 'null' country: anyOf: - type: string minLength: 2 maxLength: 60 description: >- País como código ISO de duas letras ou nome do país, por exemplo, us, gb, de, Germany. Padrão us. Códigos de país compatíveis: us, gb, ca, au, nz, ie, in, sg, de, at, ch, fr, be, es, mx, ar, it, nl, pt, br, jp, kr, cn, hk, tw, ru, pl, se, no, dk, fi, tr, id, th, vn, ph, my, za, ae, il, sa, eg, ng, ua, cz, gr, hu, ro, co, cl, pe, lu. A disponibilidade também depende da ação e do provedor de dados. Um país incompatível é recusado antes da criação de um Run. Não altere o país para contornar um erro; isso altera os dados solicitados. - type: 'null' query: anyOf: - type: string minLength: 1 maxLength: 200 description: >- search: um prompt de descoberta de empresas. lookup: um nome de empresa. news via Serper: nome da empresa em vez do domínio. - type: 'null' limit: anyOf: - type: integer minimum: 1 maximum: 100 description: >- Linhas a retornar. Mantenha o número pequeno: a regra de cobrança do endpoint roteado pode considerá-lo. Cada capacidade impõe um limite adicional. - type: 'null' task_id: anyOf: - type: string description: >- Agrupe Runs relacionados, incluindo o fallback automático, sob uma única Task. Reutilize uma string estável e filtre a lista de Runs por task para recuperá-los. - type: 'null' metadata: anyOf: - anyOf: - type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ - {} description: >- Campos opcionais de rastreamento, retornados no Run e disponíveis como filtros. Eles nunca são enviados ao provedor de dados nem afetam o roteamento, o Price ou a idempotência. - Até 20 chaves: letras minúsculas, dígitos e sublinhados; comece com uma letra; no máximo 40 caracteres. - Valores: strings de 1–500 caracteres. - user_id: o ID opaco do seu usuário final, nunca o endereço de e-mail ou o nome. Entradas inválidas são descartadas por inteiro, não truncadas. A solicitação continua, e o Run retorna os campos que foram armazenados. - type: 'null' additionalProperties: false required: true responses: '200': description: Success content: application/json: schema: anyOf: - $ref: '#/components/schemas/CompanyIntelligenceResult' '202': description: Success content: application/json: schema: anyOf: - $ref: '#/components/schemas/CompanyIntelligenceResult' '400': description: ValidationFailed | IdempotencyKeyRequired content: application/json: schema: anyOf: - $ref: '#/components/schemas/ValidationFailedEncoded' - $ref: '#/components/schemas/IdempotencyKeyRequiredEncoded' - $ref: '#/components/schemas/ValidationFailedEncoded' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/UnauthorizedEncoded' '402': description: InsufficientBalance content: application/json: schema: $ref: '#/components/schemas/InsufficientBalanceEncoded' '403': description: EndpointNotPermitted | Forbidden content: application/json: schema: anyOf: - $ref: '#/components/schemas/EndpointNotPermittedEncoded' - $ref: '#/components/schemas/ForbiddenEncoded' '409': description: IdempotencyConflict content: application/json: schema: $ref: '#/components/schemas/IdempotencyConflictEncoded' '429': description: RateLimited content: application/json: schema: $ref: '#/components/schemas/RateLimitedEncoded' '503': description: ServiceUnavailable content: application/json: schema: $ref: '#/components/schemas/ServiceUnavailableEncoded' security: - bearer: [] components: schemas: CompanyIntelligenceResult: type: object properties: id: type: string run_url: type: string description: Abra este Run no console. Requer associação ao Workspace. provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ endpoint: type: string pattern: ^\/.+$ endpoint_version: type: integer exclusiveMinimum: 0 status: type: string enum: - QUEUED - RUNNING - COMPLETED - FAILED - STOPPED description: >- QUEUED ou RUNNING: ainda em andamento. COMPLETED: uma resposta do provedor de dados está disponível, incluindo respostas não 2xx. FAILED: consulte `failure`. STOPPED: interrompido antes do dispatch. Leia charge_usd separadamente de status. failure: anyOf: - type: object properties: kind: type: string enum: - TIMED_OUT - INTERNAL message: type: string required: - kind - message additionalProperties: false - type: 'null' description: Motivo da falha do Run. Não nulo somente quando status é FAILED. input: type: object output: anyOf: - anyOf: - type: object properties: total_matches: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Contagem de correspondências em todo o conjunto de dados quando informada pelo provedor de dados; nunca o tamanho da página atual. items: type: array items: type: object properties: name: anyOf: - type: string - type: 'null' description: >- Nome da empresa conforme informado pelo provedor de dados. website: anyOf: - type: string - type: 'null' description: Site da empresa como uma URL http(s). description: anyOf: - type: string - type: 'null' description: >- Descrição breve da empresa fornecida pelo provedor de dados. industry: anyOf: - type: string - type: 'null' description: >- Rótulo do setor no vocabulário próprio do provedor de dados que responde (LinkedIn, no estilo GICS, ...). Não é comparável entre provedores de dados; consulte `provider`. employees: anyOf: - type: integer - type: 'null' description: >- Contagem de funcionários. Estimativa própria do provedor de dados, não uma contagem auditada. employee_range_min: anyOf: - type: integer - type: 'null' description: >- Limite inferior da faixa de tamanho de funcionários do provedor de dados (por exemplo, 10000 para 10K-50K). employee_range_max: anyOf: - type: integer - type: 'null' description: >- Limite superior da faixa de tamanho de funcionários do provedor de dados; null para uma faixa sem limite superior, como 10000+. founded_year: anyOf: - type: integer - type: 'null' description: Ano de fundação da empresa. city: anyOf: - type: string - type: 'null' description: Cidade da sede. region: anyOf: - type: string - type: 'null' description: Estado ou região da sede. country: anyOf: - type: string - type: 'null' description: >- País da sede como nome de exibição em inglês (nunca um código). country_code: anyOf: - type: string - type: 'null' description: País da sede como código ISO 3166-1 alpha-2. linkedin_url: anyOf: - type: string - type: 'null' description: URL da página da empresa no LinkedIn. phone: anyOf: - type: string - type: 'null' description: >- Número de telefone da sede conforme informado pelo provedor de dados. total_funding_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Financiamento total captado, em USD, conforme informado pelo provedor de dados. revenue_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Receita anual como um único valor, em USD: estimativa ou valor informado pelo provedor de dados. Null quando o provedor de dados fornece apenas uma faixa (consulte revenue_range_min_usd / revenue_range_max_usd). revenue_range_min_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Limite inferior da faixa de receita anual do provedor de dados, em USD. revenue_range_max_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Limite superior da faixa de receita anual do provedor de dados, em USD; null para uma faixa sem limite superior, como $10B+. ownership: anyOf: - type: string enum: - public - private - nonprofit - government - education - other - type: 'null' description: >- Tipo de propriedade mapeado a partir do rótulo do provedor de dados. Null quando o provedor de dados não informa; private nunca é inferido. ticker: anyOf: - type: string - type: 'null' description: >- Ticker ou símbolo público da ação, para empresas de capital aberto. latest_funding_date: anyOf: - type: string - type: 'null' description: >- Data da rodada de financiamento mais recente, YYYY-MM-DD. domain: anyOf: - type: string - type: 'null' required: - name - website - description - industry - employees - employee_range_min - employee_range_max - founded_year - city - region - country - country_code - linkedin_url - phone - total_funding_usd - revenue_usd - revenue_range_min_usd - revenue_range_max_usd - ownership - ticker - latest_funding_date - domain additionalProperties: false required: - total_matches - items additionalProperties: false - type: object properties: name: anyOf: - type: string - type: 'null' description: >- Nome da empresa conforme informado pelo provedor de dados. website: anyOf: - type: string - type: 'null' description: Site da empresa como uma URL http(s). description: anyOf: - type: string - type: 'null' description: >- Breve descrição da empresa fornecida pelo provedor de dados. industry: anyOf: - type: string - type: 'null' description: >- Rótulo do setor no vocabulário próprio do provedor de dados que responde (LinkedIn, no estilo GICS, ...). Não é comparável entre provedores de dados; consulte `provider`. employees: anyOf: - type: integer - type: 'null' description: >- Contagem de funcionários. Estimativa própria do provedor de dados, não uma contagem auditada. employee_range_min: anyOf: - type: integer - type: 'null' description: >- Limite inferior da faixa de tamanho de funcionários do provedor de dados (por exemplo, 10000 para 10K-50K). employee_range_max: anyOf: - type: integer - type: 'null' description: >- Limite superior da faixa de tamanho de funcionários do provedor de dados; null para uma faixa sem limite superior, como 10000+. founded_year: anyOf: - type: integer - type: 'null' description: Ano de fundação da empresa. city: anyOf: - type: string - type: 'null' description: Cidade da sede. region: anyOf: - type: string - type: 'null' description: Estado ou região da sede. country: anyOf: - type: string - type: 'null' description: >- País da sede como nome de exibição em inglês (nunca um código). country_code: anyOf: - type: string - type: 'null' description: País da sede como código ISO 3166-1 alpha-2. linkedin_url: anyOf: - type: string - type: 'null' description: URL da página da empresa no LinkedIn. phone: anyOf: - type: string - type: 'null' description: >- Número de telefone da sede conforme informado pelo provedor de dados. total_funding_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Financiamento total captado, USD, conforme informado pelo provedor de dados. revenue_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Receita anual como um único valor, USD: estimativa ou valor informado pelo provedor de dados. Null quando o provedor de dados fornece apenas uma faixa (consulte revenue_range_min_usd / revenue_range_max_usd). revenue_range_min_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Limite inferior da faixa de receita anual do provedor de dados, USD. revenue_range_max_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Limite superior da faixa de receita anual do provedor de dados, USD; null para uma faixa sem limite superior, como $10B+. ownership: anyOf: - type: string enum: - public - private - nonprofit - government - education - other - type: 'null' description: >- Tipo de propriedade mapeado a partir do rótulo do provedor de dados. Null quando o provedor de dados não informa; privada nunca é inferida. ticker: anyOf: - type: string - type: 'null' description: >- Ticker da ação ou símbolo público, para empresas de capital aberto. latest_funding_date: anyOf: - type: string - type: 'null' description: >- Data da rodada de financiamento mais recente, YYYY-MM-DD. required: - name - website - description - industry - employees - employee_range_min - employee_range_max - founded_year - city - region - country - country_code - linkedin_url - phone - total_funding_usd - revenue_usd - revenue_range_min_usd - revenue_range_max_usd - ownership - ticker - latest_funding_date additionalProperties: false - type: object properties: monthly_visits: anyOf: - type: integer - type: 'null' description: >- Visitas mensais de todos os canais, no mundo todo (estimativa do painel da Similarweb). Não limitado a um país. organic_traffic: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Visitas mensais estimadas de busca orgânica no país da solicitação (padrão us); estimativa baseada em um modelo de busca. paid_traffic: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Visitas mensais estimadas de busca paga no país da solicitação (padrão us). organic_keywords: anyOf: - type: integer - type: 'null' description: >- Palavras-chave para as quais o domínio aparece organicamente no país da solicitação. paid_keywords: anyOf: - type: integer - type: 'null' description: >- Palavras-chave nas quais o domínio dá lances no país da solicitação. organic_traffic_value_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Valor mensal estimado do tráfego orgânico, USD (Ahrefs). Null para outros provedores de dados. similarweb_global_rank: anyOf: - type: integer - type: 'null' description: >- Classificação global da Similarweb (1 = mais visitado). Null para outros provedores de dados. bounce_rate: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: Taxa de rejeição como uma fração de 0-1 (Similarweb). pages_per_visit: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: Páginas por visita (Similarweb). avg_visit_duration_seconds: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: Duração média da visita em segundos (Similarweb). required: - monthly_visits - organic_traffic - paid_traffic - organic_keywords - paid_keywords - organic_traffic_value_usd - similarweb_global_rank - bounce_rate - pages_per_visit - avg_visit_duration_seconds additionalProperties: false - type: object properties: total_funding_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Financiamento total captado, USD, conforme informado pelo provedor de dados. items: type: array items: type: object properties: round_date: anyOf: - type: string - type: 'null' description: >- Data da rodada, YYYY-MM-DD. As datas da LeadMagic têm precisão mensal (dia 01). round: anyOf: - type: string - type: 'null' description: >- Rótulo da rodada no vocabulário do provedor de dados que responde (seed, Series I, ...). amount_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Valor captado na rodada, USD. Null para outras moedas. investors: type: array items: type: string description: Nomes dos investidores. source_url: anyOf: - type: string - type: 'null' description: Artigo-fonte da rodada (PredictLeads). required: - round_date - round - amount_usd - investors - source_url additionalProperties: false required: - total_funding_usd - items additionalProperties: false - type: object properties: total_ads: anyOf: - type: integer - type: 'null' description: >- Número total de anúncios do anunciante, conforme estimado pelo Ads Transparency Center do Google. Não é o número de itens retornados. items: type: array items: type: object properties: creative_id: anyOf: - type: string - type: 'null' description: ID do criativo do Google Ads Transparency. advertiser_id: anyOf: - type: string - type: 'null' description: ID do anunciante do Google Ads Transparency. advertiser_name: anyOf: - type: string - type: 'null' description: Nome legal do anunciante verificado. format: anyOf: - type: string - type: 'null' description: >- Formato do anúncio no vocabulário do Google: texto, imagem ou vídeo. ad_url: anyOf: - type: string - type: 'null' description: Página do criativo no Ads Transparency Center. image_url: anyOf: - type: string - type: 'null' description: Imagem de prévia renderizada do criativo. first_shown_at: anyOf: - type: string - type: 'null' description: >- Primeira vez em que o anúncio foi exibido, ISO 8601 UTC. last_shown_at: anyOf: - type: string - type: 'null' description: >- Momento mais recente em que o anúncio foi exibido, ISO 8601 UTC. required: - creative_id - advertiser_id - advertiser_name - format - ad_url - image_url - first_shown_at - last_shown_at additionalProperties: false required: - total_ads - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: name: type: string description: Nome da tecnologia. categories: type: array items: type: string description: >- Rótulos de categoria no vocabulário do provedor de dados que responde (tag do BuiltWith, grupo/categoria do DataForSEO). Vazio quando o provedor de dados não fornece nenhum. detection_source: anyOf: - type: string enum: - website - job_postings - type: 'null' description: >- Como a tecnologia foi detectada: rastreamento do site público ou inferência a partir de anúncios de emprego (detecções do PredictLeads por trás do firewall). predictleads_confidence: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Confiança da detecção do PredictLeads, 0-1. Null para outros provedores de dados. first_detected_date: anyOf: - type: string - type: 'null' description: Data da primeira detecção, YYYY-MM-DD. last_detected_date: anyOf: - type: string - type: 'null' description: Data da detecção mais recente, YYYY-MM-DD. required: - name - categories - detection_source - predictleads_confidence - first_detected_date - last_detected_date additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: domain: anyOf: - type: string - type: 'null' description: >- Domínio da empresa semelhante (hostname sem www. ou porta). name: anyOf: - type: string - type: 'null' description: >- Nome da empresa semelhante. Null quando o provedor de dados retorna páginas da web (Exa). page_title: anyOf: - type: string - type: 'null' description: >- Título da página da web correspondente (somente Exa); não é o nome de uma empresa. position: anyOf: - type: integer - type: 'null' description: >- Classificação baseada em 1 na resposta do provedor de dados. predictleads_similarity_score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Pontuação de similaridade entre empresas do PredictLeads, de 0 a 1. Nulo para outros provedores de dados. exa_similarity_score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Similaridade neural do Exa entre o site da empresa e a página correspondente. Nulo para outros provedores de dados. reason: anyOf: - type: string - type: 'null' description: >- Por que o provedor de dados considera a empresa semelhante (PredictLeads). required: - domain - name - page_title - position - predictleads_similarity_score - exa_similarity_score - reason additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: title: anyOf: - type: string - type: 'null' description: Manchete. url: anyOf: - type: string - type: 'null' description: URL do artigo. source: anyOf: - type: string - type: 'null' description: >- Nome do editor (Serper). Nulo quando o provedor de dados não fornece nenhum. published_at: anyOf: - type: string - type: 'null' description: Horário de publicação do artigo, ISO 8601 UTC. event_date: anyOf: - type: string - type: 'null' description: >- Data em que o evento relatado ocorreu, YYYY-MM-DD (PredictLeads). date_text: anyOf: - type: string - type: 'null' description: >- Data exibida pelo provedor de dados exatamente como retornada (Google News, pode ser relativa a completed_at, como '3 hours ago'); nunca analisada. category: anyOf: - type: string - type: 'null' description: >- Categoria do evento no vocabulário do provedor de dados (PredictLeads). snippet: anyOf: - type: string - type: 'null' description: Trecho curto. required: - title - url - source - published_at - event_date - date_text - category - snippet additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: title: anyOf: - type: string - type: 'null' description: Título da vaga conforme publicado. url: anyOf: - type: string - type: 'null' description: URL da vaga na página de carreiras da empresa. location: anyOf: - type: string - type: 'null' description: >- Texto do local conforme informado pelo provedor de dados. seniority: anyOf: - type: string - type: 'null' description: >- Nível de senioridade no vocabulário do provedor de dados que responde (PredictLeads). categories: type: array items: type: string description: >- Funções da vaga no vocabulário do provedor de dados que responde. Vazio quando o provedor de dados não fornece nenhuma. contract_types: type: array items: type: string description: >- Tipos de contrato, como período integral, no vocabulário do provedor de dados. Vazio quando o provedor de dados não fornece nenhum. salary_min_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Limite inferior do salário publicado, USD. Nulo quando não publicado. salary_max_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Limite superior do salário publicado, USD. Nulo quando não publicado. salary_period: anyOf: - type: string - type: 'null' description: >- Período abrangido pelos valores salariais, no vocabulário do provedor de dados (ano, hora, ...). posted_at: anyOf: - type: string - type: 'null' description: >- Horário da publicação informado pela empresa, ISO 8601 UTC. Frequentemente nulo. first_seen_at: anyOf: - type: string - type: 'null' description: >- Quando o provedor de dados viu a publicação pela primeira vez, ISO 8601 UTC. last_seen_at: anyOf: - type: string - type: 'null' description: >- Quando o provedor de dados viu a publicação pela última vez, ISO 8601 UTC. required: - title - url - location - seniority - categories - contract_types - salary_min_usd - salary_max_usd - salary_period - posted_at - first_seen_at - last_seen_at additionalProperties: false required: - items additionalProperties: false - type: 'null' description: >- Campos normalizados por ação. A saída nativa do provedor de dados não é repetida aqui; ela permanece no Run (GET /v1/runs/:id). Os valores que um provedor de dados não informa são nulos; uma resposta vazia usa o formato da ação com todos os campos nulos ou items: [], com result_status no_result. Os valores monetários estão em USD. Employees e revenue são estimativas do próprio provedor de dados; *_range_min / *_range_max são os limites da faixa do provedor de dados. Uma pontuação do modelo próprio de um provedor de dados recebe o nome desse provedor (exa_similarity_score) e é nula para os demais. Rótulos como industry, categories, round e category seguem o vocabulário do provedor de dados que responde. - search: total_matches, items[]: domain e os campos do perfil da empresa; os campos não informados pelo provedor de dados são nulos - lookup: total_matches, items[]: domain e os campos do perfil da empresa; nomes ambíguos retornam candidatos - enrich: name, website, description, industry, employees, employee_range_min, employee_range_max, founded_year, city, region, country, country_code, linkedin_url, phone, total_funding_usd, revenue_usd, revenue_range_min_usd, revenue_range_max_usd, ownership, ticker, latest_funding_date - tech_stack: items[]: name, categories[], detection_source, predictleads_confidence, first_detected_date, last_detected_date - traffic: monthly_visits, organic_traffic, paid_traffic, organic_keywords, paid_keywords, organic_traffic_value_usd, similarweb_global_rank, bounce_rate, pages_per_visit, avg_visit_duration_seconds - competitors: items[]: domain, name, page_title, position, predictleads_similarity_score, exa_similarity_score, reason - funding: total_funding_usd, items[]: round_date, round, amount_usd, investors[], source_url - news: items[]: title, url, source, published_at, event_date, date_text, category, snippet - jobs: items[]: title, url, location, seniority, categories[], contract_types[], salary_min_usd, salary_max_usd, salary_period, posted_at, first_seen_at, last_seen_at - ads: total_ads, items[]: creative_id, advertiser_id, advertiser_name, format, ad_url, image_url, first_shown_at, last_shown_at provider_response: anyOf: - type: object properties: http_status: type: integer minimum: 100 maximum: 599 description: >- Status HTTP retornado pelo provedor de dados. Verifique-o mesmo quando o Run estiver COMPLETED. error: anyOf: - {} - type: 'null' required: - http_status additionalProperties: false - type: 'null' description: >- Não nulo somente quando o status é COMPLETED. - Para respostas 2xx, output contém JSON nativo do provedor de dados (qualquer formato) ou nulo para um corpo vazio. - Para respostas não 2xx, error contém o corpo de erro do provedor de dados e output é nulo. Os campos confidenciais são removidos de ambos os corpos. charge_usd: anyOf: - type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, uma grafia canônica). Some usando aritmética decimal ou multiplique por 10^6 — nunca use números de ponto flutuante. - type: 'null' description: >- Cobrança total dos Runs nesta resposta de Solution. Nulo até que todos os Runs listados sejam liquidados. Cada Run mantém sua própria cobrança; falhas também podem ser cobradas. charge_basis: anyOf: - type: object properties: clause: type: string enum: - rule - NO_RESULT - PROVIDER_ERROR - TIMED_OUT - INTERNAL quantity: anyOf: - type: integer minimum: 0 - type: 'null' required: - clause - quantity additionalProperties: false - type: 'null' description: >- Base da cobrança de um único Run ou nulo para um total de vários Runs. Leia runs[].charge_basis para cada cobrança. stoppable: type: boolean description: >- Indica se uma solicitação de parada pode ser aceita no momento. Isso não garante que o Run possa ser interrompido antes do dispatch. stop_requested_at: anyOf: - type: string description: Carimbo de data e hora UTC ISO-8601 format: date-time - type: 'null' description: >- Quando uma parada foi solicitada. O Run ainda pode continuar se o dispatch já tiver começado. created_at: type: string description: Carimbo de data e hora UTC ISO-8601 format: date-time started_at: anyOf: - type: string description: Carimbo de data e hora UTC ISO-8601 format: date-time - type: 'null' completed_at: anyOf: - type: string description: Carimbo de data e hora UTC ISO-8601 format: date-time - type: 'null' task_id: anyOf: - type: string - type: 'null' metadata: type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ description: >- Seus campos de rastreamento armazenados. Use-os para filtrar Runs. Eles nunca são enviados ao provedor de dados nem afetam o roteamento, o Price ou a idempotência. - Até 20 chaves: letras minúsculas, dígitos e sublinhados; comece com uma letra; no máximo 40 caracteres. - Valores: strings de 1–500 caracteres. - user_id: o ID opaco do seu usuário final, nunca o endereço de e-mail ou o nome dele. action: type: string enum: - search - lookup - enrich - tech_stack - traffic - competitors - funding - news - jobs - ads result_status: type: string enum: - success - no_result - error - pending description: >- Status de entrega comercial, independente do ciclo de vida final do Run em status. no_result é uma resposta vazia, mas válida; error significa que não foi possível entregar a saída do provedor de dados. error: anyOf: - type: object properties: code: type: string message: type: string required: - code - message additionalProperties: false - type: 'null' runs: type: array items: type: object properties: id: type: string run_url: type: string description: Abra este Run no console. Requer associação ao Workspace. provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ endpoint: type: string pattern: ^\/.+$ endpoint_version: type: integer exclusiveMinimum: 0 status: type: string enum: - QUEUED - RUNNING - COMPLETED - FAILED - STOPPED description: >- QUEUED ou RUNNING: ainda em andamento. COMPLETED: uma resposta do provedor de dados está disponível, incluindo respostas não 2xx. FAILED: consulte `failure`. STOPPED: interrompido antes do dispatch. Leia charge_usd separadamente de status. failure: anyOf: - type: object properties: kind: type: string enum: - TIMED_OUT - INTERNAL message: type: string required: - kind - message additionalProperties: false - type: 'null' description: >- Motivo da falha do Run. Não nulo somente quando o status é FAILED. input: type: object properties: omitted: type: boolean enum: - true required: - omitted additionalProperties: false output: type: object properties: omitted: type: boolean enum: - true required: - omitted additionalProperties: false provider_response: anyOf: - type: object properties: http_status: type: integer minimum: 100 maximum: 599 description: >- Status HTTP retornado pelo provedor de dados. Verifique-o mesmo quando o Run estiver COMPLETED. required: - http_status additionalProperties: false - type: 'null' charge_usd: anyOf: - type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, uma grafia canônica). Some usando aritmética decimal ou multiplique por 10^6 — nunca use números de ponto flutuante. - type: 'null' description: >- Cobrança final como uma string decimal exata em USD. Nulo enquanto estiver QUEUED ou RUNNING. Um Run FAILED pode ter uma cobrança diferente de zero de acordo com o Price do endpoint. charge_basis: anyOf: - type: object properties: clause: type: string enum: - rule - NO_RESULT - PROVIDER_ERROR - TIMED_OUT - INTERNAL quantity: anyOf: - type: integer minimum: 0 - type: 'null' required: - clause - quantity additionalProperties: false - type: 'null' description: >- Cláusula de Price usada para calcular a cobrança. Nulo antes da liquidação ou quando nenhuma tentativa de provedor de dados foi feita. stoppable: type: boolean description: >- Indica se uma solicitação de parada pode ser aceita no momento. Isso não garante que o Run possa ser interrompido antes do dispatch. stop_requested_at: anyOf: - type: string description: Carimbo de data e hora UTC ISO-8601 format: date-time - type: 'null' description: >- Quando uma parada foi solicitada. O Run ainda pode continuar se o dispatch já tiver começado. created_at: type: string description: Carimbo de data e hora UTC ISO-8601 format: date-time started_at: anyOf: - type: string description: Carimbo de data e hora UTC ISO-8601 format: date-time - type: 'null' completed_at: anyOf: - type: string description: Carimbo de data e hora UTC ISO-8601 format: date-time - type: 'null' task_id: anyOf: - type: string - type: 'null' metadata: type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ description: >- Seus campos de rastreamento armazenados. Use-os para filtrar Runs. Eles nunca são enviados ao provedor de dados nem afetam o roteamento, o Price ou a idempotência. - Até 20 chaves: letras minúsculas, dígitos e sublinhados; comece com uma letra; no máximo 40 caracteres. - Valores: strings de 1–500 caracteres. - user_id: o ID opaco do seu usuário final, nunca o endereço de e-mail ou o nome dele. required: - id - run_url - provider - endpoint - endpoint_version - status - failure - input - output - provider_response - charge_usd - charge_basis - stoppable - stop_requested_at - created_at - started_at - completed_at - task_id - metadata additionalProperties: false result_url: type: string description: >- Caminho de URL autenticado e somente leitura para consultar este resultado normalizado e a cobrança total. Use-o com a origem da API. Não cria Runs nem retoma o fallback. GET /v1/runs/:id ainda retorna o Run individual nativo. required: - id - run_url - provider - endpoint - endpoint_version - status - failure - input - output - provider_response - charge_usd - charge_basis - stoppable - stop_requested_at - created_at - started_at - completed_at - task_id - metadata - action - result_status - error - runs - result_url additionalProperties: false ValidationFailedEncoded: type: object properties: error: type: object properties: code: type: string enum: - validation_failed message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false IdempotencyKeyRequiredEncoded: type: object properties: error: type: object properties: code: type: string enum: - idempotency_key_required message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false UnauthorizedEncoded: type: object properties: error: type: object properties: code: type: string enum: - unauthorized message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false InsufficientBalanceEncoded: type: object properties: error: type: object properties: code: type: string enum: - insufficient_balance message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false EndpointNotPermittedEncoded: type: object properties: error: type: object properties: code: type: string enum: - endpoint_not_permitted message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false ForbiddenEncoded: type: object properties: error: type: object properties: code: type: string enum: - forbidden message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false IdempotencyConflictEncoded: type: object properties: error: type: object properties: code: type: string enum: - idempotency_conflict message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false RateLimitedEncoded: type: object properties: error: type: object properties: code: type: string enum: - rate_limited message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false ServiceUnavailableEncoded: type: object properties: error: type: object properties: code: type: string enum: - service_unavailable message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false securitySchemes: bearer: type: http scheme: Bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.