Skip to main content
GET
/
api
/
us
/
v0
/
companies
Companies List
curl --request GET \
  --url https://stockinsights-ai-us-main-f5fd25a.zuplo.app/api/us/v0/companies \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "data": [
    {
      "id": "<string>",
      "cik": "0000320193",
      "company_name": "<string>",
      "company_website": "<string>",
      "ticker": "<string>",
      "isin": "<string>",
      "marketcap_category": "<string>",
      "industry_info": {
        "macro": "<string>",
        "sector": "<string>",
        "industry": "<string>",
        "basic_industry": "<string>"
      },
      "exchange_info": [
        {
          "exchange": "NYSE",
          "symbol": "<string>",
          "url": "<string>"
        }
      ]
    }
  ],
  "meta": {
    "total_count": 123,
    "page": 123,
    "limit": 123
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
ticker
string

Comma-separated ticker values. Plain tickers (e.g. AAPL) match the primary stock ticker. Exchange-prefixed values such as NASDAQ:AAPL are accepted and match by ticker symbol.

​
cik
string

Comma-separated CIK values to filter by. CIKs should include leading zeros when applicable, e.g. 0000320193.

​
sector
string

Comma-separated sectors to filter by, based on US industry classification.

​
industry
string

Comma-separated industries to filter by, based on US industry classification.

​
company_id
string

Comma-separated internal company IDs to filter by. For US companies, this is the full CIK.

​
marketcap_category
string

Comma-separated lowercase market-cap category keys. Client-supported inputs are mega, large, mid, small, micro, and nano.

Pattern: ^(mega|large|mid|small|micro|nano)(,(mega|large|mid|small|micro|nano))*$
​
sort
string

Sort specification as key:order pairs, comma-separated. Supported keys: company_name, marketcap_category. Supported orders: asc, desc. Example: company_name:asc or marketcap_category:desc,company_name:asc.

Pattern: ^((company_name|marketcap_category):(asc|desc))(,((company_name|marketcap_category):(asc|desc)))*$
​
page
integer

Page number for pagination. Defaults to 1.

Required range: x >= 1
​
limit
integer

Number of results per page. Defaults to 10000 (returns all companies).

Required range: x >= 1

Response

Successful response

​
status
enum<string>
Available options:
success
​
data
object[]
​
meta
object