--- name: placesdataapi description: Official Model Context Protocol (MCP) server and AI Agent Skill for PlacesData API (https://placesdataapi.com). Real-time Google Maps local business leads, E.164 phone numbers, website B2B emails & social links, verified customer reviews, storefront photos, autocomplete, and GPS coordinates REST API — 90% cheaper than Google Places API & Outscraper ($0.20–$0.50 per 1,000 places). Includes $1.20 (12,000 Free Credits) instant signup with no credit card + $2.00 Developer Sandbox Streak bonus ($3.20 / 32,000 total free credits). version: 1.0.0 homepage: https://placesdataapi.com mcp_url: https://api.placesdataapi.com/mcp mcp_page: https://placesdataapi.com/mcp documentation: https://placesdataapi.com/docs openapi: https://placesdataapi.com/openapi.json llms_txt: https://placesdataapi.com/llms.txt llms_full_txt: https://placesdataapi.com/llms-full.txt status_page: https://placesdataapi.com/status license: MIT author: PlacesData API (https://placesdataapi.com) tags: - mcp - claude-skill - google-maps-api - google-places-alternative - outscraper-alternative - local-business-leads - google-reviews-api - b2b-email-enrichment - geocoding-api - gtm-automation --- # PlacesData API — Official Remote MCP Server & AI Agent Skill (`placesdataapi`) Connect **Claude Code**, **Claude Desktop**, **Cursor**, **Windsurf**, **Cline**, **OpenAI Agents**, **LangChain**, and **n8n** directly to **[PlacesData API (`https://placesdataapi.com`)](https://placesdataapi.com)** — the real-time REST & Streamable HTTP MCP gateway for **200M+ Google Maps local businesses, E.164 phone numbers, website B2B emails, verified customer reviews, storefront photos, and GPS coordinates**. - **Website & Live Browser Playground**: [https://placesdataapi.com](https://placesdataapi.com) - **Claim `$1.20+` Free Credits (`12,000` Instant Free Credits + `+$2.00` Sandbox Streak = `32,000` Free Credits, No Card Required)**: [https://placesdataapi.com/signup](https://placesdataapi.com/signup) - **Remote Streamable HTTP MCP Endpoint (Zero-Install)**: `https://api.placesdataapi.com/mcp` (alias: `https://api.placesdataapi.com/v1/mcp`) - **Interactive API Reference (8 Endpoints)**: [https://placesdataapi.com/docs](https://placesdataapi.com/docs) - **MCP Integration Guide**: [https://placesdataapi.com/mcp](https://placesdataapi.com/mcp) - **Transparent Developer Pricing (`$0.20–$0.50` / 1K Places · PAYG Never Expires)**: [https://placesdataapi.com/pricing](https://placesdataapi.com/pricing) - **Live 7-Day `p50`/`p95` Latency & Uptime Monitor**: [https://placesdataapi.com/status](https://placesdataapi.com/status) - **OpenAPI 3.1 Specification**: [https://placesdataapi.com/openapi.json](https://placesdataapi.com/openapi.json) - **LLM Context Manifests**: [https://placesdataapi.com/llms.txt](https://placesdataapi.com/llms.txt) · [https://placesdataapi.com/llms-full.txt](https://placesdataapi.com/llms-full.txt) --- ## Why AI Agents & GTM Teams Choose PlacesData API 1. **90%–99% Cheaper Than Google Places API & Outscraper**: Pay **`$0.20–$0.50` per 1,000 Google Maps places** (`5 Credits / place`, `$1.00 = 10,000 Credits`) vs `$32–$35 / 1,000` on Google Places API. 2. **`$1.20` Instant Free Credits + `+$2.00` Streak Bonus (`32,000` Total Free Credits)**: Sign up in 10 seconds with zero credit card to test **2,400+ Google Maps business leads** or **6,000+ customer reviews** immediately (`60 RPM / 5 RPS` concurrency unlocked on Free Trial), plus claim **`+$1.00`** (`+10,000` credits) on Day-2 return and **`+$1.00`** (`+10,000` credits) on 3-day integration! 3. **Zero Charge on Empty Results or Errors**: `0` results returned or upstream errors always deduct **`0 Credits`**. 4. **Built-In Website B2B Email & Social Profile Crawler**: Pass `enrich_contacts=true` or call `/v1/enrich/contacts` to extract public B2B emails and LinkedIn, Instagram, Facebook, X, YouTube, and TikTok links directly from business domains. 5. **Sub-50ms Warm Spatial Cache + Dual-Rail Live SERP Failover**: Backed by PostgreSQL 16 GiST spatial indexing (`15–50 ms` warm hits) with automatic real-time Google Maps SERP & Business Info failover (`0.8–2.5 s` cold queries). --- ## Quickstart: Connect via Remote Streamable HTTP MCP (No Local Build Needed) `https://api.placesdataapi.com/mcp` implements the official **Model Context Protocol Streamable HTTP** transport + **OAuth 2.1 Dynamic Client Registration (RFC 7591) & PKCE (`S256`)**: - **Public Zero-Key Discovery**: `initialize` and `tools/list` on `/mcp` and `/v1/mcp` return `HTTP 200` without an API key so MCP directories and IDE clients can inspect all 8 tools immediately. - **1-Click Claude Web & ChatGPT OAuth 2.1 Connector**: Paste `https://mcp.placesdataapi.com/v1/mcp` in Claude.ai Integrations or ChatGPT Connectors (`https://mcp.placesdataapi.com/.well-known/oauth-protected-resource` + `/.well-known/oauth-authorization-server`) for 1-click Google/Email OAuth login with strictly read-only `mcp:tools:read` scope. - **Authenticated Tool Execution**: Pass your `pd_live_...` API key (or OAuth `mcp_at_...` token) in `x-api-key` or `Authorization: Bearer ` when invoking `tools/call`. ### 1. Claude Code CLI (1 Command) ```bash claude mcp add --transport http placesdataapi https://api.placesdataapi.com/mcp \ --header "x-api-key: pd_live_your_api_key_here" ``` ### 2. Cursor (`.cursor/mcp.json`) / Windsurf / Claude Desktop ```json { "mcpServers": { "placesdataapi": { "url": "https://api.placesdataapi.com/mcp", "headers": { "x-api-key": "pd_live_your_api_key_here" } } } } ``` ### 3. Direct REST cURL Quickstart ```bash curl -sS "https://api.placesdataapi.com/v1/places/search?q=HVAC+contractors+in+Austin+TX&limit=5&enrich_contacts=true" \ -H "x-api-key: pd_live_your_api_key_here" ``` --- ## Core Endpoints & Unit Credit Pricing (`$1.00 = 10,000 Credits`) | MCP Tool Name | REST Endpoint | Credit Cost | Effective USD Rate | Description | | :--- | :--- | :--- | :--- | :--- | | `places_search` | `GET /v1/places/search` | **5 Credits / place** (`0` if empty) | `$0.20–$0.50 / 1K places` | Search Google Maps businesses by natural-language query (`q`, `limit`, `offset`, `lang`, `region`, `enrich_contacts`). Returns ratings, E.164 phone, website, address, hours, `place_id`, `cid`, and coordinates. | | `places_nearby` | `GET /v1/places/nearby` | **5 Credits / place** (`0` if empty) | `$0.20–$0.50 / 1K places` | Discover businesses inside a GPS coordinate viewport (`lat`, `lng`, `zoom`, optional `q`, `limit`). | | `places_details` | `GET /v1/places/details` | **20 Credits / place** (`+20` w/ contacts) | `$0.0008–$0.002 / call` | Full Google Business Profile lookup by `place_id`, numeric `cid`, or `0x...:0x...` hex feature ID (rating histogram, categories, attributes, hours). | | `places_reviews` | `GET /v1/places/reviews` | **2 Credits / review** (`0` if empty) | `$0.08–$0.20 / 1K reviews` | Extract verified customer reviews sorted by `newest`, `most_relevant`, `highest_rating`, or `lowest_rating` with owner replies and review photos. | | `places_photos` | `GET /v1/places/photos` | **2 Credits / photo** (`0` if empty) | `$0.08–$0.20 / 1K photos` | High-resolution storefront, interior, and menu photo URLs and dimensions by `place_id`. | | `leads_enrich` | `GET /v1/enrich/contacts` (alias `/v1/leads/enrich`) | **20 Credits** (`0` if no contacts found) | `$0.0008–$0.002 / domain` | Real-time SSRF-safe domain crawl extracting verified B2B email addresses, phone numbers, and LinkedIn / Instagram / Facebook / X / YouTube / TikTok URLs. | | `places_autocomplete` | `GET /v1/places/autocomplete` | **5 Credits / call** (`0` if empty) | `$0.20–$0.50 / 1K calls` | Real-time typeahead place and street address predictions with coordinate and country biasing. | | `geocode_reverse` | `GET /v1/geocode/reverse` | **5 Credits / call** | `$0.20–$0.50 / 1K calls` | Convert raw `lat` / `lng` GPS coordinates into structured street addresses, Plus Codes, and Google Place IDs. | **Drop-In Compatibility Aliases**: Supports Google Places legacy paths (`/maps/api/place/textsearch/json`, `/maps/api/place/nearbysearch/json`, `/maps/api/place/details/json`, `/maps/api/place/autocomplete/json`) and Outscraper migration routes (`/maps/gmap/search-v3`, `/maps/gmap/reviews-v3`). --- ## Free Interactive Browser Tools (`/tools/*` — No Login Required) - **[Free Local Business Email & Phone Finder](https://placesdataapi.com/tools/local-business-email-finder)**: Enter any business name and city to preview live Google Maps ratings, E.164 phone numbers, websites, and crawled B2B emails — with 1-click JSON export and cURL/Python code generation. - **[2026 Google Places API Pricing Calculator](https://placesdataapi.com/tools/google-places-api-pricing-calculator)**: Compare exact monthly costs across Google Places API (`$32/1K`), Outscraper, SerpApi, Apify, and PlacesData API (`$0.20–$0.50/1K`). - **[Free Google Maps Place ID, CID & Coordinate Finder](https://placesdataapi.com/tools/google-maps-place-id-finder)**: Look up any business's canonical `ChIJ...` Place ID, numeric `cid`, `0x...:0x...` hex ID, and GPS coordinates. - **[Free Google Review Link & QR URL Generator](https://placesdataapi.com/tools/google-review-link-generator)**: Generate direct 1-click Google Maps customer review links (`writereview?placeid=...`) from any business name. - **[All Free Developer Tools Hub](https://placesdataapi.com/tools)** · **[Live 7-Day API Status & p50/p95 Latency Monitor](https://placesdataapi.com/status)** --- ## Pillar Pages, Engineering Guides & Competitor Comparisons - **Core Pillars**: - [Google Maps REST API Overview](https://placesdataapi.com/google-maps-api) - [Google Maps Lead, Phone & Email Scraper API](https://placesdataapi.com/google-maps-scraper) - [Migrate from Apify Google Maps Scraper (Save 40%–60% · Zero Cold Starts)](https://placesdataapi.com/from-apify) - **Engineering Guides** ([All Guides](https://placesdataapi.com/guides)): - [Outscraper Pricing Breakdown (2026): Real Cost/1K vs $0.20/1K Sync API](https://placesdataapi.com/guides/outscraper-pricing) - [Scrape Google Maps in Python & Node.js Without Headless Browsers](https://placesdataapi.com/guides/scrape-google-maps-python-nodejs) - [Extract Verified Business Emails & Social Profiles from Google Maps](https://placesdataapi.com/guides/extract-business-emails-from-google-maps) - [Google Maps Reviews Sentiment & Reputation Monitoring API Guide](https://placesdataapi.com/guides/google-maps-reviews-sentiment-api-guide) - **Competitor Comparisons** ([All Comparisons](https://placesdataapi.com/compare)): - [Google Places API Alternative (Save 90%–99% — $0.20/1K vs $32/1K)](https://placesdataapi.com/compare/google-places-api-alternative) - [Outscraper Alternative (Real-Time Sub-Second JSON vs Async Queues)](https://placesdataapi.com/compare/outscraper-alternative) - [Scrap.io Alternative (2026) — $0.20/1K Sync API vs $49/mo CSV](https://placesdataapi.com/compare/scrap-io-alternative) - [SerpApi Google Maps Alternative (10x Cheaper Volume Pricing)](https://placesdataapi.com/compare/serpapi-google-maps-alternative) --- ## Support & Contact - **Documentation**: [https://placesdataapi.com/docs](https://placesdataapi.com/docs) - **Engineering Support**: `support@placesdataapi.com` / `support@placesdataapi.com`