Skip to content

DataForSEO

Merchant Google Reviews

Retrieve product reviews from Google Shopping. Obtain gid from Google Shopping Products. Submit once with action=submit. Reuse this same tool with action=result and its id to read status/output at no additional cost. Queued is not finished.

Usage based DataForSEOSEOdataforseo/merchant-google-reviewsActive

Use this tool with your agent

Give this to your agent
Use my connected Agentik MCP server. I want to use the tool dataforseo/merchant-google-reviews (Merchant Google Reviews). Call inspect_tool with {"tool_id": "dataforseo/merchant-google-reviews"} first and tell me the price before anything runs. Ask me for the inputs it needs; never invent values, IDs or file URLs. When I confirm, call run_tool with tool_id "dataforseo/merchant-google-reviews" and my inputs, follow it with get_run if it is still running, and give me the result and the price Agentik reports. If the tool is unavailable, say so and use discover_tools to propose an alternative.
Show the prompt

Paste it into Claude, ChatGPT or Codex: your agent takes it from there, and shows the price before it runs.

Parameters

NameTypeRequiredDescription
gidstringNorequired field; global product identifier from Google Shopping Products
product_idstringNo
data_docidstringNo
location_codeintegerNorequired field if location_name omitted
location_namestringNorequired field if location_code omitted
language_codestringNorequired field if language_name omitted
language_namestringNorequired field if language_code omitted
depthintegerNo
priorityintegerNoOptions: 1, 2.
tagstringNo
actionstringNoOptions: submit, result.
idstringNo

How your agent calls it

First inspect_tool for the current schema and price, then run_tool with the published example after confirming your inputs:

{
  "tool_id": "dataforseo/merchant-google-reviews",
  "input": {
    "gid": "4702526954592161872",
    "product_id": "4485466949985702538",
    "data_docid": "13071766526042404278",
    "language_code": "en",
    "location_code": 2840,
    "depth": 10,
    "action": "submit"
  }
}

Price and billing

Price
Usage based
Model
Usage based
Detail
Billed at the cost the provider reports for the call, never above $100. Your agent sees the maximum before running.
  • The provider’s price, 0% markup.
  • One prepaid balance for every provider; your agent sees the price before it runs.
  • Pay for measured usage; unused reservations are released.