# Google Search Autocomplete API (https://www.socialcrawl.dev/platforms/google/autocomplete) > Returns the suggestions Google offers as someone types a partial query, about 10, in Google's order: each as `text` with its `position`, the row shape GET /v1/bing/suggestions answers in. type picks the list Google keeps for web (the default), YouTube, news, shopping or image searches; country and language localise it. TL;DR: `GET /v1/google/autocomplete` 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 partial query to complete, up to 100 characters. | | `country` | no | Two-letter country, for example us or gb (default us). | | `language` | no | Language of the suggestions, for example en or es (default en). | | `type` | no | web (default), youtube, news, shopping or images. (web \| youtube \| news \| shopping \| images) | ## Code example ```bash curl -G "https://www.socialcrawl.dev/v1/google/autocomplete" \ --data-urlencode "query=how to make" \ -H "x-api-key: sc_YOUR_API_KEY" ``` ## FAQ ### What does the Google Search Autocomplete API return? Returns the suggestions Google offers for a partial query, about 10 in Google's order, for web, YouTube, news, shopping or image searches. 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 Autocomplete endpoint? Use it for keyword research, to see what people search around a topic or brand, or to compare suggestions across countries. ### How much does the Google Search Autocomplete 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 Autocomplete API need? The one required parameter is query (the partial query to complete, up to 100 characters). It also accepts 3 optional parameters, all listed on this page. ### How do I call the Google Search Autocomplete API? Send a GET request to https://www.socialcrawl.dev/v1/google/autocomplete?query=how%20to%20make 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 Autocomplete API return? - How do I get Google Search Autocomplete data with the SocialCrawl API?