Google Finance Endpoint
Return a Google Finance market overview or one ticker quote.
Getting Started
Send your API key as a bearer token. Start with the smallest request below.
Run Google Finance
Send the smallest useful request and read the structured response.
curl -X POST "https://api.datablue.dev/v1/data/google/finance" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "AAPL:NASDAQ"
}'Example response
{
"success": true,
"time_taken": 1.87,
"stock": "AAPL:NASDAQ",
"name": "Apple Inc",
"price": "$198.50",
"price_movement": {
"percentage": "+1.24%",
"value": "+$2.43",
"movement": "up"
},
"currency": "USD",
"previous_close": "$196.07",
"after_hours_price": "$198.75",
"after_hours_movement": {
"percentage": "+0.13%",
"value": "+$0.25",
"movement": "up"
},
"similar_stocks": [
{
"stock": "MSFT:NASDAQ",
"link": "https://www.google.com/finance/quote/MSFT:NASDAQ",
"name": "Microsoft Corporation",
"price": "$428.50",
"price_movement": {
"percentage": "+0.87%",
"value": "+$3.70",
"movement": "up"
}
},
{
"stock": "GOOGL:NASDAQ",
"link": "https://www.google.com/finance/quote/GOOGL:NASDAQ",
"name": "Alphabet Inc",
"price": "$178.20",
"price_movement": {
"percentage": "-0.34%",
"value": "-$0.61",
"movement": "down"
}
}
],
"news": [
{
"title": "Apple Reports Record Q2 Revenue Driven by Services Growth",
"url": "https://www.cnbc.com/2026/04/02/apple-q2-earnings.html",
"source": "CNBC",
"snippet": "Apple beat Wall Street expectations with $97.4B in revenue...",
"published_timestamp": 1743638400
}
]
}Options
Query and Target
Set the search term, identifier, or source URL that defines the request.
curl -X POST "https://api.datablue.dev/v1/data/google/finance" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "web scraping tools"
}'Example response
{
"success": true,
"time_taken": 1.87,
"stock": "AAPL:NASDAQ",
"name": "Apple Inc",
"price": "$198.50",
"price_movement": {
"percentage": "+1.24%",
"value": "+$2.43",
"movement": "up"
},
"currency": "USD",
"previous_close": "$196.07",
"after_hours_price": "$198.75",
"after_hours_movement": {
"percentage": "+0.13%",
"value": "+$0.25",
"movement": "up"
},
"similar_stocks": [
{
"stock": "MSFT:NASDAQ",
"link": "https://www.google.com/finance/quote/MSFT:NASDAQ",
"name": "Microsoft Corporation",
"price": "$428.50",
"price_movement": {
"percentage": "+0.87%",
"value": "+$3.70",
"movement": "up"
}
}
],
"news": [
{
"title": "Apple Reports Record Q2 Revenue Driven by Services Growth",
"url": "https://www.cnbc.com/2026/04/02/apple-q2-earnings.html",
"source": "CNBC",
"snippet": "Apple beat Wall Street expectations with $97.4B in revenue...",
"published_timestamp": 1743638400
}
]
}Location and Language
Localize results with country, language, coordinates, or delivery-location fields.
curl -X POST "https://api.datablue.dev/v1/data/google/finance" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "AAPL:NASDAQ",
"language": "en",
"country": "us"
}'Example response
{
"success": true,
"time_taken": 1.87,
"stock": "AAPL:NASDAQ",
"name": "Apple Inc",
"price": "$198.50",
"price_movement": {
"percentage": "+1.24%",
"value": "+$2.43",
"movement": "up"
},
"currency": "USD",
"previous_close": "$196.07",
"after_hours_price": "$198.75",
"after_hours_movement": {
"percentage": "+0.13%",
"value": "+$0.25",
"movement": "up"
},
"similar_stocks": [
{
"stock": "MSFT:NASDAQ",
"link": "https://www.google.com/finance/quote/MSFT:NASDAQ",
"name": "Microsoft Corporation",
"price": "$428.50",
"price_movement": {
"percentage": "+0.87%",
"value": "+$3.70",
"movement": "up"
}
}
],
"news": [
{
"title": "Apple Reports Record Q2 Revenue Driven by Services Growth",
"url": "https://www.cnbc.com/2026/04/02/apple-q2-earnings.html",
"source": "CNBC",
"snippet": "Apple beat Wall Street expectations with $97.4B in revenue...",
"published_timestamp": 1743638400
}
]
}Response
Read success first, then consume the endpoint-specific records and pagination fields shown below.
Error Handling
Handle 401 for authentication, 422 for invalid input, 429 for limits, and retry only transient failures.