Google Business Reviews by Maps CID, Incl. Linked Sites (20, New York Location, English)

omnial/google-business-extended-reviews

Given a business's Google Maps CID, returns its name, address line, average rating, rating count and review total, plus up to 20 reviews, some shown from other review sites: each review's star rating, full text, publication time, reviewer display name, source site name, tagged highlights (such as order type or food and service scores) and any owner reply with its time. The request always uses a New York, United States search location and English.

activeper callv2

Price

Up to $0.0041 per call; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

Google Business Profile

Data from Google Business Profile reviews.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/google-business-extended-reviews" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/google-business-extended-reviews" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/google-business-extended-reviews", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/google-business-extended-reviews", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0041

Updated: Oct 14, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "cid"
  ],
  "properties": {
    "cid": {
      "type": "string",
      "pattern": "^[0-9]+$",
      "maxLength": 20,
      "minLength": 1,
      "description": "The business's Google Maps CID (customer id): a string of digits."
    },
    "depth": {
      "enum": [
        20
      ],
      "type": "integer",
      "default": 20,
      "description": "Reviews to return. Fixed at 20."
    },
    "language_code": {
      "enum": [
        "en"
      ],
      "type": "string",
      "default": "en",
      "description": "Review language: en, English. The only value offered."
    },
    "location_name": {
      "enum": [
        "New York,New York,United States"
      ],
      "type": "string",
      "default": "New York,New York,United States",
      "description": "Search location for the request: New York, United States. The only value offered."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "rating": {
                  "type": "object",
                  "properties": {
                    "value": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "The review's star rating; null for some reviews from other sites."
                    },
                    "rating_max": {
                      "type": "number",
                      "description": "Top of the rating scale (5)."
                    }
                  }
                },
                "source": {
                  "type": "object",
                  "properties": {
                    "title": {
                      "type": "string",
                      "description": "Name of the site the review comes from."
                    }
                  }
                },
                "timestamp": {
                  "type": "string",
                  "description": "When the review was published (UTC)."
                },
                "review_text": {
                  "type": "string",
                  "description": "The review's full text."
                },
                "owner_answer": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The business owner's reply; null when there is none."
                },
                "profile_name": {
                  "type": "string",
                  "description": "The reviewer's display name."
                },
                "owner_timestamp": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "When the owner replied (UTC); null when there is no reply."
                },
                "review_highlights": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "feature": {
                        "type": "string",
                        "description": "What the highlight is about, such as order type or food."
                      },
                      "assessment": {
                        "type": "string",
                        "description": "The reviewer's answer or score for it."
                      }
                    }
                  },
                  "description": "Highlights the reviewer tagged."
                }
              }
            },
            "description": "Up to 20 reviews."
          },
          "title": {
            "type": "string",
            "description": "The business's name."
          },
          "rating": {
            "type": "object",
            "properties": {
              "value": {
                "type": "number",
                "description": "Average star rating."
              },
              "rating_max": {
                "type": "number",
                "description": "Top of the rating scale (5)."
              },
              "votes_count": {
                "type": "number",
                "description": "Number of ratings behind the average."
              }
            }
          },
          "sub_title": {
            "type": "string",
            "description": "The business's address line as Google shows it."
          },
          "reviews_count": {
            "type": "number",
            "description": "Total number of reviews."
          }
        }
      },
      "description": "One result for the call."
    }
  },
  "description": "The call's result, wrapped as results."
}