Search reviews - Autotouch AI

This page documents the canonical HTTP contract. Switch to the CLI example when you want the operator workflow.

Pricing: 1 credit per 25 returned reviews. Credits are charged on actual returned results, not requested limit.

You must provide one listing identifier: cid, place_id, or fid.

Body parameters

cid · optional
string
Optional Google CID.
place_id · optional
string
Optional Google place ID.
fid · optional
string
Optional provider listing ID.
sort_by · optional
string
Review ordering. Default: newest.
limit · optional
integer
Maximum reviews to return. Default: 25. Range: 1–100.
country · optional
string
Country code. Default: us.
language · optional
string
Language code. Default: en.
next_page_token · optional
string
Optional provider continuation token.
page · optional
integer
Page number. Default: 1; must be at least 1.

Name	Type	Description
cid	string	Optional Google CID.
place_id	string	Optional Google place ID.
fid	string	Optional provider listing ID.
sort_by	string	Review ordering. Default: newest.
limit	integer	Maximum reviews to return. Default: 25. Range: 1–100.
country	string	Country code. Default: us.
language	string	Language code. Default: en.
next_page_token	string	Optional provider continuation token.
page	integer	Page number. Default: 1; must be at least 1.

Errors

Status	Meaning
400	The search/provider rejected the request.
422	At least one of cid, place_id, or fid is required; typed range validation failed.
401	Invalid API key or missing auth.
403	Missing search:run scope.

Example

bash

curl -X POST "https://app.autotouch.ai/api/search/reviews" \
  -H "Authorization: Bearer stk_your_key_id.your_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
    "limit": 25
  }'

Request body

json

{
  "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
  "limit": 25
}

Response example

json

{
  "items": [
    {
      "author": "J. Smith",
      "rating": 5,
      "text": "Great onboarding experience for remote hires.",
      "published_at": "2026-03-01T12:00:00Z"
    }
  ],
  "total_found": 1,
  "billable_results": 1,
  "credits_used": 1,
  "pricing_rule": "1 credit per 25 results",
  "metadata": {"cid": null, "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4", "fid": null, "next_page_token": null, "topics": null}
}