Company Data (Search)

GET/v1/companydata/search

Fuzzy search across Vantafin’s ticker universe by company name, ticker prefix or CIK. Results are ranked for relevance and capped by limit (default 20, max 100). Each match returns the same company data fields as Company Data (Ticker) - sector, industry, exchange, CIK, ISIN, CUSIP, website, description, CEO, employees, address and IPO date - so you can resolve a name like “Apple” to AAPL and use the data immediately without a second request.

Use cases

Ticker lookup and autocomplete in chat or search UIs
Resolving user-entered company names to tickers
Quick issuer discovery during research workflows
CIK-based lookup when only regulatory id is known

Input parameters

Required

Parameter	Type	Description
query(*)	string	Search text.
limit	integer	Max results, 1-100 (default 20).

Output parameters

Field	Type	Description
results	array	Matching company profiles ranked by relevance.
results[].ticker	string	Ticker.
results[].company	string	Company or fund name.
results[].sector	string	GICS sector when available.
results[].industry	string	Industry classification.
results[].exchange	string	Primary listing exchange.
results[].exchangeCode	string	Short exchange code.
results[].country	string	Country of incorporation or domicile.
results[].etf	boolean	True when the ticker is an ETF.
results[].fund	boolean	True when the ticker is a mutual fund.
results[].cik	string	SEC Central Index Key.
results[].isin	string	International Securities Identification Number.
results[].cusip	string	CUSIP identifier.
results[].website	string	Issuer website URL.
results[].description	string	Business description or fund summary.
results[].ceo	string	Chief executive officer when available.
results[].employees	string	Employee count when available.
results[].phone	string	Company phone number.
results[].address	string	Street address.
results[].city	string	City.
results[].state	string	State or region.
results[].zip	string	Postal code.
results[].ipo	string	IPO date (YYYY-MM-DD) when known.
count	integer	Number of matches returned.

from vantafin import RESTClient

client = RESTClient("vf-live-your_api_key")

result = client.search("apple", limit=10)

print(result)

Official SDKs (Python, JavaScript, Go, Java, Ruby): github.com/vantafin/vantafin

{
  "results": [
    {
      "ticker": "AAPL",
      "company": "Apple Inc.",
      "sector": "Technology",
      "industry": "Consumer Electronics",
      "exchange": "NASDAQ Global Select",
      "exchangeCode": "NASDAQ",
      "country": "US",
      "etf": false,
      "fund": false,
      "cik": "0000320193",
      "isin": "US0378331005",
      "cusip": "037833100",
      "website": "https://www.apple.com",
      "description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories worldwide.",
      "ceo": "Timothy D. Cook",
      "employees": "164000",
      "phone": "(408) 996-1010",
      "address": "One Apple Park Way",
      "city": "Cupertino",
      "state": "CA",
      "zip": "95014",
      "ipo": "1980-12-12"
    }
  ],
  "count": 1
}

Parameter

Type

Description

query(*)

string

Search text.

limit

integer

Max results, 1-100 (default 20).

Field

Type

Description

results

array

Matching company profiles ranked by relevance.

results[].ticker

string

Ticker.

results[].company

string

Company or fund name.

results[].sector

string

GICS sector when available.

results[].industry

string

Industry classification.

results[].exchange

string

Primary listing exchange.

results[].exchangeCode

string

Short exchange code.

results[].country

string

Country of incorporation or domicile.

results[].etf

boolean

True when the ticker is an ETF.

results[].fund

boolean

True when the ticker is a mutual fund.

results[].cik

string

SEC Central Index Key.

results[].isin

string

International Securities Identification Number.

results[].cusip

string

CUSIP identifier.

results[].website

string

Issuer website URL.

results[].description

string

Business description or fund summary.

results[].ceo

string

Chief executive officer when available.

results[].employees

string

Employee count when available.

results[].phone

string

Company phone number.

results[].address

string

Street address.

results[].city

string

City.

results[].state

string

State or region.

results[].zip

string

Postal code.

results[].ipo

string

IPO date (YYYY-MM-DD) when known.

count

integer

Number of matches returned.

{ "results": [ { "ticker": "AAPL", "company": "Apple Inc.", "sector": "Technology", "industry": "Consumer Electronics", "exchange": "NASDAQ Global Select", "exchangeCode": "NASDAQ", "country": "US", "etf": false, "fund": false, "cik": "0000320193", "isin": "US0378331005", "cusip": "037833100", "website": "https://www.apple.com", "description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories worldwide.", "ceo": "Timothy D. Cook", "employees": "164000", "phone": "(408) 996-1010", "address": "One Apple Park Way", "city": "Cupertino", "state": "CA", "zip": "95014", "ipo": "1980-12-12" } ], "count": 1 }

Docs

Company Data (Search)

Input parameters

Output parameters

Docs

Company Data (Search)

Input parameters

Output parameters