Places Autocomplete

0.1 credits

Get Google Maps place predictions as the user types.

POST/api/v1/tools/google/places/autocomplete

Parameters

inputstringrequired

Partial text input. Results are predictions, not guaranteed matches.

locationstring

Bias results near "lat,lng"

radiusnumber

Bias radius in meters

typesstring

Type filter (e.g. "establishment", "geocode")

languagestring

Language code for results

fieldsstring[]

Fields to return per prediction. Omit for defaults: placeId, description, mainText, secondaryText, types. Available fields: placeId, description, mainText, secondaryText, types, type, place, matches, mainTextMatches, secondaryTextMatches, distanceMeters, terms. Use ["*"] for all fields. The status and errorMessage wrapper fields are always returned.

Response Schema

dataobject[]

Array of predictions

placeIdstring

Google Place ID

descriptionstring

Full place description

mainTextstring

Primary text (place name)

secondaryTextstring

Secondary text (address)

typesstring[]

Place type tags

metaobject

Request metadata

toolstring

Tool name (places/autocomplete)

creditsUsednumber

Credits consumed (0.1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/google/places/autocomplete \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"input": "Starbucks Shib"}'

Response Example

{
  "data": [
    {
      "placeId": "ChIJX_zua6N2LGGAR04lCFnCTqqk",
      "description": "Starbucks Reserve Roastery Tokyo, Aoyama, Shibuya City, Tokyo",
      "mainText": "Starbucks Reserve Roastery Tokyo",
      "secondaryText": "Aoyama, Shibuya City, Tokyo",
      "types": [
        "cafe",
        "establishment"
      ]
    }
  ],
  "meta": {
    "tool": "google-places-autocomplete",
    "creditsUsed": 0.1,
    "requestId": "req_abc123"
  }
}

{

"data": [

{

"placeId": "ChIJX_zua6N2LGGAR04lCFnCTqqk",

"description": "Starbucks Reserve Roastery Tokyo, Aoyama, Shibuya City, Tokyo",

"mainText": "Starbucks Reserve Roastery Tokyo",

"secondaryText": "Aoyama, Shibuya City, Tokyo",

"types": [

"cafe",

"establishment"

]

}

"meta": {

"tool": "google-places-autocomplete",

"creditsUsed": 0.1,

"requestId": "req_abc123"

}