{"uid":"cap_3nUcO0kXNBR7i2X_hjXy9","slug":"scrappa-google-maps-autocomplete-075e612f","name":"Scrappa Google Maps Autocomplete","description":"The Google Maps Autocomplete API provides automatic query predictions as users type. Helps users find places, addresses, and points of interest quickly. Accepts both \"q\" and \"query\" parameters for consistency with other autocomplete endpoints.","url":"https://scrappa.co/api/maps/autocomplete","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"The partial search term to get autocomplete suggestions for. Accepts both \"q\" (consistent with Google Hotels) and \"query\"."},"gl":{"type":"string","description":"Country/region code for geo-filtering results. Examples: us, de, uk, jp. Format: ISO 3166-1 alpha-2 country code."},"hl":{"type":"string","description":"Language code for results. Default: en. Examples: en, de, fr, es. Format: ISO 639-1 two-letter language code."},"ll":{"type":"string","description":"Latitude and longitude to bias results toward a specific location. Format: \"latitude,longitude\" (e.g., 40.7128,-74.0060 for New York City)."},"google_domain":{"type":"string","description":"Google domain to use for the search. Examples: google.com, google.de, google.com.br, google.co.uk."}},"additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_p_lNnGgEq_eZhbzVGD86H","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns Google Maps autocomplete suggestions for partial place, address, or POI queries as users type","exampleAgentPrompt":"Can you get me Google Maps autocomplete suggestions for 'coffee shop Man' biased toward New York City (40.7128,-74.0060) in English?","exampleUseCases":[{"title":"Typeahead search for a travel app","prompt":"I'm building a location search box and need autocomplete suggestions for 'Eiffel To' — can you fetch predictions from Google Maps biased toward France (gl=fr, hl=fr)?"},{"title":"Address lookup for a delivery form","prompt":"Get me autocomplete suggestions for '123 Main St Bro' so I can show address predictions to a user filling out a delivery form in the US."},{"title":"POI discovery for a city guide","prompt":"Fetch Google Maps autocomplete results for 'Centr' near Tokyo (35.6762,139.6503) in Japanese so I can populate a points-of-interest dropdown for my city guide app."}],"resultDescription":"A JSON object containing an array of autocomplete predictions from Google Maps, each including a predicted place or address string and associated metadata such as place IDs and description components.","failureModes":["Missing required 'q' parameter returns a 400 error","Invalid country code in 'gl' may return unfiltered or empty results","Malformed latitude/longitude in 'll' parameter causes prediction bias to fail","Query too vague or too short may return no predictions","Payment not processed (x402 protocol failure) blocks the request","Rate limiting if too many requests sent in quick succession"],"whenToPreferThis":"Choose this endpoint when you need real-time Google Maps-powered place and address autocomplete suggestions for typeahead UI components, location search boxes, or address validation flows. It is ideal when you need geo-biased or language-filtered results and want Google Maps data quality via a simple pay-per-call REST API without managing a Google Maps API key.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:35:41.799Z","isFirstParty":false}