Google Finance Autocomplete API
Our Google Finance Autocomplete API allows you to get Google Finance search suggestions for a keyword. Results are grouped the same way as the tabs of the Google Finance search: stocks, indexes, mutual funds, currencies, futures, prediction markets, and private markets. Every result links to the Google Finance API via serpapi_google_finance_link.
The API endpoint is https://serpapi.com/search?engine=google_finance_autocomplete
Head to the playground for a live and interactive demo.
API Parameters
Localization
gl
Optional
Parameter defines the country to use for the Google Finance Autocomplete search. It's a two-letter country code. (e.g., us (default) for the United States, uk for United Kingdom, or fr for France). Head to the Google countries page for a full list of supported Google countries.
Google Finance returns prediction_markets and private_markets only for the United States.
hl
Optional
Parameter defines the language to use for the Google Finance Autocomplete search. It's a two or three-letter language code. (e.g., en (default) for English, es for Spanish, or fr for French), optionally followed by a two-letter or three-digit region code (e.g., en-gb for British English, or es-419 for Latin American Spanish). Head to the Google languages page for a full list of supported Google languages.
Serpapi Parameters
engine
Required
Set parameter to google_finance_autocomplete to use the Google Finance Autocomplete API engine.
no_cache
Optional
Parameter will force SerpApi to fetch the Google Finance Autocomplete results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.
async
Optional
Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.
zero_trace
Optional
Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.
output
Optional
Parameter defines the format of the result. It can be set to json (default) to get a structured JSON of the results, html to get the raw HTML retrieved, or md to get a markdown-formatted version optimized for LLMs and AI agents.
json_restrictor
Optional
Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.
API Results
JSON Results
JSON output includes structured data for Suggestions, Stocks, Indexes, Mutual Funds, Currencies, Futures, Prediction Markets, Private Markets, and ETPs.
A search status is accessible through search_metadata.status.
It flows this way: Processing -> Success || Error.
If a search has failed, error will contain an error message.
search_metadata.id is the search ID inside SerpApi.
HTML Results
This API does not have a full HTML response, only text.
search_metadata.prettify_html_file contains a link to the prettified version of the result.
It is displayed in the playground.
Markdown Results
Markdown output is optimized for LLMs and AI agents. It provides a curated view of the JSON results
in a token-efficient format using tables, markdown links, and YAML frontmatter.
To access, use the output=md parameter, the /search.md endpoint, or request header Accept: text/markdown.
API Examples
Example with q: Apple
{
...
"suggestions": {
"all": [
{
"position": 1,
"type": "stock",
"stock": "AAPL:NASDAQ",
"link": "https://www.google.com/finance/quote/AAPL:NASDAQ",
"serpapi_google_finance_link": "https://serpapi.com/search.json?engine=google_finance&hl=en&q=AAPL%3ANASDAQ",
"name": "Apple Inc",
"kgmid": "/m/07zmbvf",
"exchange": "NASDAQ",
"country": "US",
"price": 339.5,
"currency": "USD",
"price_movement": {
"percentage": 1.0030916,
"value": 3.4400024,
"movement": "Down"
},
"price_date_iso8601": "2026-10-20T20:00:01Z",
"last_updated_iso8601": "2026-10-21T10:39:19Z",
"trading_hours": {
"start_iso8601": "2026-10-20T13:30:00Z",
"end_iso8601": "2026-10-20T20:00:00Z"
}
},
...
{
"position": 4,
"type": "stock",
"stock": "BAC:NYSE",
"link": "https://www.google.com/finance/quote/BAC:NYSE",
"serpapi_google_finance_link": "https://serpapi.com/search.json?engine=google_finance&hl=en&q=BAC%3ANYSE",
"name": "Bank of America Corporation",
"kgmid": "/m/07zlb2g",
"exchange": "NYSE",
"country": "US",
"price": 50.64,
"currency": "USD",
"price_movement": {
"percentage": 0.4961302,
"value": 0.25,
"movement": "Up"
},
"price_date_iso8601": "2026-10-20T20:00:09Z",
"last_updated_iso8601": "2026-10-21T10:38:43Z",
"trading_hours": {
"start_iso8601": "2026-10-20T13:30:00Z",
"end_iso8601": "2026-10-20T20:00:00Z"
}
},
{
"position": 5,
"type": "prediction_market",
"stock": "KXIPHONERELEASE-IPHONE18:KALSHI",
"link": "https://www.google.com/finance/quote/KXIPHONERELEASE-IPHONE18:KALSHI",
"serpapi_google_finance_link": "https://serpapi.com/search.json?engine=google_finance&hl=en&q=KXIPHONERELEASE-IPHONE18%3AKALSHI",
"name": "When will Apple release the iPhone 18?",
"exchange": "KALSHI",
"outcome": "Before April 2027",
"chance": 86.0,
"price_date_iso8601": "2026-10-21T10:18:00Z",
"last_updated_iso8601": "2026-10-21T10:18:00Z"
}
],
"stocks": [
{
"position": 1,
"type": "stock",
"stock": "AAPL:NASDAQ",
"link": "https://www.google.com/finance/quote/AAPL:NASDAQ",
"serpapi_google_finance_link": "https://serpapi.com/search.json?engine=google_finance&hl=en&q=AAPL%3ANASDAQ",
"name": "Apple Inc",
"kgmid": "/m/07zmbvf",
"exchange": "NASDAQ",
"country": "US",
"price": 339.5,
"currency": "USD",
"price_movement": {
"percentage": 1.0030916,
"value": 3.4400024,
"movement": "Down"
},
"price_date_iso8601": "2026-10-20T20:00:01Z",
"last_updated_iso8601": "2026-10-21T10:39:19Z",
"trading_hours": {
"start_iso8601": "2026-10-20T13:30:00Z",
"end_iso8601": "2026-10-20T20:00:00Z"
}
},
...
],
"prediction_markets": [
{
"position": 1,
"type": "prediction_market",
"stock": "KXIPHONERELEASE-IPHONE18:KALSHI",
"link": "https://www.google.com/finance/quote/KXIPHONERELEASE-IPHONE18:KALSHI",
"serpapi_google_finance_link": "https://serpapi.com/search.json?engine=google_finance&hl=en&q=KXIPHONERELEASE-IPHONE18%3AKALSHI",
"name": "When will Apple release the iPhone 18?",
"exchange": "KALSHI",
"outcome": "Before April 2027",
"chance": 86.0,
"price_date_iso8601": "2026-10-21T10:18:00Z",
"last_updated_iso8601": "2026-10-21T10:18:00Z"
},
...
],
"private_markets": [
{
"position": 1,
"type": "private_market",
"stock": "902D61B2-7B70-39FD-A61F-C3A9DC44FE1A:CRUNCHBASE",
"link": "https://www.google.com/finance/quote/902D61B2-7B70-39FD-A61F-C3A9DC44FE1A:CRUNCHBASE",
"serpapi_google_finance_link": "https://serpapi.com/search.json?engine=google_finance&hl=en&q=902D61B2-7B70-39FD-A61F-C3A9DC44FE1A%3ACRUNCHBASE",
"name": "Applecart",
"exchange": "CRUNCHBASE",
"legal_name": "Project Applecart LLC",
"categories": [
"Community and Lifestyle",
"Data and Analytics",
"Information Technology"
],
"latest_insights": "Applecart raised $100M in a new equity funding round from two investors, which brought its total reported equity funding to $107M.",
"logo": "https://images.crunchbase.com/image/upload/t_cb-default-original/3dd5bf87c8b941bb831e8cfe4b46330c"
},
...
]
}
}
Example with q: Bitcoin
Futures have their contract month in date_iso8601. Futures without a price on Google Finance have no price, currency, price_movement, or price_date_iso8601. Currency pairs have both of their currencies in from and to.
{
...
"suggestions": {
...
"currencies": [
...
{
"position": 3,
"type": "currency",
"stock": "BSV-USD1",
"link": "https://www.google.com/finance/quote/BSV-USD1",
"serpapi_google_finance_link": "https://serpapi.com/search.json?engine=google_finance&hl=en&q=BSV-USD1",
"name": "Bitcoin SV / World Liberty Financial USD",
"kgmid": "/g/11yznjrdxp",
"from": {
"currency": "BSV",
"name": "Bitcoin SV",
"kgmid": "/g/11xf7r8w4g"
},
"to": {
"currency": "USD1",
"name": "World Liberty Financial USD",
"kgmid": "/g/11yznjm6ss"
},
"price": 16.7268726873,
"price_movement": {
"percentage": 8.021597,
"value": 1.2421242125,
"movement": "Up"
},
"price_date_iso8601": "2026-02-25T20:33:00Z",
"last_updated_iso8601": "2026-02-25T20:33:00Z"
},
...
],
"futures": [
{
"position": 1,
"type": "futures",
"stock": "BTEM27:CME",
"link": "https://www.google.com/finance/quote/BTEM27:CME",
"serpapi_google_finance_link": "https://serpapi.com/search.json?engine=google_finance&hl=en&q=BTEM27%3ACME",
"name": "BITCOIN EURO FUTURES",
"kgmid": "/g/11ysffwl13",
"exchange": "CME",
"date_iso8601": "2027-06-01T00:00:00Z",
"last_updated_iso8601": "2026-10-20T23:14:18Z"
},
...
{
"position": 3,
"type": "futures",
"stock": "BTCX26:CME",
"link": "https://www.google.com/finance/quote/BTCX26:CME",
"serpapi_google_finance_link": "https://serpapi.com/search.json?engine=google_finance&hl=en&q=BTCX26%3ACME",
"name": "Bitcoin Futures",
"kgmid": "/g/11z7kjrs7v",
"exchange": "CME",
"date_iso8601": "2026-11-01T00:00:00Z",
"price": 83680.0,
"currency": "USD",
"price_movement": {
"percentage": 0.89221126,
"value": 740.0,
"movement": "Up"
},
"price_date_iso8601": "2026-10-21T10:17:55Z",
"last_updated_iso8601": "2026-10-21T10:29:25Z"
},
...
],
...
"etps": [
{
"position": 1,
"type": "etp",
"stock": "BTCA-EUR:SWX",
"link": "https://www.google.com/finance/quote/BTCA-EUR:SWX",
"serpapi_google_finance_link": "https://serpapi.com/search.json?engine=google_finance&hl=en&q=BTCA-EUR%3ASWX",
"name": "Bitcoin Capital Active ETP",
"kgmid": "/g/11nrzt2gkg",
"exchange": "SWX",
"country": "CH",
"price": 179.28,
"currency": "EUR",
"price_movement": {
"percentage": 0.0,
"value": 0.0
},
"price_date_iso8601": "2026-09-23T08:03:10Z",
"last_updated_iso8601": "2026-10-21T10:03:30Z",
"trading_hours": {
"start_iso8601": "2026-09-23T07:00:00Z",
"end_iso8601": "2026-09-23T15:30:00Z"
}
}
]
}
}
Example with q: Bank, gl: de, and hl: de
The gl and hl parameters localize the results. Google Finance returns prediction_markets and private_markets only for gl: us.
{
...
"suggestions": {
"all": [
{
"position": 1,
"type": "stock",
"stock": "BANK:IDX",
"link": "https://www.google.com/finance/quote/BANK:IDX",
"serpapi_google_finance_link": "https://serpapi.com/search.json?engine=google_finance&hl=de&q=BANK%3AIDX",
"name": "Bank Aladin Syariah Tbk PT",
"kgmid": "/g/11qwq5_1k0",
"exchange": "IDX",
"country": "ID",
"price": 238.0,
"currency": "IDR",
"price_movement": {
"percentage": 0.0,
"value": 0.0
},
"price_date_iso8601": "2026-10-15T09:14:34Z",
"last_updated_iso8601": "2026-10-15T09:40:00Z",
"trading_hours": {
"start_iso8601": "2026-10-15T02:00:00Z",
"end_iso8601": "2026-10-15T09:00:00Z"
}
},
{
"position": 2,
"type": "stock",
"stock": "BKFCF:OTCMKTS",
"link": "https://www.google.com/finance/quote/BKFCF:OTCMKTS",
"serpapi_google_finance_link": "https://serpapi.com/search.json?engine=google_finance&hl=de&q=BKFCF%3AOTCMKTS",
"name": "Bank of Communications",
"kgmid": "/g/1dt_jt_r",
"exchange": "OTCMKTS",
"country": "US",
"price": 1.085076,
"currency": "USD",
"price_movement": {
"percentage": 0.0,
"value": 0.0
},
"price_date_iso8601": "2026-09-30T15:51:09Z",
"last_updated_iso8601": "2026-10-15T04:18:24Z",
"trading_hours": {
"start_iso8601": "2026-09-30T13:30:00Z",
"end_iso8601": "2026-09-30T20:00:00Z"
}
},
{
"position": 3,
"type": "stock",
"stock": "CITI:VIE",
"link": "https://www.google.com/finance/quote/CITI:VIE",
"serpapi_google_finance_link": "https://serpapi.com/search.json?engine=google_finance&hl=de&q=CITI%3AVIE",
"name": "Citigroup",
"kgmid": "/g/11f5vclq2s",
"exchange": "VIE",
"country": "AT",
"price": 110.18,
"currency": "EUR",
"price_movement": {
"percentage": 0.70295495,
"value": 0.7799988,
"movement": "Down"
},
"price_date_iso8601": "2026-10-15T11:00:38Z",
"last_updated_iso8601": "2026-10-15T11:00:38Z",
"trading_hours": {
"start_iso8601": "2026-10-15T06:54:00Z",
"end_iso8601": "2026-10-15T15:36:00Z"
}
},
...
],
...
}
}
JSON Structure Overview
{
...
"suggestions": {
"all": [
{
"position": "Integer - Position of the result in the list",
"type": "String - Can be 'stock', 'index', 'mutual_fund', 'currency', 'futures', 'etp', 'prediction_market', 'private_market', or 'other' (e.g. closed-end funds and exchange-traded notes, only in 'all')",
"stock": "String - Ticker symbol or Google Finance quote ID",
"link": "String - Google Finance URL",
"serpapi_google_finance_link": "String - SerpApi Google Finance API URL",
"name": "String - Company or asset name, or the question of the prediction market",
"kgmid": "String - Knowledge Graph ID",
"from": {
"currency": "String - Code of the first currency of the currency pair (e.g. 'BTC' in 'BTC-USD')",
"name": "String - Name of the currency",
"kgmid": "String - Knowledge Graph ID of the currency"
},
"to": {
"currency": "String - Code of the second currency of the currency pair (e.g. 'USD' in 'BTC-USD')",
"name": "String - Name of the currency",
"kgmid": "String - Knowledge Graph ID of the currency"
},
"exchange": "String - Exchange name",
"country": "String - Country code of the exchange",
"date_iso8601": "String - First day of the contract month of the futures in ISO8601 UTC format",
"price": "Float - Current price",
"currency": "String - Currency code",
"price_movement": {
"percentage": "Float - Price change percentage",
"value": "Float - Absolute price change",
"movement": "String - Can be 'Up' or 'Down'"
},
"outcome": "String - Leading outcome of the prediction market",
"chance": "Float - Chance of the leading outcome in percent",
"price_date_iso8601": "String - Date and time of the price or chance in ISO8601 UTC format",
"last_updated_iso8601": "String - Date and time the quote was last updated in ISO8601 UTC format",
"trading_hours": {
"start_iso8601": "String - Start of the regular trading session in ISO8601 UTC format",
"end_iso8601": "String - End of the regular trading session in ISO8601 UTC format"
},
"legal_name": "String - Legal name of the private company",
"categories": [
"String - Industry category of the private company (e.g. 'Information Technology')"
],
"latest_insights": "String - AI-generated summary of recent developments at the private company (e.g. funding rounds)",
"logo": "String - URL of the private company logo"
},
...
],
"stocks": [
// same structure as `all`
],
"indexes": [
// same structure as `all`
],
"mutual_funds": [
// same structure as `all`
],
"currencies": [
// same structure as `all`
],
"futures": [
// same structure as `all`
],
"prediction_markets": [
// same structure as `all`
],
"private_markets": [
// same structure as `all`
],
"etps": [
// same structure as `all`
]
}
}