---
title: "Find by details"
method: POST
path: "/v1/knowledge-graph/companies"
tags: ["Companies"]
---

# Find by details

`POST /v1/knowledge-graph/companies`

Bigdata.com Knowledge Graph tracks over 7 million companies worldwide. Use this endpoint to search by name, website, ticker, or other market identifiers. Refine your results with filters such as company type, country, or sector.

## Request body

- FindCompaniesRequest — Request body for finding companies. Each field is optional. However, you must provide at least one field to perform a valid search.
  - `query` string — It accepts a partial or complete company name, webpage, ticker, ISIN, SEDOL, or CUSIP. Examples: 'Apple', 'AAPL', 'https://www.apple.com/', 'CA03785Y1007'
  - `types` string[] — The company type can be PUBLIC or PRIVATE
  - `countries` string[] — It accepts country codes using the ISO 3166-1 A-2, for instance "US" for the United States
  - `sectors` string[] — It accepts a list of sectors that can be retrieved with the endpoint "/knowledge-graph/companies/sectors"

## Response `200`

Successful response with company data

- FindCompaniesResponse — Response containing company results and metadata
  - `results` Company[], required — Array of company results
    - `id` string, required — Unique company identifier in the Knowledge Graph
    - `name` string, required — Company name
    - `description` string — Company description and business overview
    - `type` 'PUBLIC' | 'PRIVATE', required — Company type classification
    - `country` string, required — Country code (ISO 3166-1 alpha-2)
    - `sector` string — Business sector
    - `industry_group` string — Industry group classification
    - `industry` string — Specific industry classification
    - `favicon` string, uri — Company favicon URL
    - `webpage` string, uri — Company website URL
    - `isin_values` string[] — International Securities Identification Numbers
    - `cusip_values` string[] — Committee on Uniform Securities Identification Procedures numbers
    - `sedol_values` string[] — Stock Exchange Daily Official List numbers
    - `listing_values` string[] — Exchange listing identifiers
    - `ticker` string — Primary ticker symbol
  - `metadata` object, required
    - `request_id` string, required — Unique request identifier
    - `timestamp` string, date-time, required — Response timestamp
  - `usage` Usage
    - `knowledge_graph_tokens` integer, required — Number of tokens consumed by this request.

---

[API](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/revisions/18082de268c4/schema)