# ScrapeMapsAPI > ScrapeMapsAPI is a REST API for Google Maps places and reviews: text search, place details (address, coordinates, opening hours, contacts, attributes, photos) and every review of a place (not just 5), paged with cursors, sortable and translated. Billing is per call: every successful call costs 1 credit, whatever it returns (a page of up to 20 places or 20 reviews, one place's details, one identifier/URL resolution). 200 free calls per month, then $3 per 1,000 calls, down to $1.50 with credit packs valid for 12 months; only HTTP 200 responses are billed. Authenticated with an API key (X-API-Key header or Authorization: Bearer). Official SDKs for Python and TypeScript, and an MCP server for AI assistants (local, or remote as a Claude/ChatGPT connector with OAuth sign-in). Key facts: - Base URL: https://api.scrapemapsapi.com (all paths start with /v1) - Search: `GET https://api.scrapemapsapi.com/v1/places/search?q=pizzeria+in+Naples&language=en®ion=it&limit=20` (optional lat, lng, radius_km, cursor) - Details: `GET https://api.scrapemapsapi.com/v1/places/{place}?language=en` where place is a place ID (ChIJ...), a CID or a feature ID (0x...:0x...) - Reviews: `GET https://api.scrapemapsapi.com/v1/places/{place}/reviews?sort=relevant|newest|highest|lowest&language=en&original_language=it&limit=20&cursor=...` - Resolve: `GET https://api.scrapemapsapi.com/v1/places/resolve?input=` - Responses: `{"data": ..., "meta": {"credits_used", "cached", ...}}`, lists add `"pagination": {"next_cursor", "has_more"}`; headers X-Credits-Used and X-Credits-Remaining - Errors: `{"detail": {"error": "", "message": ""}}` (422 validation errors: `detail` is a list); never billed - Review authors are pseudonymous IDs only (no names, photos or profile links) - API keys are created in the dashboard after signing up (https://scrapemapsapi.com/auth/sign-up); rate limit 500 requests per minute - Python: `pip install scrapemapsapi` ยท TypeScript/Node: `npm install scrapemapsapi` - Remote MCP server (Claude / ChatGPT connector, OAuth sign-in, no API key): https://api.scrapemapsapi.com/mcp - MCP server (runs locally): `uvx scrapemapsapi-mcp` (PyPI) or `npx -y scrapemapsapi-mcp` (npm), env SCRAPEMAPSAPI_API_KEY ## Docs - [Getting started](https://scrapemapsapi.com/docs): Create an API key and make a first request. - [API reference](https://scrapemapsapi.com/docs/api): Every endpoint, parameter, response field and cursor paging. - [Authentication](https://scrapemapsapi.com/docs/authentication): API keys, the X-API-Key header and Bearer tokens. - [Code examples](https://scrapemapsapi.com/docs/examples): cURL, Python and JavaScript examples for every endpoint. - [Errors](https://scrapemapsapi.com/docs/errors): HTTP status codes, error codes and when to retry. - [Python & TypeScript SDKs](https://scrapemapsapi.com/docs/sdks): The official SDKs, with typed models and auto-pagination. - [MCP server](https://scrapemapsapi.com/docs/mcp): Google Maps places and reviews in Claude, Cursor and other MCP clients. ## APIs - [Google Maps Reviews API](https://scrapemapsapi.com/google-maps-reviews-api): Every review of a place, paged with cursors, sortable, filtered by language and translated. - [Google Maps Places API](https://scrapemapsapi.com/google-maps-places-api): Search places by text, optionally around a point, 20 per page with cursor paging. - [Google Maps Place Details API](https://scrapemapsapi.com/google-maps-place-details-api): Address, coordinates, opening hours, phone, website, attributes and photos of one place. ## Tools and pricing - [Free Google Maps reviews tool](https://scrapemapsapi.com/google-maps-reviews-scraper): Paste a Google Maps link and see the place and its 10 newest reviews, no signup. - [Pricing](https://scrapemapsapi.com/pricing): 1 credit per call, credit packs and a comparison with other providers ## Optional - [Full text for LLMs](https://scrapemapsapi.com/llms-full.txt): every endpoint, parameter, object and error code in one file