{"uid":"cap_m6CifwOCLGSpp3drxylEn","slug":"fastaf-google-maps-places-search-b5206cb3","name":"FastAF Google Maps Places Search","description":"Local business and places search API for AI agents: Google Maps results as JSON with addresses, ratings, review counts, coordinates and place IDs when available. Supports searches by query and location or place details by place_id. Provided by FastAF Google Maps & Places. Price: $0.005000 USDC per successful call.","url":"https://api.fastaf.co/x402/v1/maps?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","title":"FastAF Google Maps & Places","$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"],"type":"string"},"queryParams":{"type":"object","anyOf":[{"required":["query"]},{"required":["place_id"]}],"examples":[{"ll":"@40.758,-73.9855,14z","query":"coffee near Times Square","language":"en"}],"properties":{"ll":{"type":"string","examples":["@40.758,-73.9855,14z"],"maxLength":8192,"description":"Search centre as @latitude,longitude,zoom, e.g. @41.9028,12.4964,13z (coordinates in degrees; zoom 3z-30z; map height in metres also supported upstream). Needed for pagination. Cannot combine with location; omitted: infer from query/location. No option surcharge; 5 credits per successful request."},"data":{"type":"string","maxLength":8192,"description":"Opaque data fragment copied from a Google Maps URL, e.g. !4m5!3m4!1s<id>!8m2!3d<lat>!4d<lon>. Used with type=place; unnecessary with place_id. No default. No option surcharge; 5 credits per successful request."},"page":{"type":"integer","minimum":0,"description":"Maps result offset, integer 0-100: 0 first page, 20 second, 40 third. Default 0; supply ll for pagination. Each page is a separate request. No option surcharge; 5 credits per successful request."},"type":{"enum":["search","place"],"type":"string","description":"Maps operation: search for query results or place for details using data. Omit for query search or automatic place_id lookup. No option surcharge; 5 credits per successful request."},"query":{"type":"string","examples":["coffee near Times Square"],"maxLength":8192,"description":"Maps search text, e.g. coffee in Rome; required unless place_id is supplied. Without location or ll, FastAF uses a place named in the query. No option surcharge; 5 credits per successful request."},"domain":{"type":"string","maxLength":8192,"description":"Google host to search, e.g. google.com or google.co.uk; default google.com. No option surcharge; 5 credits per successful request."},"country":{"type":"string","maxLength":8192,"description":"Two-letter search country code, e.g. us, uk or fr; default us. Localizes results, not a scrape proxy selection. No option surcharge; 5 credits per successful request."},"language":{"type":"string","examples":["en"],"maxLength":8192,"description":"Result/interface language code, e.g. en, es, fr or de; default en. Use lr, where supported, to restrict document languages. No option surcharge; 5 credits per successful request."},"location":{"type":"string","maxLength":8192,"description":"Search-centre place name, e.g. Rome, Italy (up to 200 characters). Cannot combine with ll. Omit to infer from query; unresolved or out-of-area results are not charged. No option surcharge; 5 credits per successful request."},"place_id":{"type":"string","maxLength":8192,"description":"Google Maps place identifier, e.g. ChIJN1t_tDeuEmsRUsoyG83frY4, for one place's details. Required if query is omitted; no default. No option surcharge; 5 credits per successful request."}},"description":"Local places search by query and map center (ll); alternatively, place_id selects a place lookup.","additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"search_results":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"rating":{"type":"number"},"address":{"type":"string"},"reviews":{"type":"number"},"place_id":{"type":"string"},"gps_coordinates":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true}}},"description":"Google Maps JSON. search_results contains places with title, address, rating, reviews, place_id and gps_coordinates when available.","additionalProperties":true}}},"docsUrl":{"type":"string","format":"uri"},"website":{"type":"string","format":"uri"},"homepage":{"type":"string","format":"uri"},"openApiUrl":{"type":"string","format":"uri"}},"description":"Local business and places search API for AI agents: Google Maps results as JSON with addresses, ratings, review counts, coordinates and place IDs when available. Supports searches by query and location or place details by place_id."},"responseSchema":{"type":"json","example":{"search_results":[{"title":"Example Cafe","rating":4.6,"address":"...","reviews":1200,"place_id":"ChIJ..."}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ynpG7C1JeM5fu3VtMuNA6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns Google Maps places as structured JSON (name, address, rating, review count, place_id) for a search query, or detailed info for a single place by place_id.","exampleAgentPrompt":"Can you search Google Maps for the top-rated Italian restaurants in Rome and give me a list with their names, addresses, ratings, and review counts?","exampleUseCases":[{"title":"Find restaurants near a landmark","prompt":"Search Google Maps for highly-rated sushi restaurants near the Eiffel Tower in Paris and give me their names, addresses, ratings, and review counts as a list."},{"title":"Look up a specific place by ID","prompt":"I have a Google Maps place ID — ChIJN1t_tDeuEmsRUsoyG83frY4 — can you pull up the full details for that place including its name, address, and rating?"},{"title":"Discover hotels in a new city","prompt":"Find me boutique hotels in Barcelona on Google Maps — I want to see the top results with names, addresses, ratings, and how many reviews each one has."}],"resultDescription":"A JSON object containing an array of search results, each with: title (place name), address, rating (float), reviews (integer count), and place_id (Google Maps unique identifier). When querying by place_id, returns a single place detail object with the same fields.","failureModes":["Missing both 'query' and 'place_id' parameters returns a validation error","Invalid place_id returns empty or null result","Unsupported Google domain value may cause no results","Pagination with page > 100 is out of range","Network or upstream Google Maps unavailability causes request failure (not billed)","Invalid ll coordinate format causes search center inference failure"],"whenToPreferThis":"Use this endpoint when you need structured Google Maps place data (name, address, rating, review count, place_id) returned as JSON, especially for search queries centered on a named location or when resolving a known place_id. Prefer this over general web scraping when you specifically need Google Maps place metadata in a machine-readable format without parsing HTML.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T04:31:39.033Z","isFirstParty":false,"canonicalSlug":"fastaf-google-maps-places-search-b5206cb3"}