Skip to main content
Glama

AIsa Business Listings & Reviews

Get Business Data Google Reviews Results by id

get_dataforseo_business_google_reviews_fetch
Read-onlyIdempotent

The returned results are specific to the indicated local establishment name, search engine, location and language parameters. We emulate set location and search engine with the highest accuracy so that the results you receive will match the actual search results for the specified parameters at the time of task setting. You can always check the returned results accessing the check_url in the Incognito mode to make sure the received data is entirely relevant. Note that user preferences, search history, and other personalized search factors are ignored by our system and thus would not be reflected in the returned results.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idYestask identifier unique task identifier in our system in the UUID format you will be able to use it within 30 days to request the results of the task at any time

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / id / description
      Previous value: -"DataForSEO task ID."New value: +"task identifier unique task identifier in our system in the UUID format you will be able to use it within 30 days to request the results of the task at any time"
  2. First observed

TDQS

C2.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/idempotent/openWorld/non-destructive, so the safety profile is covered; beyond that the description adds genuine behavioral context — that results reflect the search state at task-setting time, that personalization/search history is ignored, and that check_url can be used to independently verify fidelity. It does not, however, state the 30-day retrieval window or pagination/result-size behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences are spent entirely on output provenance and verification, which is largely wasted because an output schema already exists. Nothing is front-loaded — the reader never learns the tool's action or its prerequisite, so the content is misallocated rather than tight.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Because an output schema exists, return-value explanation is unnecessary and the description's budget should have gone to the essentials: that this is the result-retrieval half of a submit/fetch pair and that the id comes from the submit call. Those critical usage facts are missing, leaving the definition incomplete for an agent deciding between it and its many siblings.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With one parameter at 100% schema description coverage, the schema fully documents the UUID task identifier and its 30-day usability, so the baseline is 3. The description adds no meaning about the id beyond the vague phrase 'at the time of task setting'.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description never states a retrieval verb: it describes what the returned results are scoped to (establishment, search engine, location, language) without saying the tool fetches the stored result of a previously submitted task. Only the tool name/title ('Get ... Results by id') conveys the action, and nothing distinguishes it from sibling fetchers like get_dataforseo_business_google_extended_reviews_fetch or get_dataforseo_business_tripadvisor_reviews_fetch.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no when-to-use or when-not-to-use guidance and no mention of the prerequisite that a task must first be created via post_dataforseo_business_google_reviews_submit. The only actionable hint ('accessing the check_url') is about verifying output, not about choosing this tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources