First 10 Google Reviews of a Business by Maps CID (New York Location, English)

omnial/google-business-first-10-reviews-by-cid

Given a business's Google Maps CID, returns its name, address line, average rating, rating count and review total, plus the first 10 Google reviews in Google's default order: each review's star rating, full text, language, publication time, reviewer display name and tagged highlights (such as order type, price per person or food, service and atmosphere scores). The request always uses a New York, United States search location and English.

activeper callv1

Price

Up to $0.00205 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-first-10-reviews-by-cid" })

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

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/google-business-first-10-reviews-by-cid", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/google-business-first-10-reviews-by-cid", 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.00205

Updated: Oct 14, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "cid",
    "location_name",
    "language_code",
    "depth"
  ],
  "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": [
        10
      ],
      "type": "integer",
      "default": 10,
      "description": "Reviews to return. Fixed at 10, one page."
    },
    "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",
                      "description": "The review's star rating."
                    },
                    "rating_max": {
                      "type": "number",
                      "description": "Top of the rating scale (5)."
                    }
                  }
                },
                "timestamp": {
                  "type": "string",
                  "description": "When the review was published (UTC)."
                },
                "review_text": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The review's full text."
                },
                "profile_name": {
                  "type": "string",
                  "description": "The reviewer's display name."
                },
                "original_language": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The language code of the review text."
                },
                "review_highlights": {
                  "type": [
                    "array",
                    "null"
                  ],
                  "items": {
                    "type": "object",
                    "properties": {
                      "feature": {
                        "type": "string",
                        "description": "What the highlight is about, such as order type, price per person or food."
                      },
                      "assessment": {
                        "type": "string",
                        "description": "The reviewer's answer or score for it."
                      }
                    }
                  },
                  "description": "Highlights the reviewer tagged; null when there are none."
                }
              }
            },
            "description": "Up to 10 reviews, in Google's default order."
          },
          "title": {
            "type": "string",
            "description": "The business's name."
          },
          "rating": {
            "type": "object",
            "properties": {
              "value": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Average star rating."
              },
              "rating_max": {
                "type": "number",
                "description": "Top of the rating scale (5)."
              },
              "votes_count": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Number of ratings behind the average."
              }
            }
          },
          "sub_title": {
            "type": [
              "string",
              "null"
            ],
            "description": "The business's address line as Google shows it."
          },
          "reviews_count": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total number of reviews."
          }
        }
      },
      "description": "One result for the call."
    }
  },
  "description": "The call's result, wrapped as results."
}