Skip to main content
Core.Today
|
SerperFastHigh

Serper Google Places

Google Maps places through Serper - name, address, rating, review count, category, phone and coordinates. 3 credits per search.

3 credits
per search
Local businesses from Google Maps
Rating, review count, phone and website
Coordinates for mapping

Run it right now

Test this model instantly in the Console Playground โ€” no code required

Sign in to try

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "serper/places",
  "input": {
    "q": "์นดํŽ˜ ์„ฑ์ˆ˜๋™",
    "gl": "kr",
    "hl": "ko"
  }
}'

Parameters

ParameterTypeRequiredDefaultDescription
qstringYes-The search query.
glstringNo-Country of the results as a lowercase ISO 3166-1 code (e.g. kr, us). Serper default us.
hlstringNo-Language of the results (e.g. ko, en). Serper default en.
locationstringNo-Search as if from this place, e.g. Seoul, South Korea.
pageintegerNo1Results page (1 = first).

Common Parameters

Common parameters used when calling POST /v1/predictions.

ParameterTypeRequiredDefaultDescription
modelstringYes-Model identifier
inputobjectYes-Object containing the model-specific parameters from the table above
output_folderstringNo-Folder path for output files (max 256 chars, '..' not allowed)
webhook_urlstringNo-Webhook URL to call on completion
is_publicbooleanNofalseIf true, output files are also available via permanent public URLs

Examples

Basic request

A typical request with the most common options.

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "serper/places",
  "input": {
    "q": "์นดํŽ˜ ์„ฑ์ˆ˜๋™",
    "gl": "kr",
    "hl": "ko"
  }
}'

Tips & Best Practices

1The result is the provider's JSON as-is (places)
2Links in the result point to the original pages - nothing is copied to your storage
3Billed on the credits Serper reports in the response (`credits`) - the reservation is refunded down to it

Use Cases

Local recommendations in chat agents
Lead lists by area and category
Store locators