{
  "openapi": "3.1.0",
  "info": {
    "title": "PlacesData API — Local Business, Reviews, Geocoding & Contact Enrichment REST Specification",
    "version": "1.0.0",
    "description": "High-throughput REST API for local business search, bounding-box & radius discovery, full place details, verified customer reviews, photos, autocomplete, reverse geocoding, website email/social lead enrichment, and WhatsApp number & business account verification. Unified credit billing ($1 = 10,000 Credits, from $0.20 per 1,000 places and $0.12–$0.30 per 1,000 WhatsApp checks).\n\n**Rate Limits & Concurrency**: Free Trial `60 RPM (5 RPS)` · Starter ($29/mo or $10 PAYG) `60 RPM (5 RPS)` · Growth ($79/mo or $50 PAYG) `150 RPM (5 RPS)` · Pro ($199/mo or $100 PAYG) `300 RPM (10 RPS)` · Business ($499/mo or $500 PAYG) `600 RPM (15 RPS)`. Need 1,000+ RPM? Dedicated Enterprise Key Pool available (`support@placesdataapi.com`).\n\n**Smart Caching & Live Refresh**: Search, nearby viewport (~110m coordinate grid), review, place detail, reverse geocoding, and domain enrichment responses cache for `24h` (`86,400s`), and WhatsApp number validations cache for `7d` (`604,800s`) in Redis L1 + PostgreSQL 16 (`?fresh=1` bypasses cache on paid plans)."
  },
  "servers": [
    {
      "url": "https://api.placesdataapi.com",
      "description": "Production Global Edge API Gateway"
    }
  ],
  "tags": [
    {
      "name": "Place Search & Discovery",
      "description": "Natural-language text search and geographic radius / bounding-box discovery across 200M+ Google Maps businesses."
    },
    {
      "name": "Business Details & Media",
      "description": "Full Google Business Profile metadata, verified customer reviews, owner replies, and high-resolution storefront photos."
    },
    {
      "name": "B2B Contact Enrichment",
      "description": "Website email extraction, direct phone verification, and social profile discovery across 8 platforms."
    },
    {
      "name": "Geocoding & Autocomplete",
      "description": "Real-time typeahead place predictions and reverse geocoding from GPS coordinates to street addresses."
    }
  ],
  "paths": {
    "/v1/places/search": {
      "get": {
        "operationId": "v1_places_search",
        "summary": "Place & Business Text Search API for Google Maps",
        "description": "Search local businesses by natural-language query (e.g., 'coffee shops in SoHo, New York' or 'emergency plumbers in Austin, TX'). Returns complete structured business profiles with all 8 core local business search fields: Street Address & Plus Code (`address`, `address_components`, `postal_code`, `plus_code`), Category & Industry (`primary_category`, `categories`), GPS Coordinates (`coordinates`, `latitude`, `longitude`), Opening hours (`opening_hours`, `open_now`, `weekday_text`, `timetable`), Phone (`phone`, `phone_e164`), Overall Rating (`rating`), Review count (`review_count`), and Website (`website`, `domain`).",
        "tags": [
          "Place Search & Discovery"
        ],
        "x-credits-per-request": "5 Credits / place (min 10; 0 if empty)",
        "x-price-per-request": "$0.0005 / place ($0.20–$0.50 / 1K places)",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Free-text search query including business category and location (e.g., 'coffee shops in SoHo, New York').",
            "example": "coffee shops in SoHo, New York",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lat",
            "in": "query",
            "required": false,
            "description": "Optional latitude coordinate to bias search results (-90 to 90).",
            "example": 40.7233,
            "schema": {
              "type": "number",
              "minimum": -90,
              "maximum": 90
            }
          },
          {
            "name": "lng",
            "in": "query",
            "required": false,
            "description": "Optional longitude coordinate to bias search results (-180 to 180).",
            "example": -74.003,
            "schema": {
              "type": "number",
              "minimum": -180,
              "maximum": 180
            }
          },
          {
            "name": "zoom",
            "in": "query",
            "required": false,
            "description": "Map viewport zoom level (3 to 21, default 14).",
            "example": 14,
            "schema": {
              "type": "integer",
              "minimum": 3,
              "maximum": 21,
              "default": 14
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of businesses to return (1 to 100, default 20).",
            "example": 20,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          },
          {
            "name": "region",
            "in": "query",
            "required": false,
            "description": "ISO 3166-1 alpha-2 country code (e.g., 'us', 'gb', 'de').",
            "example": "us",
            "schema": {
              "type": "string",
              "default": "us"
            }
          },
          {
            "name": "language",
            "in": "query",
            "required": false,
            "description": "ISO 639-1 language code for localized names and categories (default 'en').",
            "example": "en",
            "schema": {
              "type": "string",
              "default": "en"
            }
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "description": "Bypass the 24-hour Redis L1 & PostgreSQL 16 spatial index cache and force a live fetch (paid plans).",
            "example": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated list of matching Google Maps business profiles.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PlaceSearchResponse"
                },
                "example": {
                  "code": 0,
                  "status": "ok",
                  "data": [
                    {
                      "place_id": "ChIJf9-RLIRZwokRjcvtdkHcriM",
                      "cid": "5991807586670235506",
                      "google_id": "0x89c2596781ff9537:0x53272e68936b4f72",
                      "name": "Felix Roasting Co.",
                      "description": "Ornate, high-design cafe serving artisanal espresso drinks, housemade non-dairy milks & pastries.",
                      "primary_category": "Coffee shop",
                      "categories": [
                        "Coffee shop",
                        "Cafe",
                        "Espresso bar",
                        "Pastry shop"
                      ],
                      "category": "Coffee shop",
                      "additional_categories": [
                        "Cafe",
                        "Espresso bar",
                        "Pastry shop"
                      ],
                      "phone": "+1 212-359-1139",
                      "phone_e164": "+12123591139",
                      "website": "https://felixroastingco.com",
                      "domain": "felixroastingco.com",
                      "emails": [
                        "info@felixroastingco.com",
                        "events@felixroastingco.com"
                      ],
                      "phones_extra": [
                        "+1 212-359-1139"
                      ],
                      "social_links": {
                        "instagram": "https://www.instagram.com/felixroastingco",
                        "facebook": "https://www.facebook.com/felixroastingco"
                      },
                      "rating": 4.5,
                      "review_count": 782,
                      "reviews_count": 782,
                      "reviews_per_rating": {
                        "1": 24,
                        "2": 18,
                        "3": 42,
                        "4": 136,
                        "5": 562
                      },
                      "rating_distribution": {
                        "1": 24,
                        "2": 18,
                        "3": 42,
                        "4": 136,
                        "5": 562
                      },
                      "price_level": "$$",
                      "address": "450 Broome St, New York, NY 10013",
                      "street_address": "450 Broome St",
                      "borough": "SoHo, Manhattan",
                      "city": "New York",
                      "state": "NY",
                      "postal_code": "10013",
                      "zip_code": "10013",
                      "country_code": "US",
                      "plus_code": "87G7PXCX+WF",
                      "address_components": {
                        "formatted": "450 Broome St, New York, NY 10013",
                        "street": "450 Broome St",
                        "borough": "SoHo, Manhattan",
                        "city": "New York",
                        "state": "NY",
                        "postal_code": "10013",
                        "country_code": "US",
                        "plus_code": "87G7PXCX+WF"
                      },
                      "latitude": 40.722341,
                      "longitude": -74.001298,
                      "coordinates": {
                        "latitude": 40.722341,
                        "longitude": -74.001298
                      },
                      "timezone": "America/New_York",
                      "is_claimed": true,
                      "business_status": "OPERATIONAL",
                      "open_now": true,
                      "opening_hours": {
                        "open_now": true,
                        "current_status": "open",
                        "weekday_text": [
                          "Monday: 08:00–18:00",
                          "Tuesday: 08:00–18:00",
                          "Wednesday: 08:00–18:00",
                          "Thursday: 08:00–18:00",
                          "Friday: 08:00–18:00",
                          "Saturday: 08:30–18:30",
                          "Sunday: 08:30–18:30"
                        ],
                        "timetable": {
                          "monday": [
                            {
                              "open": "08:00",
                              "close": "18:00"
                            }
                          ],
                          "tuesday": [
                            {
                              "open": "08:00",
                              "close": "18:00"
                            }
                          ],
                          "wednesday": [
                            {
                              "open": "08:00",
                              "close": "18:00"
                            }
                          ],
                          "thursday": [
                            {
                              "open": "08:00",
                              "close": "18:00"
                            }
                          ],
                          "friday": [
                            {
                              "open": "08:00",
                              "close": "18:00"
                            }
                          ],
                          "saturday": [
                            {
                              "open": "08:30",
                              "close": "18:30"
                            }
                          ],
                          "sunday": [
                            {
                              "open": "08:30",
                              "close": "18:30"
                            }
                          ]
                        }
                      },
                      "attributes": {
                        "service_options": [
                          "Outdoor seating",
                          "Takeout",
                          "Dine-in"
                        ],
                        "highlights": [
                          "Great coffee",
                          "Great tea selection"
                        ]
                      },
                      "main_image": "https://lh5.googleusercontent.com/p/AF1QipN_felix_soho=w1200-h800-k-no",
                      "total_photos": 680,
                      "booking_url": null,
                      "place_url": "https://www.google.com/maps/place/?q=place_id:ChIJf9-RLIRZwokRjcvtdkHcriM",
                      "google_maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJf9-RLIRZwokRjcvtdkHcriM",
                      "updated_at": "2026-11-15T00:00:00.000Z"
                    }
                  ],
                  "meta": {
                    "request_id": "req_gm_99281a7bc102",
                    "endpoint": "/v1/places/search",
                    "count": 1,
                    "total": 1,
                    "has_more": false,
                    "credits_charged": 5,
                    "took_ms": 18
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/places/nearby": {
      "get": {
        "operationId": "v1_places_nearby",
        "summary": "Nearby & Bounding-Box Search API for Google Maps",
        "description": "Discover businesses inside a geographic viewport around GPS coordinates (`lat`, `lng`, `zoom` or `radius_m`) or inside an explicit bounding box (`min_lat`, `min_lng`, `max_lat`, `max_lng` or `bbox`). Returns complete structured business profiles with all 8 core local business search fields: Street Address & Plus Code (`address`, `address_components`, `postal_code`, `plus_code`), Category & Industry (`primary_category`, `categories`), GPS Coordinates (`coordinates`, `latitude`, `longitude`, `distance_m`), Opening hours (`opening_hours`, `open_now`, `weekday_text`, `timetable`), Phone (`phone`, `phone_e164`), Overall Rating (`rating`), Review count (`review_count`), and Website (`website`, `domain`). Coordinates are normalized on a ~110m 24h edge cache grid for sub-50ms territory sweeps.",
        "tags": [
          "Place Search & Discovery"
        ],
        "x-credits-per-request": "5 Credits / place (min 10; 0 if empty)",
        "x-price-per-request": "$0.0005 / place ($0.20–$0.50 / 1K places)",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Category or keyword to search within the target viewport (e.g., 'italian restaurant', 'dentist', 'HVAC contractor').",
            "example": "italian restaurant",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lat",
            "in": "query",
            "required": true,
            "description": "Center latitude coordinate (-90 to 90). Optional when a full bounding box (min_lat..max_lng or bbox) is supplied.",
            "example": 40.7233,
            "schema": {
              "type": "number",
              "minimum": -90,
              "maximum": 90
            }
          },
          {
            "name": "lng",
            "in": "query",
            "required": true,
            "description": "Center longitude coordinate (-180 to 180). Optional when a full bounding box (min_lat..max_lng or bbox) is supplied.",
            "example": -74.003,
            "schema": {
              "type": "number",
              "minimum": -180,
              "maximum": 180
            }
          },
          {
            "name": "zoom",
            "in": "query",
            "required": false,
            "description": "Map viewport zoom level (3 to 21, default 15). Automatically sets search radius when radius_m is omitted (zoom 15 = 2500m, zoom 14 = 5000m, zoom 12 = 15000m).",
            "example": 15,
            "schema": {
              "type": "integer",
              "minimum": 3,
              "maximum": 21,
              "default": 15
            }
          },
          {
            "name": "radius_m",
            "in": "query",
            "required": false,
            "description": "Explicit search radius in meters (100 to 50000; alias: radius). Overrides zoom-based radius.",
            "example": 2500,
            "schema": {
              "type": "integer",
              "minimum": 100,
              "maximum": 50000
            }
          },
          {
            "name": "min_lat",
            "in": "query",
            "required": false,
            "description": "Southwest bounding-box latitude (-90 to 90) for strict rectangular grid filtering.",
            "example": 40.715,
            "schema": {
              "type": "number",
              "minimum": -90,
              "maximum": 90
            }
          },
          {
            "name": "min_lng",
            "in": "query",
            "required": false,
            "description": "Southwest bounding-box longitude (-180 to 180) for strict rectangular grid filtering.",
            "example": -74.012,
            "schema": {
              "type": "number",
              "minimum": -180,
              "maximum": 180
            }
          },
          {
            "name": "max_lat",
            "in": "query",
            "required": false,
            "description": "Northeast bounding-box latitude (-90 to 90) for strict rectangular grid filtering.",
            "example": 40.732,
            "schema": {
              "type": "number",
              "minimum": -90,
              "maximum": 90
            }
          },
          {
            "name": "max_lng",
            "in": "query",
            "required": false,
            "description": "Northeast bounding-box longitude (-180 to 180) for strict rectangular grid filtering.",
            "example": -73.992,
            "schema": {
              "type": "number",
              "minimum": -180,
              "maximum": 180
            }
          },
          {
            "name": "bbox",
            "in": "query",
            "required": false,
            "description": "Shorthand bounding box 'min_lng,min_lat,max_lng,max_lat' (RFC 7946 GeoJSON order).",
            "example": "-74.012,40.715,-73.992,40.732",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of businesses to return (1 to 100, default 20).",
            "example": 20,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          },
          {
            "name": "language",
            "in": "query",
            "required": false,
            "description": "ISO 639-1 language code (default 'en').",
            "example": "en",
            "schema": {
              "type": "string",
              "default": "en"
            }
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "description": "Bypass the 24-hour Redis L1 cache and force a live viewport fetch (paid plans).",
            "example": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Businesses discovered inside the target coordinate viewport.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PlaceSearchResponse"
                },
                "example": {
                  "code": 0,
                  "status": "ok",
                  "data": [
                    {
                      "place_id": "ChIJ_Rubirosa_SoHo_NYC",
                      "cid": "1489120394817263510",
                      "google_id": "0x89c2598811223344:0x14ac9876543210ef",
                      "name": "Rubirosa",
                      "description": "Cozy Nolita & SoHo neighborhood Italian restaurant famous for thin-crust vodka pizza & homemade pasta.",
                      "primary_category": "Italian restaurant",
                      "categories": [
                        "Italian restaurant",
                        "Pizza restaurant",
                        "Pasta shop",
                        "Restaurant"
                      ],
                      "category": "Italian restaurant",
                      "additional_categories": [
                        "Pizza restaurant",
                        "Pasta shop",
                        "Restaurant"
                      ],
                      "phone": "+1 212-965-0500",
                      "phone_e164": "+12129650500",
                      "website": "https://www.rubirosanyc.com",
                      "domain": "rubirosanyc.com",
                      "emails": [
                        "info@rubirosanyc.com"
                      ],
                      "phones_extra": [
                        "+1 212-965-0500"
                      ],
                      "social_links": {
                        "instagram": "https://www.instagram.com/rubirosanyc"
                      },
                      "rating": 4.6,
                      "review_count": 3420,
                      "reviews_count": 3420,
                      "reviews_per_rating": {
                        "1": 65,
                        "2": 58,
                        "3": 185,
                        "4": 692,
                        "5": 2420
                      },
                      "price_level": "$$",
                      "address": "235 Mulberry St, New York, NY 10012",
                      "street_address": "235 Mulberry St",
                      "borough": "Nolita, Manhattan",
                      "city": "New York",
                      "state": "NY",
                      "postal_code": "10012",
                      "zip_code": "10012",
                      "country_code": "US",
                      "plus_code": "87G8P2F3+3G",
                      "address_components": {
                        "formatted": "235 Mulberry St, New York, NY 10012",
                        "street": "235 Mulberry St",
                        "borough": "Nolita, Manhattan",
                        "city": "New York",
                        "state": "NY",
                        "postal_code": "10012",
                        "country_code": "US",
                        "plus_code": "87G8P2F3+3G"
                      },
                      "latitude": 40.722731,
                      "longitude": -73.996218,
                      "coordinates": {
                        "latitude": 40.722731,
                        "longitude": -73.996218
                      },
                      "distance_m": 575,
                      "timezone": "America/New_York",
                      "is_claimed": true,
                      "business_status": "OPERATIONAL",
                      "open_now": true,
                      "opening_hours": {
                        "open_now": true,
                        "current_status": "open",
                        "weekday_text": [
                          "Monday: 11:30–22:30",
                          "Tuesday: 11:30–22:30",
                          "Wednesday: 11:30–22:30",
                          "Thursday: 11:30–23:00",
                          "Friday: 11:30–23:30",
                          "Saturday: 11:30–23:30",
                          "Sunday: 11:30–22:30"
                        ],
                        "timetable": {
                          "monday": [
                            {
                              "open": "11:30",
                              "close": "22:30"
                            }
                          ],
                          "tuesday": [
                            {
                              "open": "11:30",
                              "close": "22:30"
                            }
                          ],
                          "wednesday": [
                            {
                              "open": "11:30",
                              "close": "22:30"
                            }
                          ],
                          "thursday": [
                            {
                              "open": "11:30",
                              "close": "23:00"
                            }
                          ],
                          "friday": [
                            {
                              "open": "11:30",
                              "close": "23:30"
                            }
                          ],
                          "saturday": [
                            {
                              "open": "11:30",
                              "close": "23:30"
                            }
                          ],
                          "sunday": [
                            {
                              "open": "11:30",
                              "close": "22:30"
                            }
                          ]
                        }
                      },
                      "booking_url": "https://resy.com/cities/ny/rubirosa",
                      "place_url": "https://www.google.com/maps/place/?q=place_id:ChIJ_Rubirosa_SoHo_NYC",
                      "google_maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJ_Rubirosa_SoHo_NYC",
                      "updated_at": "2026-11-15T00:00:00.000Z"
                    }
                  ],
                  "meta": {
                    "request_id": "req_gm_88412b9dc401",
                    "endpoint": "/v1/places/nearby",
                    "count": 1,
                    "total": 3,
                    "has_more": false,
                    "credits_charged": 5,
                    "took_ms": 14
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/places/details": {
      "get": {
        "operationId": "v1_places_details",
        "summary": "Place Details & Business Profile API for Google Maps",
        "description": "Retrieve the complete Google Business Profile by `place_id`, `cid`, or `google_id` in sub-50ms from the 24h edge & PostgreSQL 16 index. Returns Description (`description`), Category & Industry (`primary_category`, `categories`, `additional_categories`), Phones (`phone`, `phone_e164`, `phones_extra`), Website & Domain (`website`, `domain`), Emails (`emails`), Social profiles (`social_links` across LinkedIn, Instagram, Facebook, X/Twitter, YouTube, TikTok), Street Address / Headquarters & Locations (`address`, `address_components`, `postal_code`, `plus_code`, `coordinates`, `latitude`, `longitude`), Overall Rating & Review count (`rating`, `review_count`, `reviews_per_rating`), Opening hours (`open_now`, `opening_hours`, `weekday_text`, `timetable`), Type and status (`business_status`, `is_claimed`, `price_level`, `attributes`), and Storefront Images & Photos (`main_image`, `total_photos`).",
        "tags": [
          "Business Details & Media"
        ],
        "x-credits-per-request": "20 Credits / business profile",
        "x-price-per-request": "$0.002 / profile ($0.80–$2.00 / 1K profiles)",
        "parameters": [
          {
            "name": "place_id",
            "in": "query",
            "required": true,
            "description": "Canonical Place ID (e.g., 'ChIJf9-RLIRZwokRjcvtdkHcriM'), numeric CID, hex feature ID, or Maps URL.",
            "example": "ChIJf9-RLIRZwokRjcvtdkHcriM",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "language",
            "in": "query",
            "required": false,
            "description": "ISO 639-1 language code (default 'en').",
            "example": "en",
            "schema": {
              "type": "string",
              "default": "en"
            }
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "description": "Bypass the 24-hour Redis L1 & PostgreSQL 16 cache and fetch live (paid plans).",
            "example": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Complete Google Business Profile object.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PlaceDetailsResponse"
                },
                "example": {
                  "code": 0,
                  "status": "ok",
                  "data": {
                    "place_id": "ChIJf9-RLIRZwokRjcvtdkHcriM",
                    "cid": "5991807586670235506",
                    "google_id": "0x89c2596781ff9537:0x53272e68936b4f72",
                    "name": "Felix Roasting Co.",
                    "description": "Ornate, high-design cafe serving artisanal espresso drinks, housemade non-dairy milks & pastries.",
                    "primary_category": "Coffee shop",
                    "categories": [
                      "Coffee shop",
                      "Cafe",
                      "Espresso bar",
                      "Pastry shop"
                    ],
                    "category": "Coffee shop",
                    "additional_categories": [
                      "Cafe",
                      "Espresso bar",
                      "Pastry shop"
                    ],
                    "phone": "+1 212-359-1139",
                    "phone_e164": "+12123591139",
                    "website": "https://felixroastingco.com",
                    "domain": "felixroastingco.com",
                    "emails": [
                      "info@felixroastingco.com",
                      "events@felixroastingco.com"
                    ],
                    "phones_extra": [
                      "+1 212-359-1139"
                    ],
                    "social_links": {
                      "instagram": "https://www.instagram.com/felixroastingco",
                      "facebook": "https://www.facebook.com/felixroastingco"
                    },
                    "rating": 4.5,
                    "review_count": 782,
                    "reviews_count": 782,
                    "reviews_per_rating": {
                      "1": 24,
                      "2": 18,
                      "3": 42,
                      "4": 136,
                      "5": 562
                    },
                    "rating_distribution": {
                      "1": 24,
                      "2": 18,
                      "3": 42,
                      "4": 136,
                      "5": 562
                    },
                    "price_level": "$$",
                    "address": "450 Broome St, New York, NY 10013",
                    "street_address": "450 Broome St",
                    "borough": "SoHo, Manhattan",
                    "city": "New York",
                    "state": "NY",
                    "postal_code": "10013",
                    "zip_code": "10013",
                    "country_code": "US",
                    "plus_code": "87G7PXCX+WF",
                    "address_components": {
                      "formatted": "450 Broome St, New York, NY 10013",
                      "street": "450 Broome St",
                      "borough": "SoHo, Manhattan",
                      "city": "New York",
                      "state": "NY",
                      "postal_code": "10013",
                      "country_code": "US",
                      "plus_code": "87G7PXCX+WF"
                    },
                    "latitude": 40.722341,
                    "longitude": -74.001298,
                    "coordinates": {
                      "latitude": 40.722341,
                      "longitude": -74.001298
                    },
                    "timezone": "America/New_York",
                    "is_claimed": true,
                    "business_status": "OPERATIONAL",
                    "open_now": true,
                    "opening_hours": {
                      "open_now": true,
                      "current_status": "open",
                      "weekday_text": [
                        "Monday: 08:00–18:00",
                        "Tuesday: 08:00–18:00",
                        "Wednesday: 08:00–18:00",
                        "Thursday: 08:00–18:00",
                        "Friday: 08:00–18:00",
                        "Saturday: 08:30–18:30",
                        "Sunday: 08:30–18:30"
                      ],
                      "timetable": {
                        "monday": [
                          {
                            "open": "08:00",
                            "close": "18:00"
                          }
                        ],
                        "tuesday": [
                          {
                            "open": "08:00",
                            "close": "18:00"
                          }
                        ],
                        "wednesday": [
                          {
                            "open": "08:00",
                            "close": "18:00"
                          }
                        ],
                        "thursday": [
                          {
                            "open": "08:00",
                            "close": "18:00"
                          }
                        ],
                        "friday": [
                          {
                            "open": "08:00",
                            "close": "18:00"
                          }
                        ],
                        "saturday": [
                          {
                            "open": "08:30",
                            "close": "18:30"
                          }
                        ],
                        "sunday": [
                          {
                            "open": "08:30",
                            "close": "18:30"
                          }
                        ]
                      }
                    },
                    "attributes": {
                      "service_options": [
                        "Outdoor seating",
                        "Takeout",
                        "Dine-in"
                      ],
                      "highlights": [
                        "Great coffee",
                        "Great tea selection"
                      ]
                    },
                    "main_image": "https://lh5.googleusercontent.com/p/AF1QipN_felix_soho=w1200-h800-k-no",
                    "total_photos": 680,
                    "booking_url": null,
                    "place_url": "https://www.google.com/maps/place/?q=place_id:ChIJf9-RLIRZwokRjcvtdkHcriM",
                    "google_maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJf9-RLIRZwokRjcvtdkHcriM",
                    "updated_at": "2026-11-15T00:00:00.000Z"
                  },
                  "meta": {
                    "request_id": "req_gm_77123c8ea901",
                    "endpoint": "/v1/places/details",
                    "credits_charged": 20,
                    "took_ms": 12
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/places/reviews": {
      "get": {
        "operationId": "v1_places_reviews",
        "summary": "Customer Reviews & Replies API for Google Maps",
        "description": "Fetch verified customer reviews and merchant-level aggregate rating statistics for any Google Maps business by `place_id` or `cid`. Returns the business Overall rating (`overall_rating` / `rating`), total Review count (`review_count` / `user_ratings_total`), and 1–5 star rating distribution alongside paginated customer reviews containing individual review Rating (`rating`), review Text (`review_text`), publication Date (`published_at`, `published_relative`), Reviewer profile (`author_name`, `author_url`, `author_photo`, `author_reviews_count`, `is_local_guide`), review Photos (`photos`), and business owner Reply (`owner_response`, `owner_response_at`).",
        "tags": [
          "Business Details & Media"
        ],
        "x-credits-per-request": "2 Credits / review (min 10; 0 if empty)",
        "x-price-per-request": "$0.0002 / review ($0.08–$0.20 / 1K reviews)",
        "parameters": [
          {
            "name": "place_id",
            "in": "query",
            "required": true,
            "description": "Google Maps Place ID or numeric CID.",
            "example": "ChIJSy28upiAhYARkoxpzFnW7b4",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Sort order: 'most_relevant', 'newest', 'highest_rating', or 'lowest_rating'.",
            "example": "newest",
            "schema": {
              "type": "string",
              "enum": [
                "most_relevant",
                "newest",
                "highest_rating",
                "lowest_rating"
              ],
              "default": "newest"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Number of reviews to return (1 to 100, default 20).",
            "example": 20,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          },
          {
            "name": "query",
            "in": "query",
            "required": false,
            "description": "Optional keyword filter to match inside review text (e.g., 'espresso', 'service').",
            "example": "espresso",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Merchant overall rating & total review count alongside paginated verified customer reviews, reviewer profiles, review photos, and owner replies.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PlaceReviewsResponse"
                },
                "example": {
                  "code": 0,
                  "provider": "https://placesdataapi.com",
                  "status": "ok",
                  "msg": "success",
                  "place_id": "ChIJSy28upiAhYARkoxpzFnW7b4",
                  "place_name": "Blue Bottle Coffee",
                  "overall_rating": 4.6,
                  "rating": 4.6,
                  "review_count": 909,
                  "user_ratings_total": 909,
                  "reviews_per_rating": {
                    "1": 21,
                    "2": 19,
                    "3": 54,
                    "4": 182,
                    "5": 633
                  },
                  "data": [
                    {
                      "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xWVmFGSk1ZVzFLTWtSMFdHOVlVRmxyWTI4NFpYYxAB",
                      "place_id": "ChIJSy28upiAhYARkoxpzFnW7b4",
                      "author_name": "Elena Rostova",
                      "author_url": "https://www.google.com/maps/contrib/106620658472166895892/reviews?hl=en-US",
                      "author_photo": "https://lh3.googleusercontent.com/a-/ALV-UjVXrv5CCEO2UAjxWxgu3RbYBEx71rt0hk9jZHlFRmzR175Zh3tc=s64-c-rp-mo-ba12-br100",
                      "author_reviews_count": 46,
                      "is_local_guide": true,
                      "rating": 5,
                      "review_text": "Single-origin pour-over and New Orleans iced coffee were dialed in perfectly. Fast service even during the morning rush.",
                      "published_at": "2026-11-03T20:03:16.145Z",
                      "published_relative": "2 weeks ago",
                      "owner_response": "Thank you for visiting us, Elena! Glad you enjoyed the single-origin pour-over.",
                      "owner_response_at": "2026-11-04T09:15:00.000Z",
                      "likes_count": 4,
                      "photos": [
                        "https://lh5.googleusercontent.com/p/AF1QipN928172_blue_bottle_pourover"
                      ],
                      "language": "en"
                    }
                  ],
                  "meta": {
                    "request_id": "req_gm_66109d2fa118",
                    "place_id": "ChIJSy28upiAhYARkoxpzFnW7b4",
                    "overall_rating": 4.6,
                    "review_count": 909,
                    "user_ratings_total": 909,
                    "count": 1,
                    "sort": "newest",
                    "credits_charged": 2,
                    "took_ms": 3
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/places/photos": {
      "get": {
        "operationId": "v1_places_photos",
        "summary": "Storefront & Place Photos API for Google Maps",
        "description": "Retrieve high-resolution photo URLs, dimensions, categories (exterior, interior, food & drink, menu), and contributor attribution for a Google Maps business.",
        "tags": [
          "Business Details & Media"
        ],
        "x-credits-per-request": "2 Credits / photo (min 6; 0 if empty)",
        "x-price-per-request": "$0.0002 / photo ($0.08–$0.20 / 1K photos)",
        "parameters": [
          {
            "name": "place_id",
            "in": "query",
            "required": true,
            "description": "Google Maps Place ID or numeric CID.",
            "example": "ChIJN5X_gWdZwokRck9rk2guJ1M",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of photos to return (1 to 50, default 20).",
            "example": 20,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of high-resolution business storefront, interior, menu, and customer photos with GPS coordinates and timestamps.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PlacePhotosResponse"
                },
                "example": {
                  "code": 0,
                  "provider": "https://placesdataapi.com",
                  "status": "ok",
                  "msg": "success",
                  "data": [
                    {
                      "photo_id": "AF1QipN928172_felix_interior",
                      "place_id": "ChIJf9-RLIRZwokRjcvtdkHcriM",
                      "photo_url": "https://lh5.googleusercontent.com/p/AF1QipN928172_felix_interior=w800-h600-k-no",
                      "photo_url_large": "https://lh5.googleusercontent.com/p/AF1QipN928172_felix_interior=w1600-h1200-k-no",
                      "video_thumbnail_url": null,
                      "type": "photo",
                      "latitude": 40.722341,
                      "longitude": -74.001298,
                      "photo_datetime_utc": "2026-08-14T12:00:00.000Z"
                    }
                  ],
                  "meta": {
                    "request_id": "req_gm_55012e9ab304",
                    "place_id": "ChIJf9-RLIRZwokRjcvtdkHcriM",
                    "count": 1,
                    "credits_charged": 2,
                    "took_ms": 8
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/leads/enrich": {
      "get": {
        "operationId": "v1_leads_enrich",
        "summary": "Website Email & Contact Enrichment API for Google Maps",
        "description": "Crawl a business website domain (alias `/v1/enrich/contacts`) to extract verified B2B Emails (`emails`), direct Phones (`phones`), website metadata (`domain`, `website_url`, `company_name`), and official Social profiles (`social_links` across LinkedIn, Instagram, Facebook, X/Twitter, YouTube, and TikTok). Charges 0 Credits if no emails or social profiles are found.",
        "tags": [
          "B2B Contact Enrichment"
        ],
        "x-credits-per-request": "20 Credits / enriched domain (0 if none found)",
        "x-price-per-request": "$0.002 / enriched domain ($0.80–$2.00 / 1K leads)",
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "description": "Business website domain or URL (e.g., 'felixroastingco.com' or 'bluebottlecoffee.com').",
            "example": "felixroastingco.com",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "place_id",
            "in": "query",
            "required": false,
            "description": "Optional Google Maps Place ID to link enriched contacts back to the stored business profile.",
            "example": "ChIJN5X_gWdZwokRck9rk2guJ1M",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Extracted verified business emails, direct phone numbers, and social profiles (LinkedIn, Instagram, Facebook, X/Twitter, YouTube, TikTok) for the target domain.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LeadEnrichResponse"
                },
                "example": {
                  "code": 0,
                  "provider": "https://placesdataapi.com",
                  "status": "ok",
                  "msg": "success",
                  "data": {
                    "domain": "felixroastingco.com",
                    "website_url": "https://felixroastingco.com",
                    "company_name": "Felix Roasting Co.",
                    "emails": [
                      "info@felixroastingco.com",
                      "events@felixroastingco.com"
                    ],
                    "phones": [
                      "+1 212-359-1139"
                    ],
                    "social_links": {
                      "linkedin": "https://www.linkedin.com/company/felix-roasting-co",
                      "instagram": "https://www.instagram.com/felixroastingco",
                      "facebook": "https://www.facebook.com/felixroastingco",
                      "twitter": null,
                      "youtube": null,
                      "tiktok": null
                    },
                    "scraped_pages": 2,
                    "http_status": 200,
                    "cached": true,
                    "updated_at": "2026-11-15T19:13:32.845Z"
                  },
                  "meta": {
                    "request_id": "req_gm_44918f7cd209",
                    "domain": "felixroastingco.com",
                    "contacts_found": true,
                    "credits_charged": 20,
                    "took_ms": 4
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/enrich/whatsapp": {
      "get": {
        "operationId": "v1_enrich_whatsapp",
        "summary": "WhatsApp Number & Business Account Check API",
        "description": "Validate in real time whether an international E.164 phone number is registered on WhatsApp, detect WhatsApp Business accounts, resolve its WhatsApp JID (`<digits>@s.whatsapp.net`), and return ITU country/region and numbering plan metadata. Also mounted at aliases `POST /v1/whatsapp/validate`, `GET /v1/whatsapp/check`, and `GET /v1/places/whatsapp-check`. Charges 3 Credits per valid E.164 check ($0.12–$0.30 / 1K checks; 0 Credits on synthetic invalid numbers or errors).",
        "tags": [
          "B2B Contact Enrichment"
        ],
        "x-credits-per-request": "3 Credits / check (0 on synthetic invalid or error)",
        "x-price-per-request": "$0.0003 / check ($0.12–$0.30 / 1K checks)",
        "parameters": [
          {
            "name": "phone",
            "in": "query",
            "required": true,
            "description": "Phone number in E.164 or international format (aliases `number` and `phone_number` also accepted; spaces, parentheses, and hyphens are stripped automatically).",
            "example": "+18002428478",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "description": "Set `1` or `true` on paid plans to bypass the 7-day (`604,800s`) verification cache.",
            "example": "0",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "WhatsApp registration status, WhatsApp Business flag, JID, ITU place metadata, and E.164 numbering plan validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WhatsappCheckResponse"
                },
                "example": {
                  "code": 0,
                  "provider": "https://placesdataapi.com",
                  "status": "ok",
                  "msg": "success",
                  "data": {
                    "phone_e164": "+18002428478",
                    "on_whatsapp": true,
                    "is_registered": true,
                    "business_account": true,
                    "is_business": true,
                    "whatsapp_id": "18002428478@s.whatsapp.net",
                    "wa_id": "18002428478",
                    "place": {
                      "country_code": "US",
                      "country_name": "United States",
                      "calling_code": "+1",
                      "region": "North America"
                    },
                    "numbering_plan": {
                      "valid_e164": true,
                      "country_code": "US",
                      "calling_code": "+1",
                      "national_number": "8002428478"
                    },
                    "messaging_apps": {
                      "whatsapp": {
                        "on_whatsapp": true,
                        "business_account": true,
                        "whatsapp_id": "18002428478@s.whatsapp.net"
                      }
                    }
                  },
                  "meta": {
                    "request_id": "req_gm_99201a4bc812",
                    "endpoint": "/v1/enrich/whatsapp",
                    "credits_charged": 3,
                    "cached": true,
                    "took_ms": 4
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "v1_enrich_whatsapp_post",
        "summary": "WhatsApp Number Validation (POST JSON)",
        "description": "POST JSON variant of `/v1/enrich/whatsapp` (also mounted at `POST /v1/whatsapp/validate`). Accepts `phone`, `number`, or `phone_number` in the JSON body, normalizes spaces/hyphens into E.164, and returns WhatsApp registration status, Business account detection, WhatsApp JID, ITU country metadata, and E.164 numbering plan validation.",
        "tags": [
          "B2B Contact Enrichment"
        ],
        "x-credits-per-request": "3 Credits / check (0 on synthetic invalid or error)",
        "x-price-per-request": "$0.0003 / check ($0.12–$0.30 / 1K checks)",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WhatsappCheckRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "WhatsApp registration status, WhatsApp Business flag, JID, ITU place metadata, and E.164 numbering plan validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WhatsappCheckResponse"
                }
              }
            }
          }
        }
      }
    },
    "/v1/places/autocomplete": {
      "get": {
        "operationId": "v1_places_autocomplete",
        "summary": "Place & Address Autocomplete API for Google Maps",
        "description": "Real-time typeahead predictions for businesses, street addresses, cities, and landmarks with optional coordinate and country biasing.",
        "tags": [
          "Geocoding & Autocomplete"
        ],
        "x-credits-per-request": "5 Credits / request",
        "x-price-per-request": "$0.0005 / request ($0.20–$0.50 / 1K calls)",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Partial text input from the user (e.g., '1600 Amphitheatre' or 'Felix Roast').",
            "example": "1600 Amphitheatre",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "ISO 3166-1 alpha-2 country code restriction (e.g., 'US').",
            "example": "US",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lat",
            "in": "query",
            "required": false,
            "description": "Optional latitude for proximity biasing.",
            "example": 37.422,
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "lng",
            "in": "query",
            "required": false,
            "description": "Optional longitude for proximity biasing.",
            "example": -122.084,
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Ordered list of typeahead place and address predictions.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AutocompleteResponse"
                },
                "example": {
                  "request_id": "req_gm_33817a4bc110",
                  "status": "ok",
                  "data": [
                    {
                      "place_id": "ChIJtYuu0V25j4ARwu5e4wwRYgE",
                      "description": "1600 Amphitheatre Parkway, Mountain View, CA, USA",
                      "main_text": "1600 Amphitheatre Parkway",
                      "secondary_text": "Mountain View, CA, USA",
                      "types": [
                        "street_address",
                        "geocode"
                      ],
                      "coordinates": {
                        "latitude": 37.4220656,
                        "longitude": -122.0840897
                      }
                    }
                  ],
                  "meta": {
                    "credits_used": 5,
                    "credits_remaining": 1919,
                    "count": 1,
                    "has_more": false,
                    "next_cursor": null,
                    "cache_hit": false
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/geocode/reverse": {
      "get": {
        "operationId": "v1_geocode_reverse",
        "summary": "Reverse Geocoding API for Google Maps (Lat/Lng)",
        "description": "Convert raw GPS latitude and longitude coordinates into structured street addresses, postal codes, administrative areas, and corresponding Google Maps Place IDs.",
        "tags": [
          "Geocoding & Autocomplete"
        ],
        "x-credits-per-request": "5 Credits / request",
        "x-price-per-request": "$0.0005 / request ($0.20–$0.50 / 1K calls)",
        "parameters": [
          {
            "name": "lat",
            "in": "query",
            "required": true,
            "description": "Latitude coordinate (-90 to 90).",
            "example": 40.722341,
            "schema": {
              "type": "number",
              "minimum": -90,
              "maximum": 90
            }
          },
          {
            "name": "lng",
            "in": "query",
            "required": true,
            "description": "Longitude coordinate (-180 to 180).",
            "example": -74.001298,
            "schema": {
              "type": "number",
              "minimum": -180,
              "maximum": 180
            }
          },
          {
            "name": "language",
            "in": "query",
            "required": false,
            "description": "ISO 639-1 language code (default 'en').",
            "example": "en",
            "schema": {
              "type": "string",
              "default": "en"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Structured address components and matching place_ids for the coordinates.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReverseGeocodeResponse"
                },
                "example": {
                  "request_id": "req_gm_22901b8de512",
                  "status": "ok",
                  "data": [
                    {
                      "place_id": "ChIJN5X_gWdZwokRck9rk2guJ1M",
                      "formatted_address": "450 Broome St, New York, NY 10013, USA",
                      "address_components": {
                        "street_number": "450",
                        "route": "Broome St",
                        "neighborhood": "SoHo",
                        "locality": "New York",
                        "administrative_area_level_1": "NY",
                        "postal_code": "10013",
                        "country_code": "US"
                      },
                      "coordinates": {
                        "latitude": 40.722341,
                        "longitude": -74.001298
                      },
                      "plus_code": "87G7PXXW+8Q"
                    }
                  ],
                  "meta": {
                    "credits_used": 5,
                    "credits_remaining": 1914,
                    "count": 1,
                    "has_more": false,
                    "next_cursor": null,
                    "cache_hit": false
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ResponseMeta": {
        "type": "object",
        "description": "Gateway execution, pagination, and credit billing metadata.",
        "properties": {
          "request_id": {
            "type": "string",
            "description": "Unique request trace identifier."
          },
          "endpoint": {
            "type": "string",
            "description": "Normalized gateway endpoint path."
          },
          "count": {
            "type": "integer",
            "description": "Number of records returned in `data`."
          },
          "total": {
            "type": "integer",
            "description": "Total matching records available in the index (for search/nearby)."
          },
          "has_more": {
            "type": "boolean",
            "description": "Whether additional pages are available."
          },
          "overall_rating": {
            "type": "number",
            "description": "Aggregate business overall star rating (included on `/v1/places/reviews` when indexed)."
          },
          "review_count": {
            "type": "integer",
            "description": "Total business review count across Google Maps (included on `/v1/places/reviews` when indexed)."
          },
          "user_ratings_total": {
            "type": "integer",
            "description": "Alias of `review_count` (total business review count)."
          },
          "credits_charged": {
            "type": "integer",
            "description": "Credits deducted for this API call (`0` on empty results or errors)."
          },
          "cached": {
            "type": "boolean",
            "description": "Whether the response was served from the sub-50ms Redis L1 / PostgreSQL 16 cache."
          },
          "took_ms": {
            "type": "integer",
            "description": "Server-side execution latency in milliseconds."
          }
        }
      },
      "AddressObject": {
        "type": "object",
        "properties": {
          "formatted": {
            "type": "string",
            "description": "Full human-readable street address."
          },
          "street": {
            "type": "string",
            "description": "Street number and street name."
          },
          "borough": {
            "type": "string",
            "description": "Neighborhood, district, or borough."
          },
          "city": {
            "type": "string",
            "description": "City or locality."
          },
          "state": {
            "type": "string",
            "description": "State, province, or region."
          },
          "postal_code": {
            "type": "string",
            "description": "ZIP or postal code."
          },
          "country_code": {
            "type": "string",
            "description": "ISO 3166-1 alpha-2 country code."
          },
          "plus_code": {
            "type": "string",
            "description": "8+2 character Open Location Code (Plus Code)."
          }
        },
        "description": "Structured physical business location, street address, locality, postal code, country, and Plus Code."
      },
      "CoordinatesObject": {
        "type": "object",
        "properties": {
          "latitude": {
            "type": "number",
            "description": "WGS84 latitude coordinate."
          },
          "longitude": {
            "type": "number",
            "description": "WGS84 longitude coordinate."
          }
        },
        "description": "WGS84 geographic coordinates (`latitude` and `longitude`) of the business location."
      },
      "PlaceSummary": {
        "type": "object",
        "description": "Complete structured Google Maps business profile with address, category/industry, coordinates, opening hours, phones, emails, social profiles, images/photos, rating, and review count.",
        "properties": {
          "place_id": {
            "type": "string",
            "description": "Canonical Google Maps Place ID (`ChIJ...`)."
          },
          "cid": {
            "type": "string",
            "description": "Numeric Google Maps Customer ID (`CID`)."
          },
          "google_id": {
            "type": "string",
            "description": "Hexadecimal Google feature ID (`0x...:0x...`)."
          },
          "name": {
            "type": "string",
            "description": "Official business or organization name."
          },
          "description": {
            "type": "string",
            "description": "Merchant or editorial business description summarizing offerings and specialties."
          },
          "primary_category": {
            "type": "string",
            "description": "Primary business category and industry classification (e.g., 'Coffee shop', 'HVAC contractor', 'Law firm')."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Deduplicated list of primary and secondary business categories and industry tags."
          },
          "category": {
            "type": "string",
            "description": "Alias of `primary_category` for backward compatibility."
          },
          "additional_categories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Secondary categories and industry sub-classifications assigned to the listing."
          },
          "rating": {
            "type": "number",
            "description": "Overall star rating of the business across Google Maps reviews (1.0 to 5.0)."
          },
          "review_count": {
            "type": "integer",
            "description": "Total customer review count on the business listing."
          },
          "reviews_count": {
            "type": "integer",
            "description": "Alias of `review_count` (total customer review count)."
          },
          "reviews_per_rating": {
            "type": "object",
            "description": "Star rating breakdown histogram keyed from '1' to '5'.",
            "additionalProperties": {
              "type": "integer"
            }
          },
          "rating_distribution": {
            "type": "object",
            "description": "Alias of `reviews_per_rating` (1-star to 5-star review counts).",
            "additionalProperties": {
              "type": "integer"
            }
          },
          "price_level": {
            "type": "string",
            "description": "Merchant price tier indicator (`$` to `$$$$`)."
          },
          "phone": {
            "type": "string",
            "description": "Formatted local business phone number."
          },
          "phone_e164": {
            "type": "string",
            "description": "Normalized E.164 international phone number (e.g., '+12123591139')."
          },
          "phones_extra": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Additional direct business phone numbers discovered for the company."
          },
          "website": {
            "type": "string",
            "description": "Official business website URL."
          },
          "domain": {
            "type": "string",
            "description": "Normalized root company domain (e.g., 'felixroastingco.com')."
          },
          "emails": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Verified business email addresses associated with the company domain."
          },
          "social_links": {
            "$ref": "#/components/schemas/SocialLinksObject"
          },
          "address": {
            "type": "string",
            "description": "Full human-readable street address and physical location / headquarters address."
          },
          "street_address": {
            "type": "string",
            "description": "Street number and street name."
          },
          "borough": {
            "type": "string",
            "description": "Neighborhood, district, or borough."
          },
          "city": {
            "type": "string",
            "description": "City or municipality of the business location."
          },
          "state": {
            "type": "string",
            "description": "State, province, or administrative region."
          },
          "postal_code": {
            "type": "string",
            "description": "ZIP or postal code."
          },
          "zip_code": {
            "type": "string",
            "description": "Alias of `postal_code`."
          },
          "country_code": {
            "type": "string",
            "description": "ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'DE')."
          },
          "plus_code": {
            "type": "string",
            "description": "Computed 8+2 Open Location Code (Plus Code, e.g., '87G7PXCX+WF')."
          },
          "address_components": {
            "$ref": "#/components/schemas/AddressObject"
          },
          "latitude": {
            "type": "number",
            "description": "WGS84 latitude coordinate of the business location."
          },
          "longitude": {
            "type": "number",
            "description": "WGS84 longitude coordinate of the business location."
          },
          "coordinates": {
            "$ref": "#/components/schemas/CoordinatesObject"
          },
          "distance_m": {
            "type": "integer",
            "description": "Great-circle distance in meters from search center (returned on coordinate/nearby queries)."
          },
          "timezone": {
            "type": "string",
            "description": "IANA timezone identifier (e.g., 'America/New_York')."
          },
          "open_now": {
            "type": "boolean",
            "description": "Opening hours live flag indicating whether the business is currently open."
          },
          "opening_hours": {
            "$ref": "#/components/schemas/OpeningHoursObject"
          },
          "work_hours": {
            "type": "object",
            "description": "Raw timetable schedule object preserved for backward compatibility."
          },
          "popular_times": {
            "type": "object",
            "description": "Hourly foot-traffic popularity histogram by day of week when published on Maps."
          },
          "business_status": {
            "type": "string",
            "description": "Business operating type and status ('OPERATIONAL', 'CLOSED_TEMPORARILY', or 'CLOSED_PERMANENTLY')."
          },
          "is_claimed": {
            "type": "boolean",
            "description": "Whether the business profile is owner-claimed and verified."
          },
          "attributes": {
            "type": "object",
            "description": "Business attributes, service options, accessibility, amenities, and highlights."
          },
          "main_image": {
            "type": "string",
            "description": "Primary high-resolution storefront or interior image / photo URL."
          },
          "total_photos": {
            "type": "integer",
            "description": "Total count of storefront, interior, menu, and customer images / photos on the listing."
          },
          "booking_url": {
            "type": "string",
            "description": "Direct reservation, appointment, or online ordering URL if published."
          },
          "place_url": {
            "type": "string",
            "description": "Direct canonical Google Maps URL for the listing."
          },
          "google_maps_url": {
            "type": "string",
            "description": "Alias of `place_url` linking directly to the listing on Google Maps."
          },
          "updated_at": {
            "type": "string",
            "description": "ISO 8601 timestamp when the business record was last refreshed."
          }
        }
      },
      "PlaceSearchResponse": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "Gateway status code (`0` for success)."
          },
          "provider": {
            "type": "string",
            "description": "Gateway provider identifier ('https://placesdataapi.com')."
          },
          "status": {
            "type": "string",
            "description": "Response status ('ok')."
          },
          "msg": {
            "type": "string",
            "description": "Human-readable status message ('success')."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PlaceSummary"
            },
            "description": "Matching business profiles with address, category, coordinates, opening hours, phone, website, rating, and review count."
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        }
      },
      "PlaceDetailsResponse": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "Gateway status code (`0` for success)."
          },
          "provider": {
            "type": "string",
            "description": "Gateway provider identifier ('https://placesdataapi.com')."
          },
          "status": {
            "type": "string",
            "description": "Response status ('ok')."
          },
          "msg": {
            "type": "string",
            "description": "Human-readable status message ('success')."
          },
          "data": {
            "$ref": "#/components/schemas/PlaceSummary",
            "description": "Complete Google Business Profile with description, category/industry, phones, emails, social profiles, locations/coordinates, opening hours, type/status, and images/photos."
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        }
      },
      "ReviewItem": {
        "type": "object",
        "description": "Individual verified Google Maps customer review with rating, review text, date, reviewer details, photos, and owner reply.",
        "properties": {
          "review_id": {
            "type": "string",
            "description": "Unique Google Maps review identifier."
          },
          "place_id": {
            "type": "string",
            "description": "Associated Google Maps Place ID."
          },
          "author_name": {
            "type": "string",
            "description": "Reviewer display name on Google Maps."
          },
          "author_url": {
            "type": "string",
            "description": "Reviewer public Google Maps contributor profile URL."
          },
          "author_photo": {
            "type": "string",
            "description": "Reviewer avatar / profile photo URL."
          },
          "author_reviews_count": {
            "type": "integer",
            "description": "Total number of Google Maps reviews written by this reviewer."
          },
          "is_local_guide": {
            "type": "boolean",
            "description": "Whether the reviewer holds verified Google Local Guide status."
          },
          "rating": {
            "type": "number",
            "description": "Individual customer review star rating (1 to 5)."
          },
          "review_text": {
            "type": "string",
            "description": "Full customer review text body."
          },
          "published_at": {
            "type": "string",
            "description": "ISO 8601 review publication date and UTC timestamp."
          },
          "published_relative": {
            "type": "string",
            "description": "Human-readable relative review date (e.g., '2 weeks ago')."
          },
          "owner_response": {
            "type": "string",
            "description": "Merchant / business owner reply text (`null` when the owner has not replied)."
          },
          "owner_response_at": {
            "type": "string",
            "description": "ISO 8601 UTC timestamp when the business owner reply was posted (`null` if none)."
          },
          "likes_count": {
            "type": "integer",
            "description": "Number of helpful votes / likes on the review."
          },
          "photos": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Array of customer-uploaded review photo / image URLs."
          },
          "language": {
            "type": "string",
            "description": "ISO 639-1 language code of the review text (e.g., 'en')."
          }
        }
      },
      "PlaceReviewsResponse": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "Gateway status code (`0` for success)."
          },
          "provider": {
            "type": "string",
            "description": "Gateway provider identifier ('https://placesdataapi.com')."
          },
          "status": {
            "type": "string",
            "description": "Response status ('ok')."
          },
          "msg": {
            "type": "string",
            "description": "Human-readable status message ('success')."
          },
          "place_id": {
            "type": "string",
            "description": "Canonical Google Maps Place ID of the business."
          },
          "place_name": {
            "type": "string",
            "description": "Official business name (when indexed in the local profile store)."
          },
          "overall_rating": {
            "type": "number",
            "description": "Overall rating: aggregate business star rating across all Google Maps reviews (1.0 to 5.0, or `null` if unknown)."
          },
          "rating": {
            "type": "number",
            "description": "Alias of `overall_rating` (aggregate business overall star rating, 1.0 to 5.0)."
          },
          "review_count": {
            "type": "integer",
            "description": "Review count: total number of customer reviews on the business profile (or `null` if unknown)."
          },
          "user_ratings_total": {
            "type": "integer",
            "description": "Google Places-compatible alias of `review_count` (total business review count)."
          },
          "reviews_per_rating": {
            "type": "object",
            "description": "1-star through 5-star review count breakdown histogram for the business (when available).",
            "additionalProperties": {
              "type": "integer"
            }
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReviewItem"
            },
            "description": "Paginated array of verified customer reviews (rating, text, date, reviewer, photos, and owner reply)."
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        }
      },
      "PhotoItem": {
        "type": "object",
        "description": "Business storefront, interior, menu, or contributor photo item.",
        "properties": {
          "photo_id": {
            "type": "string",
            "description": "Unique photo identifier."
          },
          "place_id": {
            "type": "string",
            "description": "Associated Google Maps Place ID."
          },
          "photo_url": {
            "type": "string",
            "description": "Standard-resolution direct photo image URL."
          },
          "photo_url_large": {
            "type": "string",
            "description": "Full high-resolution direct photo image URL."
          },
          "video_thumbnail_url": {
            "type": "string",
            "description": "Video preview thumbnail URL when the media item is a short clip (`null` for still photos)."
          },
          "type": {
            "type": "string",
            "description": "Media item classification (e.g., 'photo')."
          },
          "latitude": {
            "type": "number",
            "description": "Geotagged WGS84 latitude of the photo (`null` if unset)."
          },
          "longitude": {
            "type": "number",
            "description": "Geotagged WGS84 longitude of the photo (`null` if unset)."
          },
          "photo_datetime_utc": {
            "type": "string",
            "description": "ISO 8601 UTC upload timestamp of the photo."
          }
        }
      },
      "PlacePhotosResponse": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "Gateway status code (`0` for success)."
          },
          "provider": {
            "type": "string",
            "description": "Gateway provider identifier ('https://placesdataapi.com')."
          },
          "status": {
            "type": "string",
            "description": "Response status ('ok')."
          },
          "msg": {
            "type": "string",
            "description": "Human-readable status message ('success')."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PhotoItem"
            },
            "description": "High-resolution business photos and storefront images."
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        }
      },
      "LeadEnrichData": {
        "type": "object",
        "description": "Extracted B2B company emails, direct phone numbers, website metadata, and social profiles for a business domain.",
        "properties": {
          "domain": {
            "type": "string",
            "description": "Normalized root business domain (e.g., 'felixroastingco.com')."
          },
          "website_url": {
            "type": "string",
            "description": "Canonical HTTPS company website URL crawled."
          },
          "company_name": {
            "type": "string",
            "description": "Extracted company or merchant title (`null` when not declared on page)."
          },
          "emails": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Deduplicated verified business email addresses extracted from public website pages (`/` , `/contact`, `/pages/contact`, `/about`)."
          },
          "phones": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Direct business phone numbers extracted from public website pages."
          },
          "social_links": {
            "$ref": "#/components/schemas/SocialLinksObject"
          },
          "scraped_pages": {
            "type": "integer",
            "description": "Number of public website pages inspected during enrichment."
          },
          "http_status": {
            "type": "integer",
            "description": "HTTP status code returned by the target company website."
          },
          "cached": {
            "type": "boolean",
            "description": "Whether the enriched contact record was served from the local PostgreSQL cache."
          },
          "updated_at": {
            "type": "string",
            "description": "ISO 8601 UTC timestamp when the domain contacts were last refreshed."
          }
        }
      },
      "LeadEnrichResponse": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "Gateway status code (`0` for success)."
          },
          "provider": {
            "type": "string",
            "description": "Gateway provider identifier ('https://placesdataapi.com')."
          },
          "status": {
            "type": "string",
            "description": "Response status ('ok')."
          },
          "msg": {
            "type": "string",
            "description": "Human-readable status message ('success')."
          },
          "data": {
            "$ref": "#/components/schemas/LeadEnrichData"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        }
      },
      "AutocompletePrediction": {
        "type": "object",
        "properties": {
          "place_id": {
            "type": "string",
            "description": "Google Maps Place ID."
          },
          "description": {
            "type": "string",
            "description": "Full prediction label."
          },
          "main_text": {
            "type": "string",
            "description": "Primary place or street name."
          },
          "secondary_text": {
            "type": "string",
            "description": "City, state, and country context."
          },
          "types": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Place classification tags."
          },
          "coordinates": {
            "$ref": "#/components/schemas/CoordinatesObject"
          }
        }
      },
      "AutocompleteResponse": {
        "type": "object",
        "properties": {
          "request_id": {
            "type": "string",
            "description": "Unique request trace identifier."
          },
          "status": {
            "type": "string",
            "description": "Response status ('ok')."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AutocompletePrediction"
            },
            "description": "Typeahead predictions."
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        }
      },
      "ReverseGeocodeResult": {
        "type": "object",
        "properties": {
          "place_id": {
            "type": "string",
            "description": "Nearest Google Maps Place ID."
          },
          "formatted_address": {
            "type": "string",
            "description": "Formatted street address."
          },
          "coordinates": {
            "$ref": "#/components/schemas/CoordinatesObject"
          },
          "plus_code": {
            "type": "string",
            "description": "Open Location Code."
          }
        }
      },
      "ReverseGeocodeResponse": {
        "type": "object",
        "properties": {
          "request_id": {
            "type": "string",
            "description": "Unique request trace identifier."
          },
          "status": {
            "type": "string",
            "description": "Response status ('ok')."
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReverseGeocodeResult"
            },
            "description": "Reverse geocoded addresses."
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        }
      },
      "OpeningHoursPeriod": {
        "type": "object",
        "properties": {
          "open": {
            "type": "string",
            "description": "Opening time in 24-hour HH:MM format (e.g., '08:00')."
          },
          "close": {
            "type": "string",
            "description": "Closing time in 24-hour HH:MM format (e.g., '18:00')."
          }
        }
      },
      "OpeningHoursObject": {
        "type": "object",
        "description": "Structured weekly opening hours schedule, live open/closed status, weekday_text schedule lines, and 24-hour timetable intervals.",
        "properties": {
          "open_now": {
            "type": "boolean",
            "description": "Real-time opening hours boolean indicating whether the business is currently open."
          },
          "current_status": {
            "type": "string",
            "description": "Normalized opening hours status ('open', 'closed', 'closed_temporarily', 'closed_permanently')."
          },
          "weekday_text": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Human-readable weekly opening hours lines (Monday through Sunday, e.g., 'Monday: 08:00–18:00')."
          },
          "timetable": {
            "type": "object",
            "description": "Per-weekday opening hours intervals (`{ open, close }` in 24-hour HH:MM format) keyed by lowercase weekday (`monday`..`sunday`).",
            "additionalProperties": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/OpeningHoursPeriod"
              }
            }
          }
        }
      },
      "WhatsappCheckRequest": {
        "type": "object",
        "required": [
          "phone"
        ],
        "properties": {
          "phone": {
            "type": "string",
            "description": "International phone number in E.164 format (aliases `number` and `phone_number` also accepted).",
            "example": "+18002428478"
          },
          "fresh": {
            "type": "boolean",
            "description": "Set `true` on paid plans to bypass the 7-day (`604,800s`) cache."
          }
        }
      },
      "WhatsappPlaceInfo": {
        "type": "object",
        "description": "ITU international country and geographic region resolved from the E.164 calling code and area code.",
        "properties": {
          "country_code": {
            "type": "string",
            "description": "ISO 3166-1 alpha-2 country code (e.g., 'US', 'CA', 'GB', 'BR').",
            "example": "US"
          },
          "country_name": {
            "type": "string",
            "description": "Full English country or territory name (e.g., 'United States', 'United Kingdom').",
            "example": "United States"
          },
          "calling_code": {
            "type": "string",
            "description": "ITU international dialing prefix with '+' (e.g., '+1', '+44', '+86').",
            "example": "+1"
          },
          "region": {
            "type": "string",
            "description": "Geographic macro-region (e.g., 'North America', 'Europe', 'Asia', 'South America').",
            "example": "North America"
          }
        }
      },
      "WhatsappNumberingPlan": {
        "type": "object",
        "description": "ITU-T E.164 numbering plan validation and parsed national subscriber number.",
        "properties": {
          "valid_e164": {
            "type": "boolean",
            "description": "Whether the phone number conforms to a valid, non-fictional ITU-T E.164 numbering plan.",
            "example": true
          },
          "country_code": {
            "type": "string",
            "description": "ISO 3166-1 alpha-2 country code.",
            "example": "US"
          },
          "calling_code": {
            "type": "string",
            "description": "International calling prefix with '+'.",
            "example": "+1"
          },
          "national_number": {
            "type": "string",
            "description": "National significant number stripped of international calling code.",
            "example": "8002428478"
          }
        }
      },
      "WhatsappMessagingAppStatus": {
        "type": "object",
        "description": "Structured messaging app presence status.",
        "properties": {
          "whatsapp": {
            "type": "object",
            "properties": {
              "on_whatsapp": {
                "type": "boolean",
                "description": "Whether the phone number has an active WhatsApp account.",
                "example": true
              },
              "business_account": {
                "type": "boolean",
                "description": "Whether the account is a WhatsApp Business or verified commercial line.",
                "example": true
              },
              "whatsapp_id": {
                "type": "string",
                "description": "Canonical WhatsApp JID (`<digits>@s.whatsapp.net`) when registered, or `null`.",
                "example": "18002428478@s.whatsapp.net"
              }
            }
          }
        }
      },
      "WhatsappCheckData": {
        "type": "object",
        "properties": {
          "phone_e164": {
            "type": "string",
            "description": "Normalized E.164 phone number with '+' prefix.",
            "example": "+18002428478"
          },
          "on_whatsapp": {
            "type": "boolean",
            "description": "Whether the number is registered on WhatsApp.",
            "example": true
          },
          "is_registered": {
            "type": "boolean",
            "description": "Boolean alias of `on_whatsapp` for SDK compatibility.",
            "example": true
          },
          "business_account": {
            "type": "boolean",
            "description": "Whether the WhatsApp account is a Business account.",
            "example": true
          },
          "is_business": {
            "type": "boolean",
            "description": "Boolean alias of `business_account`.",
            "example": true
          },
          "whatsapp_id": {
            "type": "string",
            "description": "Canonical WhatsApp JID (`<digits>@s.whatsapp.net`) when registered, else `null`.",
            "example": "18002428478@s.whatsapp.net"
          },
          "wa_id": {
            "type": "string",
            "description": "Digits-only WhatsApp user ID when registered, else `null`.",
            "example": "18002428478"
          },
          "place": {
            "$ref": "#/components/schemas/WhatsappPlaceInfo"
          },
          "numbering_plan": {
            "$ref": "#/components/schemas/WhatsappNumberingPlan"
          },
          "messaging_apps": {
            "$ref": "#/components/schemas/WhatsappMessagingAppStatus"
          }
        }
      },
      "WhatsappCheckResponse": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "Gateway status code (`0` for success)."
          },
          "status": {
            "type": "string",
            "description": "Response status ('ok')."
          },
          "data": {
            "$ref": "#/components/schemas/WhatsappCheckData"
          },
          "meta": {
            "$ref": "#/components/schemas/ResponseMeta"
          }
        }
      },
      "SocialLinksObject": {
        "type": "object",
        "description": "Official company social profiles across LinkedIn, Instagram, Facebook, X/Twitter, YouTube, and TikTok.",
        "properties": {
          "linkedin": {
            "type": "string",
            "description": "Company or founder LinkedIn profile URL (e.g., 'https://www.linkedin.com/company/...')."
          },
          "instagram": {
            "type": "string",
            "description": "Official Instagram profile URL."
          },
          "facebook": {
            "type": "string",
            "description": "Official Facebook business page URL."
          },
          "twitter": {
            "type": "string",
            "description": "Official X (Twitter) profile URL."
          },
          "youtube": {
            "type": "string",
            "description": "Official YouTube channel URL."
          },
          "tiktok": {
            "type": "string",
            "description": "Official TikTok profile URL."
          }
        }
      }
    }
  }
}