Profile API

Retrieve company profile data: symbol, company name, CIK, exchange, outstanding shares, latest EOD close price, market cap, sector, industry, country, country flag emoji, type, and optional tags.

GET /v1/profile/{symbol}

Quick Copy & Paste

https://api.earningsapi.com/v1/profile/AAPL?apikey=YOUR_API_KEY

Parameters

Path

Parameter	Type	Required	Description
`symbol`	string	Yes	Stock ticker in path (e.g. /v1/profile/AAPL)

Query

Parameter	Type	Required	Description
`apikey`	string	Yes	Your API key

Response Example

{
  "symbol": "AAPL",
  "companyName": "Apple Inc.",
  "cik": "0000320193",
  "exchange": "NASDAQ",
  "outstandingShares": 14697925711,
  "price": 252.62,
  "marketCap": 3712989993113,
  "sector": "Technology",
  "industry": "Computer Manufacturing",
  "country": "United States",
  "countryEmoji": "🇺🇸",
  "type": "equity",
  "tags": []
}

Response Fields

The response is a single object. type is one of: equity, fund, non_equity, other. tags may include: adr, etf, etn, reit, preferred, warrant, right, unit, spac.

Field	Type	Description
`symbol`	string	Stock ticker symbol
`companyName`	string	Company name
`cik`	string	SEC Central Index Key (CIK)
`exchange`	string	Primary exchange (e.g. NASDAQ, NYSE)
`outstandingShares`	number	Total outstanding shares
`price`	number	Latest EOD close price
`marketCap`	number	Market capitalization
`sector`	string	Sector (e.g. Technology)
`industry`	string	Industry (e.g. Computer Manufacturing)
`country`	string	Country name (e.g. United States)
`countryEmoji`	string	Country flag emoji for display
`type`	string	One of: equity, fund, non_equity, other
`tags`	array	Optional tags: adr, etf, etn, reit, preferred, warrant, right, unit, spac

type and tags

type

equity, fund, non_equity, other

tags (optional)

adr, etf, etn, reit, preferred, warrant, right, unit, spac

cURL Example

curl "https://api.earningsapi.com/v1/profile/AAPL?apikey=YOUR_API_KEY"

Rate Limiting

Free tier: 1,000 requests / month
429 returned when limit is exceeded