For the complete documentation index, see llms.txt. This page is also available as Markdown.

Google Maps

Google Maps: place search, place details, and place reviews.

get

Search Google Maps for places by free-text query. Use offset (a numeric string) to paginate or maxItems for a one-shot bulk pull (mutually exclusive). Optional geo filters: latitude, longitude, zoom.

Price: $0.001 per item

Minimum charge: $0.01 per request (10 items)

Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
querystring · min: 1 · max: 200RequiredExample: pizza in New York
countryCodestring · min: 2 · max: 5Optional
languageCodestring · min: 2 · max: 10Optional
latitudestringOptionalPattern: ^-?\d+(\.\d+)?$
longitudestringOptionalPattern: ^-?\d+(\.\d+)?$
zoomstringOptionalPattern: ^\d+(\.\d+)?$
maxItemsinteger · min: 1 · max: 500Optional
offsetstringOptionalPattern: ^\d+$
Responses
200

Successful request

application/json
requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24
statusintegerOptionalExample: 200
messagestringOptionalExample: OK
successbooleanOptionalExample: true
get/google-maps/place/search
GET /google-maps/place/search?query=text HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "url": "https://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89c25985f7ec1beb:0x3c39f655da433d9d",
      "title": "Prince Street Pizza",
      "description": null,
      "address": "27 Prince St, New York, NY 10012",
      "neighborhood": "Manhattan",
      "street": "27 Prince St",
      "district": "New York",
      "postalCode": "10012",
      "city": "New York",
      "country": "United States",
      "location": {
        "lat": 40.7230777,
        "lng": -73.9945444
      },
      "website": "https://locations.princestreetpizza.com/new-york",
      "phone": "(212) 966-4100",
      "price": "$10–20",
      "totalScore": 4.4,
      "placeId": "ChIJ6xvs94VZwokRnT1D2lX2OTw",
      "fid": "0x89c25985f7ec1beb:0x3c39f655da433d9d",
      "reviewsCount": 9039,
      "categories": [
        "Pizza restaurant"
      ],
      "openingHours": [],
      "additionalInfo": {}
    }
  ],
  "pagination": {
    "page": 1,
    "hasNextPage": null,
    "cursor": null,
    "offset": null
  },
  "pricing": {
    "currency": "USD",
    "amountCharged": "0.010000",
    "billableItems": 10
  }
}

Get a Google Maps place by FID

get

Returns full details for a Google Maps place identified by its FID (e.g. 0x47e671d877937b0f:0xb975fcfa192f84d4).

Price: $0.005 per item

Minimum charge: $0.005 per request (1 item)

Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
fidstringRequiredExample: 0x47e671d877937b0f:0xb975fcfa192f84d4Pattern: ^0x[a-fA-F0-9]+:0x[a-fA-F0-9]+$
Query parameters
countryCodestring · min: 2 · max: 5Optional
languageCodestring · min: 2 · max: 10Optional
Responses
200

Successful request

application/json
requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24
statusintegerOptionalExample: 200
messagestringOptionalExample: OK
successbooleanOptionalExample: true
get/google-maps/place/{fid}
GET /google-maps/place/{fid} HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "url": "https://www.google.com/maps/preview/place/Louvre+Museum",
      "title": "Louvre Museum",
      "address": "Louvre Museum, 75001 Paris, France",
      "neighborhood": "text",
      "street": "text",
      "district": "Paris",
      "postalCode": "75001",
      "city": "text",
      "location": {
        "lat": 40.7230777,
        "lng": -73.9945444
      },
      "website": "https://www.louvre.fr/",
      "phone": "+33 1 40 20 53 17",
      "phoneUnformatted": "+33140205317",
      "plusCode": "V86Q+63 Paris, France",
      "price": "text",
      "totalScore": 4.7,
      "placeId": "ChIJD3uTd9hx5kcR1IQvGfr8dbk",
      "cid": "-5082878453323168556",
      "fid": "0x47e671d877937b0f:0xb975fcfa192f84d4",
      "reviewsCount": 366153,
      "reviewsDistribution": {
        "oneStar": 5180,
        "twoStar": 3447,
        "threeStar": 13286,
        "fourStar": 52471,
        "fiveStar": 291769
      },
      "categories": [
        "Art museum",
        "Museum",
        "Tourist attraction"
      ],
      "additionalInfo": {}
    }
  ],
  "pricing": {
    "currency": "USD",
    "amountCharged": "0.005000",
    "billableItems": 1
  }
}

Get reviews for a Google Maps place

get

Returns reviews for a place identified by its full Google Maps URL. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive).

Price: $0.001 per item

Minimum charge: $0.01 per request (10 items)

Your current plan discount applies to the total. The minimum applies once per request, even when fewer items are returned. maxItems limits requested results; it does not lower the minimum billable count.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
placeUrlstring · uri · min: 10 · max: 1000RequiredExample: https://www.google.com/maps/place/Louvre+Museum/@48.8606111,2.3350691,17z/data=!3m1!5s0x47f112d46c2f6eef:0xfb8a933f53aec2c6!4m8!3m7!1s0x47e671d877937b0f:0xb975fcfa192f84d4!8m2!3d48.8606111!4d2.337644!9m1!1b1!16zL20vMDRnZHI?entry=ttu&g_ep=EgoyMDI2MDMwOC4wIKXMDSoASAFQAw%3D%3D
maxItemsinteger · min: 1 · max: 500Optional
cursorstringOptional
Responses
200

Successful request

application/json
requestIdstring · uuidOptionalExample: 3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24
statusintegerOptionalExample: 200
messagestringOptionalExample: OK
successbooleanOptionalExample: true
get/google-maps/place/reviews
GET /google-maps/place/reviews?placeUrl=https%3A%2F%2Fexample.com HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
  "status": 200,
  "message": "OK",
  "success": true,
  "data": [
    {
      "id": "Ci9DQUlRQUNvZENodHljRjlvT25OdmExZHZVSEJPYjJkRGIxVXpiRFIzYXpWUmFFRRAB",
      "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25OdmExZHZVSEJPYjJkRGIxVXpiRFIzYXpWUmFFRRAB",
      "text": "Loved the experience",
      "stars": 5,
      "date": 1777380220000,
      "dateIso": "2026-04-28T12:43:40.000Z",
      "likes": null,
      "photos": [],
      "reviewer": {
        "name": "Jane Doe",
        "photo": "https://example.com/reviewer-photo.jpg",
        "url": "https://www.google.com/maps/contrib/000000000000000000000?hl=en-US",
        "totalReviews": 2,
        "totalPhotos": 7
      },
      "ownersResponse": {},
      "details": {
        "Visited on": "Weekend",
        "Wait time": "10–30 min",
        "Reservation recommended": "Yes"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "hasNextPage": null,
    "cursor": null,
    "offset": null
  },
  "pricing": {
    "currency": "USD",
    "amountCharged": "0.010000",
    "billableItems": 10
  }
}

Last updated