Skip to content

Google Finance

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
q string Yes Search query, supports regular Google search syntax (like inurl:, site:, intitle:) and advanced search parameters
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.
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 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
q string ‌Keywords used for this query 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

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

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 desktop
items object[] Specific list of recommended financial assets desktop
items[].stock string Unique identifier of the financial asset desktop
items[].link string Link to the detailed page of the financial asset on Google Finance desktop
items[].name string Financial asset name desktop
items[].price string Current price of the financial asset desktop
items[].extracted_price string Extracted 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

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 desktop
stock string Ticker symbol desktop
exchange string Stock exchange desktop
price string Current stock price (with currency symbol) desktop
extracted_price string Extracted raw price value desktop
currency string Currency symbol desktop
market object Collection of market trading information desktop
market.trading string Trading hours desktop
market.price string After-hours trading price desktop
market.extracted_price string Raw after-hours trading price desktop
market.currency string After-hours trading currency symbol desktop
market.price_movement object Collection of after-hours price change data desktop
market.price_movement.percentage string Percentage change in price desktop
market.price_movement.value string Absolute value of price change desktop
market.price_movement.movement string Direction of price change desktop
extensions string[] Extended information array containing additional auxiliary data desktop

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 desktop
currency string Currency type used for the price desktop
date string Specific date and time corresponding to the price desktop
volume number Trading volume of the financial instrument at the corresponding date and time desktop

financials

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

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