POST/v1/squids/{squid_hash}

Update Settings

Configure the Google Maps Reviews Scraper parameters

Configure the scraper parameters to control how reviews are collected. These settings determine sorting, filtering, and what data is extracted.

Headers

Key	Value	Required
Authorization	Token YOUR_API_KEY	Yes
Content-Type	application/json	Yes

Scraper Parameters

sort_by

Type:

string

Default:

newest

Description:

Sort reviews: `newest`, `most relevant`, or `highest rating`

hours_back

Type:

integer

Default:

null

Description:

Only collect reviews from the last N hours. Set `null` for no limit

max_results

Type:

integer

Default:

Description:

Maximum number of reviews to collect per place

language

Type:

string

Default:

English (United States)

Description:

Language for extracted reviews

functions.short_link

Type:

boolean

Default:

false

Description:

Collect shortened review links (additional costs may apply)

Squid Settings

name

Type:

string

Description:

Name for your squid configuration

concurrency

Type:

integer

Description:

Number of parallel scraping workers (1-10)

export_unique_results

Type:

boolean

Description:

Only export unique results (deduplicated)

run_notify

Type:

string

Description:

When to send notifications: `on_success`, `on_failure`, `always`, `never`

timezone

Type:

string

Description:

Timezone for timestamps (e.g., `Europe/Paris`)

Pro Tip

Use `sort_by: newest` to monitor recent reviews for reputation management.

Pro Tip

Set `hours_back` to limit results to recent reviews only, reducing processing time and costs.

Warning

Enabling `functions.short_link` may incur additional costs. Only enable if you need shortened URLs.

Note

Changes take effect on the next run. Running jobs use the settings from when they started.