# Google Search AI Overview API (https://www.socialcrawl.dev/platforms/google/ai-overview) > Returns the AI Overview Google shows at the top of its results for a query. `answer` is the text, `blocks` keep Google's layout (paragraphs, headings, lists with their items, tables as rows) with the sources each block rests on, and `sources` lists the cited pages numbered from 1 (index, url, title, site, snippet), the shape GET /v1/perplexity/research answers in. A query Google shows no AI Overview for returns 404 and is not charged. An answer takes about 10 to 15 seconds. TL;DR: `GET /v1/google/ai-overview` 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 | | --- | --- | --- | | `query` | yes | The search, up to 4,000 characters. | | `country` | no | Two-letter country to ask from, for example us or gb. | | `language` | no | Language of the answer, for example en or de (default en). | | `location` | no | A city-level place to ask from, for example Austin, Texas. | | `device` | no | desktop (default), tablet or mobile. (desktop \| tablet \| mobile) | ## Code example ```bash curl -G "https://www.socialcrawl.dev/v1/google/ai-overview" \ --data-urlencode "query=how does a heat pump work" \ -H "x-api-key: sc_YOUR_API_KEY" ``` ## FAQ ### What does the Google Search AI Overview API return? Returns the AI Overview Google shows for a query: the answer text, its blocks (paragraphs, lists, tables) and the pages it cites. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields. ### When should I use the Google Search AI Overview endpoint? Use it to track what Google's AI says about a brand or topic, see which pages it cites, or monitor answers by country. ### How much does the Google Search AI Overview API cost? Each call costs 1 credit, so the 100 free credits every new account gets cover 100 calls. Credits for failed or empty calls are refunded automatically, and there is no subscription. ### What parameters does the Google Search AI Overview API need? The one required parameter is query (the search, up to 4,000 characters). It also accepts 4 optional parameters, all listed on this page. ### How do I call the Google Search AI Overview API? Send a GET request to https://www.socialcrawl.dev/v1/google/ai-overview?query=how%20does%20a%20heat%20pump%20work with your API key in the x-api-key header. An Authorization: Bearer header works too. See the full Google Search API: https://www.socialcrawl.dev/platforms/google ## 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: - What does the SocialCrawl Google Search AI Overview API return? - How do I get Google Search AI Overview data with the SocialCrawl API?