Skip to main content
Glama

rowfeed/google-maps-reviews-scraper

rowfeed--google-maps-reviews-scraper
Destructive

This tool calls the Actor "rowfeed/google-maps-reviews-scraper" and retrieves its output results. Actor description: Export Google Maps reviews of any business: rating, full text, date, owner reply and review highlights, plus the place's rating and review count. Paste Maps links, place IDs or names. Newest, best or worst first. About $0.30 per 1,000 reviews.

Input Schema

NameRequiredDescriptionDefault
placesNoOne place per line: a Google Maps link (also maps.app.goo.gl share links), a place ID (ChIJ...), a CID, or the business name with its city, e.g. "Katz's Delicatessen, New York". Up to 500 per run. Example values: ["Katz's Delicatessen, New York"]
sortByNoWhich reviews come first: newest, most relevant (Google's default), highest or lowest rating. Example values: "newest"newest
languageNoGoogle interface language, e.g. "English", "German". Reviews keep their own language; Google's translation is in review_text when it differs. Example values: "English"English
locationNoUsed to find places given by name, e.g. "United States", "United Kingdom", "Germany". Links and IDs work anywhere. Example values: "United States"United States
waitSecsNoMax seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow `nextStep` to poll via get-actor-run. Set to 0 to fire-and-forget.
newerThanNoLeave out older reviews: a date (2026-10-01) or an age (7 days, 2 weeks, 3 months). Left-out reviews are not charged. With "Newest first", no further reviews are fetched once the cutoff is reached, which makes scheduled monitoring cheap.
maxReviewsNoHow many reviews to get per place, in the chosen order. Up to 4,490. Places with fewer reviews only pay for what they have. Example values: 20
onlyWithTextNoLeave out star-only reviews that have no text. Left-out reviews are not charged.

Output Schema

NameRequiredDescriptionDefault
tipNoAdvisory guidance RAG Web Browser wrote to its key-value store under the reserved "TIP" key
runIdYesActor run ID
statsNoRun statistics
statusYesRun status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED
actorIdYesStable Apify Actor ID from the run record
summaryYesPast-tense summary of the run state
exitCodeNoActor process exit code; populated for terminal states (especially FAILED)
nextStepYesOne primary follow-up action with identifiers interpolated
storagesYesDataset and key-value store metadata, keyed by alias. "default" is always the primary entry.
actorNameNo"username/actor-name"
startedAtNoISO timestamp when the run started
finishedAtNoISO timestamp when the run finished (terminal states only)
statusMessageNoPass-through from Apify run.statusMessage
apifyConsoleUrlNoPersonalized Apify Console link to the run; present only for Console sessions

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / place_id / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  2. Changed3 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / place_id / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  3. Changed3 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / place_id / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  4. Changed3 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / place_id / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  5. Changed3 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / place_id / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  6. Changed3 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / place_id / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  7. Changed3 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / place_id / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  8. Changed3 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / place_id / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  9. Changed3 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / place_id / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  10. Changed3 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / place_id / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  11. Changed3 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / place_id / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  12. Changed8 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / place_id / type
      Previous value: -"string"New value: +[
      +  "null",
      +  "string"
      +]
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_highlights / properties / Child-friendliness
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_highlights / properties / Historical information
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_highlights / properties / Reservation recommended
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_highlights / properties / Visited on
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_highlights / properties / Wait time
      Added value: +{
      +  "type": "string"
      +}
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  13. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "checked_at": {
      +      "type": "string"
      +    },
      +    "cid": {
      +      "type": "string"
      +    },
      +    "from_snapshot": {
      +      "type": "boolean"
      +    },
      +    "google_maps_url": {
      +      "type": "string"
      +    },
      +    "image_urls": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "original_language": {
      +      "type": [
      +        "null",
      +        "string"
      +      ]
      +    },
      +    "original_review_text": {
      +      "type": [
      +        "null",
      +        "string"
      +      ]
      +    },
      +    "owner_answer": {
      +      "type": "null"
      +    },
      +    "owner_answered_at": {
      +      "type": "null"
      +    },
      +    "place_address": {
      +      "type": "string"
      +    },
      +    "place_id": {
      +      "type": "string"
      +    },
      +    "place_rating": {
      +      "type": "number"
      +    },
      +    "place_reviews_total": {
      +      "type": "number"
      +    },
      +    "place_title": {
      +      "type": "string"
      +    },
      +    "position": {
      +      "type": "number"
      +    },
      +    "published_at": {
      +      "type": "string"
      +    },
      +    "published_text": {
      +      "type": "string"
      +    },
      +    "query": {
      +      "type": "string"
      +    },
      +    "rating": {
      +      "type": "number"
      +    },
      +    "review_highlights": {
      +      "properties": {
      +        "Atmosphere": {
      +          "type": "string"
      +        },
      +        "Food": {
      +          "type": "string"
      +        },
      +        "Meal type": {
      +          "type": "string"
      +        },
      +        "Noise level": {
      +          "type": "string"
      +        },
      +        "Order type": {
      +          "type": "string"
      +        },
      +        "Parking options": {
      +          "type": "string"
      +        },
      +        "Parking space": {
      +          "type": "string"
      +        },
      +        "Price per person": {
      +          "type": "string"
      +        },
      +        "Service": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "review_id": {
      +      "type": "string"
      +    },
      +    "review_text": {
      +      "type": [
      +        "null",
      +        "string"
      +      ]
      +    },
      +    "review_url": {
      +      "type": "string"
      +    },
      +    "sort": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
  14. Changed3 schema fields changed
    • addedInput schema / properties / language / prefill
      Added value: +"English"
    • addedInput schema / properties / location / prefill
      Added value: +"United States"
    • addedInput schema / properties / places / prefill
      Added value: +[
      +  "Katz's Delicatessen, New York"
      +]
  15. Changed1 schema field changed
    • addedInput schema / description
      Added value: +"Live lookups need a paid Apify plan (any plan). The pre-filled example works on the free plan."
  16. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "checked_at": {
      -      "type": "string"
      -    },
      -    "cid": {
      -      "type": "string"
      -    },
      -    "from_snapshot": {
      -      "type": "boolean"
      -    },
      -    "google_maps_url": {
      -      "type": "string"
      -    },
      -    "image_urls": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "original_language": {
      -      "type": [
      -        "null",
      -        "string"
      -      ]
      -    },
      -    "original_review_text": {
      -      "type": [
      -        "null",
      -        "string"
      -      ]
      -    },
      -    "owner_answer": {
      -      "type": [
      -        "null",
      -        "string"
      -      ]
      -    },
      -    "owner_answered_at": {
      -      "type": [
      -        "null",
      -        "string"
      -      ]
      -    },
      -    "place_address": {
      -      "type": "string"
      -    },
      -    "place_id": {
      -      "type": "string"
      -    },
      -    "place_rating": {
      -      "type": "number"
      -    },
      -    "place_reviews_total": {
      -      "type": "number"
      -    },
      -    "place_title": {
      -      "type": "string"
      -    },
      -    "position": {
      -      "type": "number"
      -    },
      -    "published_at": {
      -      "type": "string"
      -    },
      -    "published_text": {
      -      "type": "string"
      -    },
      -    "query": {
      -      "type": "string"
      -    },
      -    "rating": {
      -      "type": "number"
      -    },
      -    "review_highlights": {
      -      "properties": {
      -        "Atmosphere": {
      -          "type": "string"
      -        },
      -        "Food": {
      -          "type": "string"
      -        },
      -        "Group size": {
      -          "type": "string"
      -        },
      -        "Meal type": {
      -          "type": "string"
      -        },
      -        "Noise level": {
      -          "type": "string"
      -        },
      -        "Order type": {
      -          "type": "string"
      -        },
      -        "Parking options": {
      -          "type": "string"
      -        },
      -        "Parking space": {
      -          "type": "string"
      -        },
      -        "Price per person": {
      -          "type": "string"
      -        },
      -        "Recommended dishes": {
      -          "type": "string"
      -        },
      -        "Reservation": {
      -          "type": "string"
      -        },
      -        "Seating type": {
      -          "type": "string"
      -        },
      -        "Service": {
      -          "type": "string"
      -        },
      -        "Special events": {
      -          "type": "string"
      -        },
      -        "Wait time": {
      -          "type": "string"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "review_id": {
      -      "type": "string"
      -    },
      -    "review_text": {
      -      "type": [
      -        "null",
      -        "string"
      -      ]
      -    },
      -    "review_url": {
      -      "type": "string"
      -    },
      -    "sort": {
      -      "type": "string"
      -    }
      -  },
      -  "type": "object"
      -}
  17. Changed2 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  18. Changed2 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  19. Changed2 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  20. Changed2 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  21. Changed2 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  22. Changed2 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  23. Changed2 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +[
      +  "null",
      +  "string"
      +]
  24. Changed2 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / original_language / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_text / type
      Previous value: -[
      -  "null",
      -  "string"
      -]New value: +[
      +  "string",
      +  "null"
      +]
  25. Changed8 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / owner_answer / type
      Previous value: -"null"New value: +[
      +  "null",
      +  "string"
      +]
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / owner_answered_at / type
      Previous value: -"null"New value: +[
      +  "null",
      +  "string"
      +]
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_highlights / properties / Group size
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_highlights / properties / Recommended dishes
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_highlights / properties / Reservation
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_highlights / properties / Seating type
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_highlights / properties / Special events
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / review_highlights / properties / Wait time
      Added value: +{
      +  "type": "string"
      +}
  26. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "checked_at": {
      +      "type": "string"
      +    },
      +    "cid": {
      +      "type": "string"
      +    },
      +    "from_snapshot": {
      +      "type": "boolean"
      +    },
      +    "google_maps_url": {
      +      "type": "string"
      +    },
      +    "image_urls": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "original_language": {
      +      "type": [
      +        "null",
      +        "string"
      +      ]
      +    },
      +    "original_review_text": {
      +      "type": [
      +        "null",
      +        "string"
      +      ]
      +    },
      +    "owner_answer": {
      +      "type": "null"
      +    },
      +    "owner_answered_at": {
      +      "type": "null"
      +    },
      +    "place_address": {
      +      "type": "string"
      +    },
      +    "place_id": {
      +      "type": "string"
      +    },
      +    "place_rating": {
      +      "type": "number"
      +    },
      +    "place_reviews_total": {
      +      "type": "number"
      +    },
      +    "place_title": {
      +      "type": "string"
      +    },
      +    "position": {
      +      "type": "number"
      +    },
      +    "published_at": {
      +      "type": "string"
      +    },
      +    "published_text": {
      +      "type": "string"
      +    },
      +    "query": {
      +      "type": "string"
      +    },
      +    "rating": {
      +      "type": "number"
      +    },
      +    "review_highlights": {
      +      "properties": {
      +        "Atmosphere": {
      +          "type": "string"
      +        },
      +        "Food": {
      +          "type": "string"
      +        },
      +        "Meal type": {
      +          "type": "string"
      +        },
      +        "Noise level": {
      +          "type": "string"
      +        },
      +        "Order type": {
      +          "type": "string"
      +        },
      +        "Parking options": {
      +          "type": "string"
      +        },
      +        "Parking space": {
      +          "type": "string"
      +        },
      +        "Price per person": {
      +          "type": "string"
      +        },
      +        "Service": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "review_id": {
      +      "type": "string"
      +    },
      +    "review_text": {
      +      "type": [
      +        "null",
      +        "string"
      +      ]
      +    },
      +    "review_url": {
      +      "type": "string"
      +    },
      +    "sort": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
  27. Added

TDQS

A3.5/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=false, destructiveHint=true and openWorldHint=true, so the safety envelope is covered. The description adds genuinely new behavior: pricing ("About $0.30 per 1,000 reviews") and available sort orders. It omits the run lifecycle — that the call may return before the Actor finishes and that the caller must poll via get-actor-run — which only appears buried in the waitSecs parameter. No contradiction with annotations, but the disclosure is thinner than ideal for an open-world, cost-incurring Actor invocation.

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

Conciseness4/5

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

Two sentences, front-loaded with what the tool does and then the concrete output fields and price. The opening clause "This tool calls the Actor ... and retrieves its output results" is boilerplate that could be dropped, but overall there is little waste.

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

Completeness4/5

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

With 8 optional parameters, full schema descriptions, an output schema and populated annotations, the description supplies the missing pieces an agent needs to decide: what data comes back and what it costs. The residual gap is the asynchronous run/poll flow and the paid-plan gate, both of which are stated in structured fields rather than the description, so completeness is good but not airtight.

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?

Schema description coverage is 100%, and each parameter already carries rich documentation (place formats, sort enum, language/translation semantics, cutoff behaviour, per-place caps). The description only restates a subset — links/IDs/names and newest/best/worst ordering — adding no syntax or edge-case detail beyond the schema. Baseline 3 applies when the schema does the heavy lifting.

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

Purpose4/5

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

The description names a specific resource (Google Maps reviews of a business) and enumerates the returned fields: rating, full text, date, owner reply, highlights, plus the place's aggregate rating and review count. That is far more specific than the generic 'calls the Actor and retrieves its output' wrapper. It does not explicitly contrast itself with near-neighbours such as the TripAdvisor/Trustpilot review scrapers or google-maps-scraper, so it lands at 4 rather than 5.

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

Usage Guidelines3/5

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

Usage context is implied by the domain (pull Google Maps reviews) and there are input hints — "Paste Maps links, place IDs or names" — that tell the agent what to supply. However, there is no explicit when-to-use versus alternatives such as rowfeed--google-maps-scraper, google-maps-rank-tracker, or the other review scrapers, and no stated preconditions in the description itself (the paid-plan requirement lives only in the schema blurb).

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.