POST
/
v1
/
knowledge-graph
/
companies
/
listing
Get Companies by Listing
curl --request POST \
  --url https://api.bigdata.com/v1/knowledge-graph/companies/listing \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "values": [
    "XNAS:AAPL"
  ]
}'
{
  "results": {
    "US0378331005": {
      "id": "D8442A",
      "name": "Apple Inc.",
      "description": "Apple Inc. (formerly Apple Computer Inc.), incorporated on January 03, 1977, designs, manufactures, and markets mobile communication and media devices, personal computing products, and portable digital music players worldwide.",
      "type": "PUBLIC",
      "country": "US",
      "sector": "Technology",
      "industry_group": "Computer Hardware",
      "industry": "Computer Hardware",
      "favicon": "http://www.apple.com/favicon.ico",
      "webpage": "http://www.apple.com",
      "isin_values": [
        "CA03785Y1007",
        "TH0150120408",
        "TH0809121500",
        "US0378331005"
      ],
      "cusip_values": [
        "037833100",
        "03785Y100",
        "P0R684385",
        "Y100G4352",
        "Y49876132"
      ],
      "sedol_values": [
        "2046251",
        "BNC31R1",
        "BPXWT99",
        "BVBDDG1"
      ],
      "listing_values": [
        "XBKK:AAPL80",
        "XNAS:AAPL"
      ]
    }
  },
  "metadata": {
    "request_id": "user_2nHybch9ZH2eWyGykznCeRxsk4G",
    "timestamp": "2025-09-30T12:03:24.732779+00:00"
  }
}

Authorizations

​
X-API-KEY
string
header
required

Body

application/json

Request body for listing lookups

​
values
string[]
required

Array of listing codes. Listing format: Combination of Market Identifier Code (MIC) and company ticker separated by ":"

Example:
["XNAS:AAPL"]

Response

200 - application/json

Successful response with company data mapped by listing

Response containing company data mapped by market identifiers

​
results
object
required

Object containing market identifiers as keys and company data as values

Example:
{
  "US0378331005": {
    "id": "D8442A",
    "name": "Apple Inc.",
    "description": "Apple Inc. (formerly Apple Computer Inc.), incorporated on January 03, 1977, designs, manufactures, and markets mobile communication and media devices, personal computing products, and portable digital music players worldwide.",
    "type": "PUBLIC",
    "country": "US",
    "sector": "Technology",
    "industry_group": "Computer Hardware",
    "industry": "Computer Hardware",
    "favicon": "http://www.apple.com/favicon.ico",
    "webpage": "http://www.apple.com",
    "isin_values": [
      "CA03785Y1007",
      "TH0150120408",
      "TH0809121500",
      "US0378331005"
    ],
    "cusip_values": [
      "037833100",
      "03785Y100",
      "P0R684385",
      "Y100G4352",
      "Y49876132"
    ],
    "sedol_values": ["2046251", "BNC31R1", "BPXWT99", "BVBDDG1"],
    "listing_values": ["XBKK:AAPL80", "XNAS:AAPL"]
  }
}
​
metadata
object
required