> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/pt-br/api-da-web/search/company.md).

# Pesquisa de empresas

Saiba como usar o endpoint /search/companies da Oxylabs Web API para encontrar empresas por palavra-chave e obter perfis de empresas estruturados.

`/v1/search/companies` é um endpoint dedicado de `/v1/search` desenvolvido para pesquisa de empresas, qualificação de leads e mapeamento de mercado. Ele pesquisa empresas por palavra-chave e retorna um perfil estruturado para cada resultado, incluindo:

* setor
* sede
* número de funcionários
* receita
* análises de tráfego do site
* e muito mais

{% hint style="success" %}
**A Pesquisa de empresas retorna os próprios dados, não links para eles:** Cada resultado é um perfil completo, `/v1/scrape` não é necessário. Para saber mais sobre uma empresa, informe seu `website_url` em `/v1/scrape`.
{% endhint %}

<table data-header-hidden><thead><tr><th width="129"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Endpoint</strong></td><td><code>/v1/search</code></td><td><code>/v1/search/companies</code></td></tr><tr><td><strong>Retorna</strong></td><td>Páginas da Web classificadas: título, trecho, URL</td><td>Perfis de empresas: dados firmográficos, financeiros e de tráfego da Web</td></tr><tr><td><strong>Entrada</strong></td><td><code>query</code>, <code>max_results</code>, <code>location</code></td><td><code>query</code>, <code>max_results</code></td></tr><tr><td><strong>Uso dos resultados</strong></td><td>Raspe as URLs dos resultados</td><td>Use diretamente os campos do perfil</td></tr></tbody></table>

## Exemplo de solicitação

O endpoint aceita um corpo de solicitação JSON com a **consulta** e o **limite de resultados**.

```bash
curl https://webapi.oxylabs.io/v1/search/companies \
  -H "Authorization: Bearer $OXYLABS_WEB_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "new energy sector companies",
    "max_results": 3
  }'
```

### Parâmetros da solicitação

<table><thead><tr><th width="128">Parâmetro</th><th width="492">Descrição</th><th>Tipo</th></tr></thead><tbody><tr><td><mark style="background-color:green;"><strong><code>query</code></strong></mark></td><td>Palavra-chave ou frase de pesquisa (entre <code>1</code> e <code>2,048</code> caracteres).</td><td>texto</td></tr><tr><td><code>max_results</code></td><td>Número de perfis de empresas a retornar (entre <code>1</code> e <code>100</code>). Padrão: <code>10</code></td><td>inteiro</td></tr></tbody></table>

&#x20;   – parâmetro obrigatório

{% hint style="warning" %}
Parâmetros desconhecidos ou com erros de digitação são rejeitados com o código de status HTTP `400 Bad Request` , não são ignorados. Isso inclui `location`, que é compatível com `/v1/search` mas não com `/v1/search/companies`.
{% endhint %}

### Otimização de solicitações

<details>

<summary><strong><code>query</code></strong></summary>

O parâmetro `query` serve tanto para descobrir empresas quanto para encontrar uma empresa que você já conhece:

<table><thead><tr><th width="360">O que você procura</th><th>Exemplo de consulta</th></tr></thead><tbody><tr><td>Empresas de um setor, segmento ou ramo de atividade</td><td><code>new energy sector companies</code></td></tr><tr><td>Uma empresa específica pelo nome</td><td><code>Energinet</code></td></tr><tr><td>Uma empresa específica pelo domínio</td><td><code>energinet.dk</code></td></tr></tbody></table>

Para descobrir empresas, consultas em formato de palavras-chave têm melhores resultados do que consultas em formato de frase:

| Em vez de                                                                    | Use                           |
| ---------------------------------------------------------------------------- | ----------------------------- |
| "Você pode encontrar algumas empresas que atuam no setor de novas energias?" | `new energy sector companies` |

Use um tópico por solicitação. Uma consulta com vários tópicos retorna resultados que não correspondem bem a nenhum deles.

</details>

<details>

<summary><strong><code>max_results</code></strong></summary>

O parâmetro é um limite, não uma meta. Se houver menos correspondências para uma consulta, serão retornados menos perfis, ordenados por relevância, começando pelos mais relevantes.

</details>

## Exemplo de saída

{% code expandable="true" %}

```json
{
    "state": "done",
    "results": [
        {
            "name": "Energinet",
            "website_url": "https://www.energinet.dk",
            "linkedin_url": "https://www.linkedin.com/company/energinet-dk",
            "description": "NEW WINDS IN THE ENERGYSECTOR\nThe energy sector is undergoing a large-scale transformation because of national and international agreements to convert to climate-neutral societies. We need a change. Energinet wants to contribute to the...",
            "industry": "Utilities",
            "type": "government agency",
            "founded_year": 2005,
            "employees_count": 2919,
            "headquarters": {
                "address": "Fredericia, Denmark",
                "city": "Fredericia",
                "state": null,
                "country": "Denmark"
            },
            "funding": null,
            "revenue_annual_usd": 8595737.0,
            "web_traffic": {
                "visits_monthly": 90140.0,
                "avg_visit_duration_seconds": 31,
                "global_rank": 496219,
                "country_rank": 4506,
                "history": [
                    {
                        "month": "2026-05",
                        "value": 127917.0
                    },
                    {
                        "month": "2026-06",
                        "value": 91414.0
                    },
                    {
                        "month": "2026-07",
                        "value": 86946.0
                    },
                    {
                        "month": "2026-08",
                        "value": 86946.0
                    }
                ]
            }
        },
        ...
    ],
    "params": {
        "query": "new energy sector companies",
        "max_results": 3
    },
    "metadata": {
        "timestamp": 1794323210,
        "request_id": "1794323210495749155"
    }
}
```

{% endcode %}

{% hint style="warning" %}
**Os campos do perfil podem ser `null`.** Valores como `founded_year`, `revenue_annual_usd`, e `headquarters.state` são retornados como `null` quando os dados não estão disponíveis. `funding` é `null` quando a empresa não tem nenhuma rodada de financiamento registrada, e cada campo dentro dele também pode ser `null` Verifique se há `null` antes de usar um campo.
{% endhint %}

### Dicionário de saída

<table><thead><tr><th width="319">Campo</th><th width="355">Descrição</th><th width="89">Tipo</th></tr></thead><tbody><tr><td><code>state</code></td><td><code>"done"</code> em caso de sucesso. Consulte os códigos de erro para solicitações com falha.</td><td>texto</td></tr><tr><td><code>results</code></td><td>Perfis de empresas que correspondem à consulta. Sempre presente; portanto, uma saída vazia significa que nada correspondeu.</td><td>array</td></tr><tr><td><code>name</code></td><td>Nome da empresa.</td><td>texto</td></tr><tr><td><code>website_url</code></td><td>URL do site oficial da empresa. Passe para <code>/v1/scrape</code> para ler o site.</td><td>texto</td></tr><tr><td><code>linkedin_url</code></td><td>URL da página de perfil da empresa no LinkedIn.</td><td>texto</td></tr><tr><td><code>description</code></td><td>Visão geral completa da empresa e descrição de suas atividades.</td><td>texto</td></tr><tr><td><code>industry</code></td><td>Classificação do setor da empresa.</td><td>texto</td></tr><tr><td><code>type</code></td><td>Tipo de organização (por exemplo, <code>"privately held"</code>, <code>"government agency"</code>).</td><td>texto</td></tr><tr><td><code>founded_year</code></td><td>Ano em que a empresa foi fundada. <code>null</code> se não estiver disponível.</td><td>inteiro</td></tr><tr><td><code>employees_count</code></td><td>Número total estimado de funcionários.</td><td>inteiro</td></tr><tr><td><code>headquarters</code></td><td>Detalhes da localização do escritório principal da empresa.</td><td>objeto</td></tr><tr><td><code>headquarters.address</code></td><td>Endereço formatado.</td><td>texto</td></tr><tr><td><code>headquarters.city</code></td><td>Cidade onde fica a sede.</td><td>texto</td></tr><tr><td><code>headquarters.state</code></td><td>Estado, província ou região. <code>null</code> se não for aplicável.</td><td>texto</td></tr><tr><td><code>headquarters.country</code></td><td>Nome do país.</td><td>texto</td></tr><tr><td><code>funding</code></td><td>Capital captado. <code>null</code> quando não houver rodada de financiamento registrada para a empresa.</td><td>objeto</td></tr><tr><td><code>funding.total_usd</code></td><td>Total captado em financiamento, em USD. <code>null</code> se não estiver disponível.</td><td>número</td></tr><tr><td><code>funding.latest_round</code></td><td>Rodada de financiamento mais recente. <code>null</code> se não estiver disponível.</td><td>objeto</td></tr><tr><td><code>funding.latest_round.type</code></td><td>Tipo da rodada de financiamento. <code>null</code> se não estiver disponível.</td><td>texto</td></tr><tr><td><code>funding.latest_round.date</code></td><td>Data da rodada de financiamento. <code>null</code> se não estiver disponível.</td><td>texto</td></tr><tr><td><code>funding.latest_round.amount_usd</code></td><td>Valor captado na rodada, em USD. <code>null</code> se não estiver disponível.</td><td>número</td></tr><tr><td><code>funding.investors</code></td><td>Nomes dos investidores da empresa. <code>null</code> se não estiver disponível.</td><td>array de strings</td></tr><tr><td><code>revenue_annual_usd</code></td><td>Receita anual estimada em USD. <code>null</code> se não estiver disponível.</td><td>número</td></tr><tr><td><code>web_traffic</code></td><td>Métricas de análise e tráfego da web para o domínio da empresa.</td><td>objeto</td></tr><tr><td><code>web_traffic.visits_monthly</code></td><td>Total estimado de visitas ao site no mês mais recente.</td><td>número</td></tr><tr><td><code>web_traffic.avg_visit_duration_seconds</code></td><td>Duração média da sessão em segundos.</td><td>inteiro</td></tr><tr><td><code>web_traffic.global_rank</code></td><td>Classificação global de tráfego do site.</td><td>inteiro</td></tr><tr><td><code>web_traffic.country_rank</code></td><td>Classificação de tráfego do site no país principal.</td><td>inteiro</td></tr><tr><td><code>web_traffic.history</code></td><td>Registros históricos mensais de visitas ao site.</td><td>array</td></tr><tr><td><code>web_traffic.history[].month</code></td><td>Período no formato <code>YYYY-MM</code> .</td><td>texto</td></tr><tr><td><code>web_traffic.history[].value</code></td><td>Estimativa de visitas ao site nesse mês.</td><td>número</td></tr><tr><td><code>params</code></td><td>Parâmetros de execução, incluindo os valores padrão.</td><td>objeto</td></tr><tr><td><code>metadata.timestamp</code></td><td>Carimbo de data/hora Unix em segundos.</td><td>inteiro</td></tr><tr><td><code>metadata.request_id</code></td><td>Identificador de solicitação com 19 dígitos. <strong>Inclua nos chamados de suporte.</strong></td><td>texto</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.oxylabs.io/products/pt-br/api-da-web/search/company.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
