GET/v1/results

Get Results

Retrieve scraped Google Maps reviews data

Retrieve the scraped review data from your Google Maps Reviews Scraper runs. Results include reviewer information, ratings, review text (original and translated), and place details.

Headers

Key	Value	Required
Authorization	Token YOUR_API_KEY	Yes

Result Fields

string

Unique result identifier

Example: 6ab98eca1b26828a1a206be9d66db305

object

string

Always "result"

Example: result

squid

string

Squid that produced this result

Example: b6ab0f03b02e472a8e2ab0b16b4fdd0f

run

string

Run that produced this result

Example: c29f2f1464ec45d599b1b4f43595bf3a

user_name

string

Reviewer's display name

Example: Jacques LEWINER

score

integer

Rating given (1-5 stars)

Example: 5

text

string

English-translated review text

Example: Everything is perfect...

original_text

string

Original review in native language

Example: Tout est parfait...

lang

string

Language code of original review

Example: fr

published_at

string

Relative time when posted

Example: a week ago

published_at_datetime

timestamp

Exact datetime when posted (ISO 8601)

Example: 2025-03-15T11:56:57.651Z

place_name

string

Name of the reviewed business

Example: La Rôtisserie d'Argent

place_address

string

Business address

Example: 19 Quai de la Tournelle, 75005 Paris

place_average_score

float

Overall rating of the place

Example: 4.4

place_id

string

Google Maps Place ID

Example: ChIJg4octORx5kcRijmhQTSm1Fs

cid

string

Google Maps Customer ID

Example: 6617096495883696522

is_user_local_guide

boolean

Whether reviewer is a Google Local Guide

Example: true

user_reviews_count

integer

Total reviews posted by this user

Example: 4

user_link

string

Link to reviewer's Google Maps profile

Example: https://www.google.com/maps/contrib/...

user_image_url

string

URL of reviewer's profile picture

Example: https://lh3.googleusercontent.com/...

response_from_owner

string

Owner's response to the review (if any)

Example: ""

review_link

string

Direct link to the review on Google Maps

Example: https://www.google.com/maps/reviews/...

short_review_link

string

Shortened URL (requires functions.short_link = true)

Example: https://maps.app.goo.gl/...

pictures

string

URLs of photos attached to the review

Example: ""

total_likes

integer

Number of likes on the review

Example: 0

total_reviews

integer

Total reviews for this place

Example: 3224

visited_in

string

When the reviewer visited

Example: 2025-03-22 00:00:00

scraping_time

timestamp

When this result was scraped

Example: 2025-03-22T13:18:45.227Z

Parameters

squidstring

Required

Hash of the squid to get results from

Example: b6ab0f03b02e472a8e2ab0b16b4fdd0f

runstring

Optional

Hash of a specific run (optional, filters to that run only)

Example: c29f2f1464ec45d599b1b4f43595bf3a

pageinteger

Optional

Page number (default: 1)

Example: 1

page_sizeinteger

Optional

Results per page (default: 50, max: 100)

Example: 50

Pro Tip

The `text` field contains automatically translated English text. Use `original_text` for the native language version.

Pro Tip

Use the `next` URL in the response to paginate through all results.

Note

Results are sorted by scraping time (most recent first) by default.