> ## Documentation Index > Fetch the complete documentation index at: https://docs.socq.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Google Maps Reviews > Fetch normalized reviews data from Google Maps. # Get Google Maps Reviews Fetch normalized reviews data from Google Maps. Each successfully returned standard result costs `0.15` credits. List endpoints reserve by `results_limit` and settle against the actual result count. ## Request Body ```json theme={"system"} { "urls": [ "https://www.google.com/maps/place/Coffee%20Project%20New%20York%20%7C%20East%20Village/data=!4m7!3m6!1s0x89c2599b5a24d7fd:0x9e354f6cf514b9fc!8m2!3d40.7270884!4d-73.9893820!16s%2Fg%2F11c3svpqld!19sChIJ_dckWptZwokR_LkU9WxPNZ4?authuser=0&hl=en&rclk=1" ], "days_limit": 3650, "results_limit": 3 } ``` ## Request Constraints * `urls` is required and must contain at least one non-empty string. Each value must parse to a hostname of `google.com`, `goo.gl`, or a subdomain of either host. * Any scheme is accepted when an authority and hostname are present, protocol-relative references are also accepted, and no specific path is required. * `days_limit` is optional and must be an integer of at least `1`; the runtime imposes no maximum. * `results_limit` must be an integer from `1` through `2,000` and defaults to `100` for the whole task. ## Use with MCP | Interface | Value | | -------------- | ----------------------------------------------------- | | REST | `POST /v1/google-maps/reviews` | | Compact MCP | `socq_execute` with `endpoint: "google-maps/reviews"` | | Typed MCP | `socq_google_maps_reviews` | | Exact-tool URL | `https://api.socq.ai/mcp?tools=google_maps_reviews` | | CLI | `socq google-maps reviews` | A successful request returns a `task_id`. Poll it with `socq_get_task`, then read normalized records from `results.items`. ## Result Fields | Field | Type | Nullable | Description | | -------------------- | --------------- | -------- | ------------------------------------------------------------------------ | | `id` | `string` | Yes | Unique identifier for this result item. | | `platform` | `string` | No | Platform the result belongs to, such as `instagram` or `linkedin`. | | `resource` | `string` | No | SocQ resource represented by the result, such as `videos` or `comments`. | | `type` | `string` | No | Category of the result item, such as `video`, `post`, or `comment`. | | `url` | `string` | Yes | Public URL of the result item when available. | | `published_at` | `string` | Yes | Time the source item was published, in ISO 8601 format when available. | | `collected_at` | `string` | No | Time SocQ collected or processed this result, in ISO 8601 format. | | `text` | `string` | Yes | Review text. | | `author` | `object` | Yes | Author or publisher of the content. | | `author` | `object` | No | Field value in the standard result. | | `author.id` | `string` | Yes | Unique identifier of the author. | | `author.username` | `string` | Yes | Public username or handle of the account. | | `author.name` | `string` | Yes | Display name of the author. | | `author.url` | `string` | Yes | Public URL of the author when available. | | `author.avatar_url` | `string` | Yes | URL of the account avatar image. | | `author.is_verified` | `boolean` | Yes | Whether the account is verified on the platform. | | `author.is_private` | `boolean` | Yes | Whether the account is private. | | `rating` | `number` | Yes | Rating given in the review. | | `subject_id` | `string` | Yes | Identifier of the product, company, or other object being reviewed. | | `subject_url` | `string` | Yes | Public URL of the object being reviewed. | | `media` | `array` | Yes | Images, videos, or other media attached to the result. | ## Completed Task Response ```json theme={"system"} { "code": 200, "message": "success", "data": { "task_id": "task_example", "public_id": "google-maps/reviews", "status": "succeeded", "result_count": 0, "credits_amount": 0, "results": { "schema_id": "review", "schema_version": "1.0", "items": [], "limit": 20, "next_cursor": null, "has_more": false } } } ``` ## OpenAPI ````yaml api-manual/agent-api/agent-api.json POST /v1/google-maps/reviews openapi: 3.1.0 info: title: SocQ Agent API version: v1-d93e6d4f8368 description: Asynchronous social data API generated from the SocQ Capability Registry. servers: - url: https://api.socq.ai security: [] paths: /v1/google-maps/reviews: post: tags: - google-maps summary: Google Maps Reviews API description: Collect public Google Maps reviews. operationId: socq_google_maps_reviews requestBody: required: true content: application/json: schema: $schema: https://json-schema.org/draft/2020-12/schema type: object additionalProperties: false properties: days_limit: type: integer minimum: 1 results_limit: type: integer minimum: 1 maximum: 2000 default: 100 urls: type: array items: type: string minLength: 1 minItems: 1 description: >- A non-empty list of references whose parsed hostname is google.com, goo.gl, or a subdomain of either host. Any scheme is accepted when an authority and hostname are present; protocol-relative references are also accepted, and no specific path is required. required: - urls responses: '200': description: Task accepted content: application/json: schema: $ref: '#/components/schemas/AgentSubmitResponse' '422': description: Input validation failed content: application/json: schema: $ref: '#/components/schemas/AgentValidationErrorResponse' security: - bearerAuth: [] - apiKeyAuth: [] components: schemas: AgentSubmitResponse: type: object properties: code: type: integer const: 200 data: type: object properties: task_id: type: string status: type: string created_time: type: - string - 'null' required: - task_id - status AgentValidationErrorResponse: type: object properties: code: type: integer const: 422 error: type: object properties: message: type: string type: type: string details: type: object required: - message - type required: - code - error securitySchemes: bearerAuth: type: http scheme: bearer apiKeyAuth: type: apiKey in: header name: x-api-key ````