Google Finance Markets

Perform Search

Overview

Method	Endpoint	Version	Description
`POST`	`/api/v1/open/search`	v1	Google Search API endpoint for retrieving search results

Request Headers

Header	Type	Required	Description
`Content-Type`	`string`	Yes	Must be set to `application/json`
`Accept`	`string`	No	Response format (defaults to `application/json`)

Authentication

API Key Authentication

Pass the API key as a request parameter: api_key=your_api_key
Example: "api_key": "your_api_key_here"

HTTP Status Codes

Code	Status	Description	Retry
200	OK	Request successful	No

Response Codes

Code	Description	Retry
200	Request successful	No
400100	Unsupported search engine	No
400200	The search service is temporarily unavailable. Please try again later	No
400300	ForUserQuery contains prohibited content	No
400400	No results found, please adjust keywords and try again	No
400500	Authorization failed, please check your API credentials	No
400600	The request frequency is too high, please try again later	No
400700	You have reached the daily search limit	No
400710	Insufficient Balance	No

Request Parameters

Parameter	Type	Required	Description	Default
`api_key`	`string`	Yes	API key for authentication
`engine`	`string`	Yes	Search engine type, currently engine value is `google_finance`	google
`trend`	`string`	Yes	Parameter is used for retrieving different market trends. Available options: indexes - Market indexes, most-active - Most active, gainers - Gainers, losers - Losers, climate-leaders - Climate leaders, cryptocurrencies - Crypto, currencies - Currencies
`index_market`	`string`	No	Parameter is used for expanding market indexes by region and retrieving more results. Available options: americas - Americas europe-middle-east-africa - Europe, Middle East, and Africa asia-pacific - Asia Pacific Parameter can be used only when trend parameter is set to: indexes.
`html`	`string`	No	Whether to return HTML format, 1-yes, 0-no	0

Response Example

{
  "reqId": "1984168106343272448",
  "code": 200,
  "msg": "OK",
  "data": {
    "search_metadata": {
      "raw_html_file": "oss_html",
      "total_time_taken": 2.068001541,
      "id": "1984168106343272448",
      "json_endpoint": "oss_json",
      "created_at": "2025-10-31 15:58:35",
      "processed_at": "2025-10-31 15:58:39",
      "google_url": "https://www.google.com/finance/markets/indexes/americas?",
      "status": "Success"
    },
    "search_information": {
      "time_taken_displayed": 0.076,
    },
    "search_parameters": {
      "engine": "google_markets_finance",
      "html": "0",
      "google_domain": "www.google.com",
      "trend": "indexes"
    },
    "markets": {
        "us": [
            {
                "stock": ".DJI:INDEXDJX",
                "link": "https://www.google.com/finance/quote/.DJI:INDEXDJX",
                "name": "Dow Jones",
                "price": 46253.31,
                "price_movement": {
                    "percentage": "0.03706975",
                    "value": "17.152344",
                    "move": "Down"
                }
            }
        ]
    },
    "news_results": [
      {
        "snippet": "Stock market today: Dow jumps 600 points, S&P 500, Nasdaq soar as Wall Street rebound from tariff-fueled rout",
        "link": "https://finance.yahoo.com/news/live/stock-market-today-dow-sp-500-nasdaq-stage-comeback-as-trump-tempers-tariff-talk-toward-china-231010620.html",
        "source": "Yahoo Finance",
        "date": "3 days ago",
        "thumbnail": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQtAyBRYiIEisGpYbrBwibi7qP78mqvlu-uQfprO4MHG5EjegJ9byfTND0X50M",
        "stocks": [
          {
            "name": "S&P 500",
            "link": "https://www.google.com/finance/quote/.INX:INDEXSP",
            "stock": ".INX:INDEXSP",
            "price_movement": {
              "percentage": "0.63%",
              "movement": "Down"
            }
          }
        ]
      }
    ],
    "market_trends": [
      {
        "title": "Americas",
        "results": [
          {
            "stock": ".INX:INDEXSP",
            "link": "https://www.google.com/finance/quote/.INX:INDEXSP",
            "name": "S&P 500",
            "price": "6,629.07",
            "extracted_price": "6,629.07",
            "price_movement": {
              "percentage": "0.63%",
              "value": "41.99",
              "movement": "Down"
            }
          }
        ]
      }
    ],
    "discover_more": [
        {
            "title": "You may be interested in",
            "items": [
                 {
                  "stock": "SSET:INDEXBKK",
                  "link": "https://www.google.com/finance/quote/SSET:INDEXBKK",
                  "name": "SET Index",
                  "price": "591.34",
                  "extracted_price": "591.34",
                  "price_movement": {
                    "percentage": "1.22%",
                    "movement": "Down"
                  }
                }
            ]
        }
    ]
  }
}

Complete Response Parameters Overview

search_metadata

object Contains metadata about the search execution

Parameter	Type	Description
`id`	`string`	Unique identifier for the search request
`json_endpoint`	`string`	Provide an interface endpoint for searching related JSON data, through which JSON-formatted search data can be obtained
`created_at`	`string`	The timestamp when the search request was created, recording the time when the search was initiated
`processed_at`	`string`	The timestamp when the search results were processed and became available for return, recording the time point from processing to completion of the search
`google_url`	`string`	The Google search URL, which contains the search keyword "coffee" along with language parameters (hl=en for English), regional parameters (gl=us for the United States), and other search parameters, used to redirect to the corresponding Google search page
`status`	`string`	Status of the search execution (e.g., Success)
`raw_html_file`	`string`	Identifier for the original HTML file
`total_time_taken`	`number`	The total time spent on the entire search process (including request sending, result parsing, and other stages)

search_information

object Contains information about the search results

Parameter	Type	Description	Applicable Terminal
`time_taken_displayed`	`number`	TDisplay time (i.e., the time spent on displaying the search results)

search_parameters

object Contains the parameters used for the search

Parameter	Type	Description
`trend`	`string`	Section options of Google Finance Markets
`engine`	`string`	Search engine used for this query (e.g., google_web)
`google_domain`	`string`	Specifies the corresponding Google domain (e.g., google.com, etc., used to distinguish Google services in different regions/locales)
`html`	`string`	When HTML=0, returns JSON; when HTML=1, returns HTML; when HTML=2, returns both JSON and HTML

markets

object Real-time market data‌: including key metrics such as stock price, change, intraday high/low points, market cap

Parameter	Type	Description
`stock`	`string`	‌Stock/index identifier
`link`	`string`	‌Link to the Google Finance detail page for stock/index
`name`	`string`	‌Stock/index name
`price`	`string`	‌Stock/index price
`price_movement`	`object`	Price change data collection
`price_movement.percentage`	`string`	‌Percentage change
`price_movement.value`	`string`	Absolute change
`price_movement.move`	`string`	Direction of price change

news_results

object[] News results related to the financial markets, including headlines, links, publication time, and other details

Parameter	Type	Description
`snippet`	`string`	Summary snippet of the news, used to quickly present the core content of the article
`link`	`string`	Web link to the original news article, redirecting to the full news page
`source`	`string`	Source of the content (e.g., website name, media platform, or other origin identifiers)
`date`	`string`	Content date (publication date or update date, typically in "YYYY-MM-DD" format)
`thumbnail`	`string`	Thumbnail link (URL of small-sized preview image related to the content, used for quick visual recognition, including data:image/png;base64)
`stocks`	`object[]`	Array of financial instruments related to the news
`stocks[].name`	`string`	Name of financial instruments such as stocks
`stocks[].link`	`string`	Link to the stock’s detail page on Google Finance, where more information can be viewed
`stocks[].stock`	`string`	Identifier code of financial instruments such as stocks
`stocks[].price_movement`	`object`	Object containing stock price change information, including percentage change and direction
`stocks[].price_movement.percentage`	`string`	Percentage change in stock price
`stocks[].price_movement.movement`	`string`	Direction of stock price change

market_trends

object[] Trend-related data, such as overall market movement and popular sector trends

Parameter	Type	Description
`title`	`string`	Title of the market trends section
`results`	`object[]`	Array of specific market trend results
`results[].stock`	`string`	Identifier code of specific financial instruments such as stocks and indices
`results[].link`	`string`	Link to the financial instrument’s detail page on Google Finance
`results[].name`	`string`	Title of the financial instrument
`results[].price`	`string`	Latest price of the financial instrument
`results[].extracted_price`	`string`	Extracted raw price value
`results[].price_movement`	`object`	Object containing price change information
`results[].price_movement.percentage`	`string`	Percentage change
`results[].price_movement.value`	`string`	Specific value of the price change
`results[].price_movement.movement`	`string`	Direction of the price change

discover_more

object[] Entry point or information hub for financial market content, including recommendations and feature guidance

Parameter	Type	Description
`title`	`string`	Indicate the theme of this section
`items`	`object[]`	Collection of preferred financial instruments
`items[].stock`	`string`	Symbol representing financial instruments like equities and indexes
`items[].link`	`string`	URL to the Google Finance profile of the financial instrument
`items[].name`	`string`	Title of the financial instrument
`items[].price`	`string`	Latest price of the financial instrument
`items[].extracted_price`	`string`	Extracted pure price value
`items[].price_movement`	`object`	Collection of price change data
`items[].price_movement.percentage`	`string`	Percentage change in price
`items[].price_movement.movement`	`string`	Direction of price change