> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tavily.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tavily Knowledge - Company

> Get company records for 35M+ companies worldwide in /search and /extract results.

*Tavily Knowledge - Company* adds company records to `/search` and `/extract` results, with global coverage of 35M+ companies. Pass the name or domain you have, and a record with the company's identity, funding, M\&A and more may come back in the same call, at the same price. In `/search`, a record appears in `results[]` next to web pages, ranked by `score` like every other result.

## What's in a company record

> [card] One page per company
>
> Name, website, legal name, headquarters, LinkedIn page and founded year, at the top of every record.

> [card] Social and contact
>
> LinkedIn page and follower count, social profiles, and the company's general contact email.

> [card] Funding and financials
>
> Financials, funding rounds, acquisitions, and who acquired the company.

> [card] Products and technology
>
> Product keywords and the technologies the company uses.

> [card] Web traffic and reputation
>
> Monthly visits, site rank, bounce rate, employee review score and open roles.

> [card] Classification
>
> Industry, SIC and NAICS codes, and whether the company is public or private.

## Quick start

This request turns a company's domain into its record, with its LinkedIn page and social profiles.

```bash cURL theme={null}
curl -s https://api.tavily.com/search \
  -H "Authorization: Bearer $TAVILY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "monday.com LinkedIn and social profiles"}'
```

```python Python theme={null}
from tavily import TavilyClient

client = TavilyClient(api_key="tvly-YOUR_API_KEY")
response = client.search(query="monday.com LinkedIn and social profiles")
```

```typescript TypeScript theme={null}
import { tavily } from "@tavily/core";

const tvly = tavily({ apiKey: "tvly-YOUR_API_KEY" });
const response = await tvly.search("monday.com LinkedIn and social profiles");
```

Response:

```json wrap theme={null}
{
  "query": "monday.com LinkedIn and social profiles",
  "results": [
    {
      "url": "https://tavily.com/knowledge/company/lY4vcfHfRftv",
      "title": "monday.com",
      "content": "# monday.com\nID: lY4vcfHfRftv\nWebsite: www.monday.com\nLinkedIn: www.linkedin.com/company/mondaydotcom · 354,953 followers\nIndustry: Software Development\nIndustry codes: SIC 73, 737, NAICS 54, 541\nCompany type: Public Company\nFounded: 2012\nSocial profiles: www.facebook.com/mondaydotcom, www.twitter.com/mondaydotcom, ...",
      "score": 0.891
    },
    // ...9 more web results
  ]
}
```

## Read a company record

**1. Spot the record**

A result whose `url` starts with `https://tavily.com/knowledge/company/` is a company record. The ID at the end of the URL stays the same when the record refreshes, so you can store it and look the record up again later.

**2. Check the identity header**

`content` starts with the company name as a Markdown heading (`# monday.com`), then the ID, website, legal name, headquarters and LinkedIn page.

**3. Read the other sections**

Sections vary by company. Each one starts with a `##` heading, such as `## Funding`, `## M&A`, `## Technology` or `## Web traffic`.

**4. Get the full record when you need it**

`/search` returns the header plus the best-matching sections, joined with `[...]`. `/extract` without a `query` returns the full record in `raw_content`.

## Open a company record in your browser

Every company record's `url` is also a public web page. Open it in a browser, with no API key, to see a preview: the company's name, identifiers, a short description and headline firmographics. The full record is available only through the API.

## Best practices

Use the most specific name you have: the domain, or the name plus what the company does.

| Instead of | Write | Why |
| - | - | - |
| `Mercury headquarters` | `mercury.com headquarters` | A domain points to one company. |
| `Linear headquarters` | `Linear app headquarters` | When a company name is also a common word, saying what the company does tells Tavily which one you mean. |

> [!NOTE]
>
> * A shared name can return a different company. Validate the record's website, legal name and headquarters against your input, and drop the record if they don't match.
> * Records appear at `basic` and `advanced` depth, not at `fast` or `ultra-fast`, and with `topic=general` (the default).
> * Any `include_domains` list turns company records off, so you can't limit `/search` to company records. To get one known company, call `/extract` on its record URL.

## Use cases

> [accordion] Enrich a CRM account
>
> Ask for the fields your CRM needs. This query returns Personio's record with its industry, headquarters and founded year.
>
> ```python theme={null}
> response = client.search(query="Personio industry, headquarters and founded year")
> ```

> [accordion] Find the legal entity behind a brand
>
> A brand name is enough to find the registered company. This query returns Mistral AI's record with its legal name, Mistral AI SAS, and its headquarters in Paris.
>
> ```python theme={null}
> response = client.search(query="Mistral AI legal name and headquarters")
> ```

> [accordion] Find a company's parent company
>
> Ask who owns a company. This query returns Wolt's record, which names DoorDash as its parent company.
>
> ```python theme={null}
> response = client.search(query="Wolt parent company")
> ```

> [accordion] Answer one question about a known company
>
> If you have the record URL, pass it to `/extract` with a `query`. The response returns the identity header plus the sections that best answer the query, up to `chunks_per_source` of them. This one returns Rippling's funding rounds, total raised and investors.
>
> ```python theme={null}
> response = client.extract(
>     urls=["https://tavily.com/knowledge/company/gqmLAnqfVL4q"],
>     query="how much has Rippling raised and from which investors",
>     chunks_per_source=3,
> )
> ```

> [accordion] Refresh stored companies on a schedule
>
> Store the record URL from a past search and extract it on your schedule. You get the full current record without searching by name again. This call fetches Notion's record.
>
> ```python theme={null}
> response = client.extract(urls=["https://tavily.com/knowledge/company/7SBmAchUBYYa"])
> ```

## Limits

> [card] Coverage
>
> *Tavily Knowledge - Company* covers 35M+ companies worldwide. If a company's record doesn't come back, name it more specifically or raise `max_results`.

> [card] Freshness
>
> Dated fields, such as funding rounds and acquisitions, show how current each item is.

> [card] No personal contact details
>
> Records do not include personal email addresses or phone numbers. A record can include a company's general contact address, such as `info@`.

## FAQ

> [accordion] Where does the data come from?
>
> *Tavily Knowledge - Company* brings together public data about each company, such as its website, professional and social profiles, funding and acquisition records, and employee reviews, and merges it into one record.

> [accordion] Do I need a new endpoint or parameters?
>
> No. Company records come back from the same `/search` and `/extract` calls you already make.

> [accordion] Do company records cost extra?
>
> No. A request costs the same credits whether or not it returns a record.

> [accordion] Why didn't my query return a record?
>
> Tavily may not have a record for that company, the record may rank below your `max_results` cut, or the request sets `include_domains`, which turns records off. Try the domain or the name plus what the company does, or raise `max_results`. If you have the record URL, call `/extract` on it.

> [accordion] What if the record is the wrong company?
>
> Drop it. Validate the record's website, legal name and headquarters against your input before you use any record.

*Tavily's entity index compiles information from sources on the web. Information may be inaccurate, incomplete, or outdated, and entity resolution may incorrectly associate information with a company. Users should independently verify information before relying on it. To report inaccurate information or exercise your privacy rights, please visit our [Privacy Requests page](https://www.tavily.com/legal/privacy-requests).*
