# Serper Google Places

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

- **Provider**: serper
- **Model ID**: serper/places
- **Category**: web_search
- **Credits**: from 3 for the default configuration — varies by input, see Pricing
- **Pricing Type**: formula

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `q` (string, **required**): The search query.
- `location` (string, optional): Search as if from this place, e.g. Seoul, South Korea.
- `page` (integer, optional): Results page (1 = first). (Default: `1`; Range: min: 1)
- `hl` (string, optional): Language of the results (e.g. ko, en). Serper default en.
- `gl` (string, optional): Country of the results as a lowercase ISO 3166-1 code (e.g. kr, us). Serper default us.

## Example Request

```json
{
  "model": "serper/places",
  "input": {
    "hl": "ko",
    "q": "카페 성수동",
    "gl": "kr"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "serper",
  "model": "serper/places",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null,
  "credits_used": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

When the job is `completed`, `result` holds the output URL(s) or data and `credits_used` the net credits charged. When it is `failed`, `error` and `error_code` say why and the charge is refunded.

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Pricing

- Formula: `2.325 * max(1, min(1, billed))` credits
  - `billed`: 99

Default configuration: 3 credits.

These are list prices. The amount charged is rounded, and large charges are discounted progressively. `POST /predictions/estimate` with the same `model` and `input` returns the charge for that input without creating a job (an estimate when the price depends on the output).

## Output Type

json

## Tags

serper, google, places, maps, local

## Documentation

https://serper.dev