# Google Finance Ticker Search API (https://www.socialcrawl.dev/platforms/google_finance/ticker-search)

> Searches Google Finance for financial instruments matching a name and returns a unified QuoteList — each row carries the `id` (e.g. 'AAPL:NASDAQ', '.INX:INDEXSP', 'EUR-USD') to feed into /v1/google_finance/quote, plus the ticker, display name, exchange, live price, and `type` discriminator. Spans stocks, ETFs, indices, and forex/crypto pairs (asset pairs populate `quote.pair`, with a null `ticker`). Filter by instrument class with `category`. Sourced live from DataForSEO's Google Finance SERP (~2-3s).

TL;DR: `GET /v1/google_finance/ticker-search` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `keyword` | yes | Company / instrument name to search for (e.g. 'Apple', 'Euro', 'Bitcoin'). |
| `category` | no | Restrict to one instrument class: all (default), stock, index, mutual_fund, currency, or futures. A class with no matches returns an empty list. (all \| stock \| index \| mutual_fund \| currency \| futures) |
| `language` | no | Language as a DFS name ('English') or 2-letter code ('en'). Defaults to English. |
| `location` | no | Location as a DFS name ('United States') or numeric code ('2840'). Defaults to the US. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/google_finance/ticker-search?keyword=Apple" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I look up a ticker symbol by company name?

Send a GET request to /v1/google_finance/ticker-search with keyword set to the instrument name (e.g. Apple). You get up to 5 rows, each with ticker, name, exchange, live price, instrument type, and the id to feed into the quote endpoint.

### What does the ticker-search endpoint return?

Up to 5 rows. Each carries the id (AAPL:NASDAQ, .INX:INDEXSP, EUR-USD) that the quote endpoint takes, plus the ticker, name, exchange, live price, and type — the search-to-detail entry point for the whole Google Finance API.

### Can I filter the search by instrument class?

Yes. Pass category as all, stock, index, mutual_fund, currency, or futures to filter genuinely by instrument class — so a search for a name shared across asset types returns only the class you want.

### How do I turn a search result into a full quote?

Take the id field from any ticker-search row (e.g. AAPL:NASDAQ) and pass it as the keyword to /v1/google_finance/quote. The two endpoints are designed as a search-then-detail pair, so no manual ticker formatting is needed.

### How much does ticker search cost?

Ticker-search is 1 credit per call on the standard tier, no matter how many rows come back. New accounts get 100 free credits with no credit card required, so you can wire up search and detail before paying anything.

See the full Google Finance API: https://www.socialcrawl.dev/platforms/google_finance

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to look up a stock ticker symbol with the SocialCrawl API
- What does the SocialCrawl ticker-search endpoint return?