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

# Company Search

Learn how to use Oxylabs Web API /search/companies endpoint to find companies by keyword and get structured company profiles.

`/v1/search/companies` is a dedicated endpoint of `/v1/search` built for company research, lead qualification, and market mapping that searches for companies by keyword and returns a structured profile for each match, including:

* industry
* headquarters
* employee count
* revenue
* website traffic analytics
* and more

{% hint style="success" %}
**Company Search returns the data itself, not links to it:** Each result is a complete profile, `/v1/scrape` request is not required. To read more about a company, pass its `website_url` to `/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>Returns</strong></td><td>Ranked web pages: title, snippet, URL</td><td>Company profiles: firmographics, financials, web traffic</td></tr><tr><td><strong>Input</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>Result usage</strong></td><td>Scrape the result URLs</td><td>Use the profile fields directly</td></tr></tbody></table>

## Request sample

The endpoint accepts a JSON request body with the search **query** and the **result limit**.

```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
  }'
```

### Request parameters

<table><thead><tr><th width="128">Parameter</th><th width="492">Description</th><th>Type</th></tr></thead><tbody><tr><td><mark style="background-color:green;"><strong><code>query</code></strong></mark></td><td>Search keyword or phrase (between <code>1</code> and <code>2,048</code> characters).</td><td>string</td></tr><tr><td><code>max_results</code></td><td>Number of company profiles to return (between <code>1</code> and <code>100</code>). Default: <code>10</code></td><td>integer</td></tr></tbody></table>

&#x20;   – mandatory parameter

{% hint style="warning" %}
Unknown or misspelled parameters are rejected with an HTTP `400 Bad Request` status code, not ignored. This includes `location`, which is supported by `/v1/search` but not by `/v1/search/companies`.
{% endhint %}

### Request optimization

<details>

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

The `query` works both for discovering companies and for looking up one you already know:

<table><thead><tr><th width="360">Looking for</th><th>Example query</th></tr></thead><tbody><tr><td>Companies in an industry, sector, or activity</td><td><code>new energy sector companies</code></td></tr><tr><td>A specific company by name</td><td><code>Energinet</code></td></tr><tr><td>A specific company by domain</td><td><code>energinet.dk</code></td></tr></tbody></table>

For discovery, keyword-shaped queries outperform sentence-shaped ones:

| Instead of                                                           | Use                           |
| -------------------------------------------------------------------- | ----------------------------- |
| "Can you find me some companies that work in the new energy sector?" | `new energy sector companies` |

One topic per request. A compound query returns results that match neither half well.

</details>

<details>

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

Parameter is a limit, not a target. A query with fewer matches returns fewer profiles, which are ordered by relevance, best first.

</details>

## Output sample

{% 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" %}
**Profile fields can be `null`.** Values such as `founded_year`, `revenue_annual_usd`, and `headquarters.state` are returned as `null` when the data is unavailable. `funding` is `null` when the company has no recorded funding round, and each field inside it can be `null` as well. Check for `null` before using a field.
{% endhint %}

### Output dictionary

<table><thead><tr><th width="319">Field</th><th width="355">Description</th><th width="89">Type</th></tr></thead><tbody><tr><td><code>state</code></td><td><code>"done"</code> on success. See Error codes for failed requests.</td><td>string</td></tr><tr><td><code>results</code></td><td>Company profiles matching the query. Always present, so empty output means nothing matched.</td><td>array</td></tr><tr><td><code>name</code></td><td>Company name.</td><td>string</td></tr><tr><td><code>website_url</code></td><td>Official website URL of the company. Pass to <code>/v1/scrape</code> to read the site.</td><td>string</td></tr><tr><td><code>linkedin_url</code></td><td>URL of the company's LinkedIn profile page.</td><td>string</td></tr><tr><td><code>description</code></td><td>Full company overview and business description.</td><td>string</td></tr><tr><td><code>industry</code></td><td>Industry classification of the company.</td><td>string</td></tr><tr><td><code>type</code></td><td>Organization type (e.g., <code>"privately held"</code>, <code>"government agency"</code>).</td><td>string</td></tr><tr><td><code>founded_year</code></td><td>Year the company was established. <code>null</code> if unavailable.</td><td>integer</td></tr><tr><td><code>employees_count</code></td><td>Estimated total number of employees.</td><td>integer</td></tr><tr><td><code>headquarters</code></td><td>Location details for the company's main office.</td><td>object</td></tr><tr><td><code>headquarters.address</code></td><td>Formatted address string.</td><td>string</td></tr><tr><td><code>headquarters.city</code></td><td>City where the headquarters is located.</td><td>string</td></tr><tr><td><code>headquarters.state</code></td><td>State, province, or region. <code>null</code> if not applicable.</td><td>string</td></tr><tr><td><code>headquarters.country</code></td><td>Country name.</td><td>string</td></tr><tr><td><code>funding</code></td><td>Raised capital. <code>null</code> when the company has no recorded funding round.</td><td>object</td></tr><tr><td><code>funding.total_usd</code></td><td>Total funding raised in USD. <code>null</code> if unavailable.</td><td>number</td></tr><tr><td><code>funding.latest_round</code></td><td>Most recent funding round. <code>null</code> if unavailable.</td><td>object</td></tr><tr><td><code>funding.latest_round.type</code></td><td>Type of the funding round. <code>null</code> if unavailable.</td><td>string</td></tr><tr><td><code>funding.latest_round.date</code></td><td>Date of the funding round. <code>null</code> if unavailable.</td><td>string</td></tr><tr><td><code>unding.latest_round.amount_usd</code></td><td>Amount raised in the round in USD. <code>null</code> if unavailable.</td><td>number</td></tr><tr><td><code>funding.investors</code></td><td>Names of the company's investors. <code>null</code> if unavailable.</td><td>array of strings</td></tr><tr><td><code>revenue_annual_usd</code></td><td>Estimated annual revenue in USD. <code>null</code> if unavailable.</td><td>number</td></tr><tr><td><code>web_traffic</code></td><td>Web analytics and traffic metrics for the company domain.</td><td>object</td></tr><tr><td><code>web_traffic.visits_monthly</code></td><td>Estimated total website visits for the most recent month.</td><td>number</td></tr><tr><td><code>web_traffic.avg_visit_duration_seconds</code></td><td>Average session duration in seconds.</td><td>integer</td></tr><tr><td><code>web_traffic.global_rank</code></td><td>Global website traffic rank.</td><td>integer</td></tr><tr><td><code>web_traffic.country_rank</code></td><td>Website traffic rank within the primary country.</td><td>integer</td></tr><tr><td><code>web_traffic.history</code></td><td>Historical monthly website visit records.</td><td>array</td></tr><tr><td><code>web_traffic.history[].month</code></td><td>Time period in <code>YYYY-MM</code> format.</td><td>string</td></tr><tr><td><code>web_traffic.history[].value</code></td><td>Estimated website visits for that month.</td><td>number</td></tr><tr><td><code>params</code></td><td>Execution parameters including defaults.</td><td>object</td></tr><tr><td><code>metadata.timestamp</code></td><td>Unix timestamp in seconds.</td><td>integer</td></tr><tr><td><code>metadata.request_id</code></td><td>19-digit request handle. <strong>Include in support tickets.</strong></td><td>string</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/web-api/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.
