Ticker search
1 credit/v1/finance/ticker-searchFind instruments by company or name. Optional category: stock, index, mutual_fund, currency, futures. Returns ids suitable for quote.
keyword, category, language, location
Google Finance APIFetch Finance data with one API
Resolve tickers, pull rich quotes, and read a markets overview as structured JSON with one SocialCrawl API key. Quote uses TICKER:EXCHANGE. Reads priced in credits.
/v1/finance
3 active endpoints. Quote, ticker search, markets.
- GET /v1/finance/ticker-search
- GET /v1/finance/quote
- GET /v1/finance/markets
What Finance endpoints does SocialCrawl ship?
Seven live read endpoints for Finance instruments. Search by name, quote by TICKER:EXCHANGE or forex/crypto pair, and a markets board of indices and movers. Data API only. No brokerage orders, no portfolio writes.
Instrument quote
5 credits/v1/finance/quoteOne rich Quote: live price, intraday graph, fundamentals, profile, financials when available, peers. keyword is TICKER:EXCHANGE or EUR-USD style pair.
keyword (TICKER:EXCHANGE or EUR-USD), language, location
Markets overview
1 credit/v1/finance/marketsIndices and movers board for a language and location. Snapshot of the markets landing surface, not a full symbol universe crawl.
language, location
Finance API7 endpoints supported
View docsReturns one instrument's full quote: live price and intraday graph, market cap, P/E, dividend yield, 52 week range, company profile, financials, and peers.
Use it when you know the exact symbol, like GOOGL:NASDAQ or BTC-USD; ticker-search gives you that symbol from a name.
5 credits
GET/v1/finance/quote?keyword=GOOGL%3ANASDAQ
keyword · Instrument identifier: TICKER:EXCHANGE for stocks/ETFs/indices ('GOOGL:NASDAQ', '.INX:INDEXSP') or a forex/crypto pair ('EUR-USD', 'BTC-USD'). Use the `id` returned by ticker-search.
$ curl https://www.socialcrawl.dev/v1/finance/quote?keyword=GOOGL%3ANASDAQ \
-H "x-api-key: sc_YOUR_API_KEY"idle
// Running this live needs your own API key. Hit "Try it" to see an example responseHow the Finance API works
Finance is a normal SocialCrawl surface. You call GET /v1/finance/… with an API key, spend credits on live misses, and get a single JSON envelope back. No brokerage OAuth. No second SDK.
Authenticate every call
Send your key in the x-api-key header. No exchange terminal credentials. The same key works for Google Search, Google News, and the rest of the catalog.
GET with query params
All routes are GET. Pass keyword for search and quote, optional category on ticker-search, optional language and location where the route accepts them. We validate before charging.
Pay in credits, not seats
Ticker search and markets cost 1 credit. Quote costs 5. Cache is short for price-sensitive paths (about 60s on quote and markets). Cache hits cost 0. Empty or hard failures refund.
Read one JSON envelope
Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Quote is a single Quote object. Search and markets return list shapes.
The usual integration chain
Most products resolve a name to an instrument id, then call quote. Markets is the overview board when you need indices and movers without a symbol.
01Ticker search
GET /v1/finance/ticker-search?keyword=…QuoteList candidates with instrument ids
Map a company name to TICKER:EXCHANGE before paying for quote.
02Quote
GET /v1/finance/quote?keyword=TICKER:EXCHANGEFull Quote: price, graph, fundamentals, profile
Rich instrument payload for dashboards, alerts, and research jobs.
03Markets
GET /v1/finance/marketsQuoteList board of indices and movers
Market snapshot without iterating a symbol list.
request
GET /v1/finance/ticker-search
?keyword=Apple
&category=stock
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/finance/quote?keyword=AAPL:NASDAQresponse envelope
{
"success": true,
"data": {
"symbol": "AAPL:NASDAQ",
"price": 0,
"currency": "USD",
"graph": [],
"profile": {}
},
"credits_used": 5,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}What lands in data
Finance responses use the shared Quote and QuoteList archetypes so stocks, ETFs, indices, crypto, and forex share one parser.
QuoteList (ticker-search)ticker-search
items[] with instrument id (TICKER:EXCHANGE or pair), name, type, market hints
Quotequote
symbol, price, currency, graph[], profile, fundamentals, financials when present, peers; pair for forex/crypto
QuoteList (markets)markets
indices and movers rows on the same Quote list leaf for board UIs
Inside the gateway
Same request lifecycle as every other /v1 platform endpoint. Finance is not a sidecar.
- 01
Edge receives the call
Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).
- 02
Validate, then debit
Registry lookup finds finance/ticker-search, quote, or markets. Required keyword checks run first on search and quote. Invalid input returns 400 with no charge. Valid calls debit the tier cost atomically before upstream work.
- 03
Cache or fetch
A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: the upstream is read live. Quote and markets keep a short TTL for price freshness. Retries on 5xx/network with a circuit breaker if the source is unhealthy.
- 04
Normalize and return
Upstream JSON is mapped to Quote or QuoteList, validated against the canonical Zod schema, then wrapped in the success envelope and logged for billing audit.
Billing rules that matter in production
- Ticker search live miss: 1 credit
- Markets live miss: 1 credit
- Quote live miss: 5 credits
- Cache hit: 0 credits
- Empty / hard fail: auto-refund
- Bad params: 400, never charged
- No credits: 402, never charged
- Wrong exchange suffix: empty or error shape, refund rules apply as documented
- Upstream outage after debit: refund path applies
How we get the data
Finance is a public-read market data SERP. We normalize instruments into Quote so your code does not learn a second market data SDK.
What Finance is for this API
Instrument search, rich single-instrument quotes, and a markets overview board. Stocks, ETFs, indices, mutual funds, currency, and futures classes on search. Read-only. No order routing.
How SocialCrawl reaches it
The quote, ticker-search and markets routes read a public finance SERP live; history, statements, options and news read a separate live market-data source. Quote is the expensive rich pull. Prefer ticker-search first so keyword is an exact TICKER:EXCHANGE or pair id.
What leaves our edge
A unified JSON envelope: success, data, credits_used, request_id, cached. Search and markets return list shapes. Quote returns one Quote with price, graph, profile, and fundamentals when present.
What we do not ship live
No brokerage auth. No historical candle product beyond the quote graph window upstream provides. No portfolio or watchlist writes.
field map sketch
instrument match row→ QuoteList item idinstrument match row becomes QuoteList item id
price + graph + fundamentals→ Quote fieldsprice, graph, fundamentals map onto Quote fields
indices + movers board→ markets QuoteListindices and movers board becomes markets QuoteList
What this API is used for
The jobs this API is most often used for.
3active Google Finance endpoints in the registry
1 / 5credit ladder for search/markets (1) and quote (5)
Symbol resolve then quote enrichment
Callers concentrate on ticker-search into quote. Markets shows up for dashboard headers and movers widgets. Canonical Quote shape across stocks, ETFs, indices, crypto, and forex. Ticker search at 1 credit, full quote at 5. Same SocialCrawl key as social and SERP.
Ticker search and markets are typically a few seconds. Quote is the heavier path (often several seconds on live miss) because the payload bundles graph, fundamentals, and profile.
Use case examples
Common ways teams put this data to work, and the stack each one tends to run.
Research notebooks
Python, pandas, cronticker-search for name resolution, then quote for fundamentals and graph. Store symbol and price snapshots on a schedule.
Product market widgets
Node, SSR, Explorermarkets for indices and movers boards. Short cache keeps repeated page loads cheap within the minute window.
Alerting workers
Go, queues, webhooksResolve once, quote on an interval, fire when price or day change crosses a threshold. Same key as the rest of SocialCrawl.
Call it in two lines
Ticker search and markets are one credit per live call. Quote is five. Cache hits are free.
curl "https://www.socialcrawl.dev/v1/finance/ticker-search?keyword=Apple&category=stock" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/finance/quote?keyword=AAPL:NASDAQ" \
-H "x-api-key: sc_your_api_key_here"Same key as the rest of the catalog
Endpoints
What data does the Finance API return?
Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.
QuoteGet a financial instrument quoteTicker SearchSearch financial instruments by nameMarketsGet a markets overview (indices + movers)NewsGet recent news for a financial instrumentHistoryGet daily price history for an instrumentStatementsGet financial statements for a companyOptionsGet an options chain for an instrument
Comparison
How does SocialCrawl compare to Yahoo Finance / Alpha Vantage for Finance data?
Same Finance data, two very different paths. Auth, rate limits, schema, and cost, side by side.
| Feature | SocialCrawl | Yahoo Finance / Alpha Vantage |
|---|---|---|
| Data source | Current Google Finance snapshots; quote and markets cache for 60 seconds, ticker search for 2 minutes; exact hits cost 0 credits | Yahoo Finance scraping plus rate-limited free API tiers |
| Unified schema | One Quote shape across stocks, ETFs, indices, crypto, forex | Divergent shapes per provider: remap each data source |
| One call vs many | Price + graph + fundamentals + financials + peers in one request | Separate endpoints (or providers) for each of those |
| Instrument coverage | Stocks, ETFs, indices, crypto, and forex in one API | Stocks well covered; crypto and forex often a separate product |
| Pricing | 5cr per quote, 1cr per search; 100 free credits, no card | Free tiers throttle requests; full access needs paid plans |
Data source
SocialCrawl
Current Google Finance snapshots; quote and markets cache for 60 seconds, ticker search for 2 minutes; exact hits cost 0 credits
Yahoo Finance / Alpha Vantage
Yahoo Finance scraping plus rate-limited free API tiers
Unified schema
SocialCrawl
One Quote shape across stocks, ETFs, indices, crypto, forex
Yahoo Finance / Alpha Vantage
Divergent shapes per provider: remap each data source
One call vs many
SocialCrawl
Price + graph + fundamentals + financials + peers in one request
Yahoo Finance / Alpha Vantage
Separate endpoints (or providers) for each of those
Instrument coverage
SocialCrawl
Stocks, ETFs, indices, crypto, and forex in one API
Yahoo Finance / Alpha Vantage
Stocks well covered; crypto and forex often a separate product
Pricing
SocialCrawl
5cr per quote, 1cr per search; 100 free credits, no card
Yahoo Finance / Alpha Vantage
Free tiers throttle requests; full access needs paid plans
FAQ
Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usIs there a Google Finance API?
Google retired its public Finance API, so there is no official one. SocialCrawl returns Google Finance quotes and market data as structured JSON on the same key as its social endpoints, which is what lets you put a ticker's price next to the social conversation around it.
How do I get a stock quote with the Google Finance API?
Send a GET request to /v1/google_finance/quote with keyword set to TICKER:EXCHANGE (e.g. GOOGL:NASDAQ). One call returns a current public market snapshot with price, intraday graph, metrics, company about, financials, and peers as a unified Quote JSON. Exact repeats may use the 60-second quote cache and cost 0 credits; prices can also reflect exchange delay.
What instrument types does the Google Finance API cover?
Stocks, ETFs, indices, crypto, and forex, all through the same code path. A quote.type discriminator and nullable detail leaves mean you integrate once and read every asset class. Forex and crypto pairs (EUR-USD, BTC-USD) populate quote.pair.
Can I search for a ticker symbol by company name?
Yes. Call /v1/google_finance/ticker-search with keyword=Apple to get up to 5 rows, each carrying the id (AAPL:NASDAQ) to feed straight into the quote endpoint, plus ticker, name, exchange, current price snapshot, and instrument type. Exact repeats may use the 2-minute search cache and cost 0 credits.
Does the API return market indices and movers?
Yes. /v1/google_finance/markets needs no parameters and returns a standing overview: major US, Europe, and Asia indices plus the day's most-active, gainers, and losers, flattened into one list of canonical Quotes (about 47 rows).
How much does the Google Finance API cost?
A full quote is 5 credits (advanced tier), ticker-search and markets are 1 credit each (standard tier). New accounts get 100 free credits with no credit card, and a nonexistent ticker returns 404 with an automatic refund.
What is the best Google Finance API for real-time stock data?
SocialCrawl returns a current public market snapshot with price, intraday graph, fundamentals, financials, and peers in one call across stocks, ETFs, indices, crypto, and forex. Exact quote repeats may use the 60-second cache and cost 0 credits; prices can also reflect exchange delay.
Does Google Finance have a data API?
Google retired its public Finance API, so there is no official Google Finance data API today. SocialCrawl provides one: /v1/google_finance/quote returns a current public market snapshot, /v1/google_finance/ticker-search resolves a company name to a ticker, and /v1/google_finance/markets returns indices and the day's movers. Quote and markets repeats may use a 60-second cache; ticker-search repeats may use a 2-minute cache, and exact cache hits cost 0 credits.
Is there a Google Finance scraper API?
Yes. Instead of scraping the Google Finance site, which renders client-side and changes often, call SocialCrawl. /v1/google_finance/quote fetches a ticker's current public market snapshot in one synchronous GET, typically in 3 to 15 seconds. Exact repeats may use the 60-second quote cache and cost 0 credits; prices can also reflect exchange delay. A nonexistent ticker returns 404 with an automatic refund.
Is scraping Finance data legal?
SocialCrawl returns publicly available Finance data and does not access private or login-gated content. Whether scraping fits your project depends on your use case and jurisdiction. You are responsible for complying with Finance's terms of service and applicable data-protection laws such as GDPR and CCPA. This is general information, not legal advice.
Finance scraping API vs the official Finance API: what's the difference?
With SocialCrawl there is no app review or approval queue. Sign up and call Finance endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.
Ask AI about SocialCrawl