> 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/es/api-web/search/company.md).

# Búsqueda de empresas

Aprende a usar el endpoint /search/companies de Oxylabs Web API para buscar empresas por palabra clave y obtener perfiles de empresa estructurados.

`/v1/search/companies` es un endpoint especializado de `/v1/search` diseñado para investigar empresas, calificar clientes potenciales y mapear mercados. Busca empresas por palabra clave y devuelve un perfil estructurado por cada resultado, que incluye:

* sector
* sede central
* número de empleados
* ingresos
* analíticas del tráfico del sitio web
* y más

{% hint style="success" %}
**Company Search devuelve los datos en sí, no enlaces a ellos:** Cada resultado es un perfil completo, `/v1/scrape` no es necesario. Para obtener más información sobre una empresa, pasa su `website_url` a `/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>Devuelve</strong></td><td>Páginas web clasificadas: título, fragmento, URL</td><td>Perfiles de empresas: datos de la empresa, datos financieros y tráfico 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 de los resultados</strong></td><td>Extrae las URL de los resultados</td><td>Usa directamente los campos del perfil</td></tr></tbody></table>

## Ejemplo de solicitud

El endpoint acepta un cuerpo de solicitud JSON con la consulta de **búsqueda** y el **límite 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 de la solicitud

<table><thead><tr><th width="128">Parámetro</th><th width="492">Descripción</th><th>Tipo</th></tr></thead><tbody><tr><td><mark style="background-color:green;"><strong><code>query</code></strong></mark></td><td>Palabra clave o frase de búsqueda (entre <code>1</code> y <code>2,048</code> caracteres).</td><td>cadena</td></tr><tr><td><code>max_results</code></td><td>Número de perfiles de empresas que se devolverán (entre <code>1</code> y <code>100</code>). Valor predeterminado: <code>10</code></td><td>entero</td></tr></tbody></table>

&#x20;   – parámetro obligatorio

{% hint style="warning" %}
Los parámetros desconocidos o mal escritos se rechazan con un código de estado HTTP `400 Bad Request` , no se ignoran. Esto incluye `location`, que es compatible con `/v1/search` pero no con `/v1/search/companies`.
{% endhint %}

### Optimización de solicitudes

<details>

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

La `query` sirve tanto para descubrir empresas como para buscar una que ya conozcas:

<table><thead><tr><th width="360">Qué buscas</th><th>Ejemplo de consulta</th></tr></thead><tbody><tr><td>Empresas de un sector, una industria o una actividad</td><td><code>new energy sector companies</code></td></tr><tr><td>Una empresa concreta por nombre</td><td><code>Energinet</code></td></tr><tr><td>Una empresa concreta por dominio</td><td><code>energinet.dk</code></td></tr></tbody></table>

Para descubrir empresas, las consultas con palabras clave dan mejores resultados que las consultas redactadas como frases:

| En vez de                                                                                | Usa                           |
| ---------------------------------------------------------------------------------------- | ----------------------------- |
| "¿Puedes encontrarme algunas empresas que trabajen en el sector de las nuevas energías?" | `new energy sector companies` |

Usa un tema por solicitud. Una consulta compuesta devuelve resultados que no coinciden bien con ninguna de las partes.

</details>

<details>

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

El parámetro es un límite, no un objetivo. Si una consulta tiene menos coincidencias, devolverá menos perfiles, ordenados por relevancia, empezando por los más relevantes.

</details>

## Ejemplo de salida

{% 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" %}
**Los campos del perfil pueden ser `null`.** Valores como `founded_year`, `revenue_annual_usd`, y `headquarters.state` se devuelven como `null` cuando los datos no están disponibles. `funding` es `null` cuando la empresa no tiene ninguna ronda de financiación registrada, y cada campo dentro de este también puede ser `null` Comprueba si hay `null` antes de usar un campo.
{% endhint %}

### Diccionario de salida

<table><thead><tr><th width="319">Campo</th><th width="355">Descripción</th><th width="89">Tipo</th></tr></thead><tbody><tr><td><code>state</code></td><td><code>"done"</code> si la solicitud se completa correctamente. Consulta los códigos de error para las solicitudes fallidas.</td><td>cadena</td></tr><tr><td><code>results</code></td><td>Perfiles de empresas que coinciden con la consulta. Siempre está presente, por lo que una salida vacía significa que no hubo coincidencias.</td><td>matriz</td></tr><tr><td><code>name</code></td><td>Nombre de la empresa.</td><td>cadena</td></tr><tr><td><code>website_url</code></td><td>URL del sitio web oficial de la empresa. Pásala a <code>/v1/scrape</code> para leer el sitio.</td><td>cadena</td></tr><tr><td><code>linkedin_url</code></td><td>URL de la página del perfil de LinkedIn de la empresa.</td><td>cadena</td></tr><tr><td><code>description</code></td><td>Descripción general completa de la empresa y descripción de su actividad.</td><td>cadena</td></tr><tr><td><code>industry</code></td><td>Clasificación del sector de la empresa.</td><td>cadena</td></tr><tr><td><code>type</code></td><td>Tipo de organización (p. ej., <code>"privately held"</code>, <code>"government agency"</code>).</td><td>cadena</td></tr><tr><td><code>founded_year</code></td><td>Año en que se fundó la empresa. <code>null</code> si no está disponible.</td><td>entero</td></tr><tr><td><code>employees_count</code></td><td>Número total estimado de empleados.</td><td>entero</td></tr><tr><td><code>headquarters</code></td><td>Detalles de ubicación de la oficina principal de la empresa.</td><td>objeto</td></tr><tr><td><code>headquarters.address</code></td><td>Dirección en formato estándar.</td><td>cadena</td></tr><tr><td><code>headquarters.city</code></td><td>Ciudad donde se encuentra la sede central.</td><td>cadena</td></tr><tr><td><code>headquarters.state</code></td><td>Estado, provincia o región. <code>null</code> si no corresponde.</td><td>cadena</td></tr><tr><td><code>headquarters.country</code></td><td>Nombre del país.</td><td>cadena</td></tr><tr><td><code>funding</code></td><td>Capital recaudado. <code>null</code> cuando la empresa no tiene rondas de financiación registradas.</td><td>objeto</td></tr><tr><td><code>funding.total_usd</code></td><td>Financiación total obtenida en USD. <code>null</code> si no está disponible.</td><td>número</td></tr><tr><td><code>funding.latest_round</code></td><td>Ronda de financiación más reciente. <code>null</code> si no está disponible.</td><td>objeto</td></tr><tr><td><code>funding.latest_round.type</code></td><td>Tipo de ronda de financiación. <code>null</code> si no está disponible.</td><td>cadena</td></tr><tr><td><code>funding.latest_round.date</code></td><td>Fecha de la ronda de financiación. <code>null</code> si no está disponible.</td><td>cadena</td></tr><tr><td><code>funding.latest_round.amount_usd</code></td><td>Importe obtenido en la ronda, en USD. <code>null</code> si no está disponible.</td><td>número</td></tr><tr><td><code>funding.investors</code></td><td>Nombres de los inversores de la empresa. <code>null</code> si no está disponible.</td><td>matriz de cadenas</td></tr><tr><td><code>revenue_annual_usd</code></td><td>Ingresos anuales estimados en USD. <code>null</code> si no está disponible.</td><td>número</td></tr><tr><td><code>web_traffic</code></td><td>Métricas de analítica y tráfico web del dominio de la empresa.</td><td>objeto</td></tr><tr><td><code>web_traffic.visits_monthly</code></td><td>Número total estimado de visitas al sitio web durante el mes más reciente.</td><td>número</td></tr><tr><td><code>web_traffic.avg_visit_duration_seconds</code></td><td>Duración media de la sesión en segundos.</td><td>entero</td></tr><tr><td><code>web_traffic.global_rank</code></td><td>Clasificación mundial del tráfico del sitio web.</td><td>entero</td></tr><tr><td><code>web_traffic.country_rank</code></td><td>Clasificación del tráfico del sitio web en el país principal.</td><td>entero</td></tr><tr><td><code>web_traffic.history</code></td><td>Registros históricos mensuales de visitas al sitio web.</td><td>matriz</td></tr><tr><td><code>web_traffic.history[].month</code></td><td>Periodo en formato <code>YYYY-MM</code> .</td><td>cadena</td></tr><tr><td><code>web_traffic.history[].value</code></td><td>Visitas estimadas al sitio web durante ese mes.</td><td>número</td></tr><tr><td><code>params</code></td><td>Parámetros de ejecución, incluidos los valores predeterminados.</td><td>objeto</td></tr><tr><td><code>metadata.timestamp</code></td><td>Marca de tiempo Unix en segundos.</td><td>entero</td></tr><tr><td><code>metadata.request_id</code></td><td>Identificador de solicitud de 19 dígitos. <strong>Inclúyalo en las solicitudes de soporte.</strong></td><td>cadena</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/es/api-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.
