Google Finance

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
q	string	Yes	Search query, supports regular Google search syntax (like inurl:, site:, intitle:) and advanced search parameters
window	string	No	Parameter is used for setting time range for the graph. It can be set to: 1D - 1 Day(default), 5D - 5 Days, 1M - 1 Month, 6M - 6 Months, YTD - Year to Date, 1Y - 1 Year, 5Y - 5 Years, MAX - Maximum
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/quote/GOOGL:NASDAQ",
      "status": "Success"
    },
    "search_information": {
      "time_taken_displayed": 0.076,
    },
    "search_parameters": {
      "engine": "google_finance",
      "html": "0",
      "google_domain": "www.google.com",
      "q": "GOOGL:NASDAQ"
    },
    "knowledge_graph": {
      "key_stats": {
          "tags": [
              {
                  "text": "Stock",
                  "description": "Ownership of a fraction of a corporation and the right to claim a share of the corporation's assets and profits equal to the amount of k owned"
              }
          ],
          "stats": [
              {
                  "label": "Previous close",
                  "description": "The last closing price",
                  "value": "$180.01"
              }
          ]
      },
      "about": [
          {
              "title": "About",
              "description": {
                  "snippet": "Nvidia Corporation is an American technology company headquartered in Santa",
                  "link": "https://en.wikipedia.org/wiki/Nvidia",
                  "link_text": "Wikipedia"
              },
              "info": [
                  {
                      "label": "CEO",
                      "value": "Jensen Huang",
                      "link": "https://www.google.com/search?q=Jensen%20Huang&hl=en"
                  }
              ]
          }
      ]
    },
    "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": "Absolutely' a market bubble: Wall Street sounds the alarm on AI-driven boom as investors go all in",
            "link": "https://finance.yahoo.com/news/absolutely-a-market-bubble-wall-street-sounds-the-alarm-on-ai-driven-boom-as-investors-go-all-in-200449201.html",
            "source": "Yahoo Finance",
            "date": "23 hours ago",
            "thumbnail": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRFew0J8C7_ZbTWbxBvVn0yRfJakVOqXzoyhC2BpCwbTzcWooz69NED4Vwuy pw"
        }
    ],
    "discover_more": [
        {
            "title": "You may be interested in",
            "items": [
                {
                    "stock": "TOPGLOV:KLSE",
                    "link": "https://www.google.com/finance/quote/TOPGLOV:KLSE",
                    "name": "Top Glove Corporation Bhd",
                    "price": "RM 0.69",
                    "extracted_price": "RM 0.69",
                    "price_movement": {
                        "percentage": "0.73%",
                        "movement": "Up"
                    }
                }
            ]
        }
    ],
    "summary": {
        "title": "NVIDIA Corp",
        "stock": "NVDA",
        "exchange": "NASDAQ",
        "price": "$179.83",
        "extracted_price": "179.83",
        "currency": "$",
        "market": {
            "trading": "After Hours",
            "price": "$180.82",
            "extracted_price": "180.82",
            "currency": "$",
            "price_movement": {
                "percentage": "0.55%",
                "value": "0.99",
                "movement": "Up"
            }
        },
        "extensions": [
            "Closed: Oct 15, 7:59:55 PM GMT-4",
            "USD",
            "NASDAQ",
            ""
        ]
    },
    "graph": [
        {
            "price": 184.77,
            "currency": "USD",
            "date": "2025/10/15,9:30",
            "volume": 1642406
        }
    ],
    "financials": [
        {
            "title": "Income Statement",
            "results": [
                {
                    "data": "2025/7/27",
                    "period_type": "Quarterly"
                }
            ]
        }
    ]
  }
}

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
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	Applicable Terminal
q	string	‌Keywords used for this query
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

knowledge_graph

object Integrates multidimensional structured knowledge related to financial entities (such as listed companies, stocks, industries) to systematize the presentation of financial information.

Parameter	Type	Description	Applicable Terminal
key_stats	object	A repository of core statistical information comprising relevant concept tags and key statistical metrics
key_stats.tags	object[]	An array of relevant concept tags, with each element being a tag object
key_stats.tags[].text	string	The textual content of the tag object
key_stats.tags[].description	string	Detailed specifications of the tag object
key_stats.stats	object[]	An array of key statistical metrics, with each element being a metric object.
key_stats.stats[].label	string	The name of the metric object
key_stats.stats[].description	string	Description of the metric object
key_stats.stats[].value	string	The numerical value of the metric object
about	object[]	‌Basic information of the entity (e.g., enterprises, entities)
about[].title	string	‌Information section title
about[].description	object	A collection of brief introduction information of the entity
about[].description.snippet	string	Entity summary snippet
about[].description.link	string	Summary source link
about[].description.link_text	string	Link display text
about[].info	obejct[]	Array of entity key attributes, each element is a property object
about[].info[].label	string	Property label
about[].info[].value	string	Property value
about[].info[].link	string	Property details link

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
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[] ‌Financial market and securities news (stocks, indices)

Parameter	Type	Description	Applicable Terminal
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)

discover_more

object[] The correlation logic between user interest preferences and the financial market, enabling personalized recommendations of potentially interesting financial assets

Parameter	Type	Description	Applicable Terminal
title	string	Title of the recommendation section, indicating the theme of the recommended content
items	object[]	Specific list of recommended financial assets
items[].stock	string	Unique identifier of the financial asset
items[].link	string	Link to the detailed page of the financial asset on Google Finance
items[].name	string	Financial asset name
items[].price	string	Current price of the financial asset
items[].extracted_price	string	Extracted 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

summary

object Aggregated snapshot-style presentation of key information about financial instruments (such as stocks, indices, etc.)

Parameter	Type	Description	Applicable Terminal
title	string	Company or Instrument Name
stock	string	Ticker symbol
exchange	string	Stock exchange
price	string	Current stock price (with currency symbol)
extracted_price	string	Extracted raw price value
currency	string	Currency symbol
market	object	Collection of market trading information
market.trading	string	Trading hours
market.price	string	After-hours trading price
market.extracted_price	string	Raw after-hours trading price
market.currency	string	After-hours trading currency symbol
market.price_movement	object	Collection of after-hours price change data
market.price_movement.percentage	string	Percentage change in price
market.price_movement.value	string	Absolute value of price change
market.price_movement.movement	string	Direction of price change
extensions	string[]	Extended information array containing additional auxiliary data

graph

object[] Visualize the price trends and trading data of financial instruments (such as stocks, indices, etc.)

Parameter	Type	Description	Applicable Terminal
price	number	Price value of financial instruments (such as stocks, indices, etc.) at the corresponding date and time
currency	string	Currency type used for the price
date	string	Specific date and time corresponding to the price
volume	number	Trading volume of the financial instrument at the corresponding date and time

financials

object[] (Financial module) Integrate and present detailed financial data of publicly listed companies

Parameter	Type	Description	Applicable Terminal
title	string	Financial report heading
results	object[]	Financial report result set
results[].data	string	Date corresponding to the financial data
results[].period_type	string	Reporting period type of financial data