Skip to content

Google Finance Markets

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"

Request Example

curl -X POST "https://domain/api/v1/open/search" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "your_api_key_here",
    // ...
  }'

Response Format

All responses follow a standardized JSON structure:

{
  "code": 200,
  "msg": "Success",
  "reqId": "req_1234567890",
  "timestamp": "2025-01-08T10:30:00Z",
  "data": {
    // Response data object
  }
}

HTTP Status Codes

Code Status Description Retry
200 OK Request successful 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
gl string No Search country code (e.g., us-United States, uk-United Kingdom, fr-France). Head to the Google countries page for a full list of supported Google countries.
hl string No Search language code (e.g., en-English, es-Spanish, fr-French). Head to the Google languages page for a full list of supported Google languages.
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 Applicable Terminal
id string Unique identifier for the search request desktop
json_endpoint string Provide an interface endpoint for searching related JSON data, through which JSON-formatted search data can be obtained desktop
created_at string The timestamp when the search request was created, recording the time when the search was initiated desktop
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 desktop
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 desktop
status string Status of the search execution (e.g., Success) desktop
raw_html_file string Identifier for the original HTML file desktop
total_time_taken number The total time spent on the entire search process (including request sending, result parsing, and other stages) desktop

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) desktop

search_parameters

object Contains the parameters used for the search

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

markets

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

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

news_results

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

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

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

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

discover_more

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

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