> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Find Places

> Search for places using Google Places official API by text query, with optional filters and pagination up to ~60 results

Search for places using Google Places official API by text query, with optional filters and pagination up to \~60 results.

| | |
| - | - |
| **App** | Google Maps |
| **Operation ID** | `google_maps_find_places` |
| **Type** | Action |
| **Connection** | None |
| **Credits per run** | 2 |
| **Agent / MCP tool** | Yes |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `text_query` | string | Yes | - | The text string to search for. Examples: 'Best place to visit in San Francisco', 'pizza hut in New York'. The API returns candidate matches ordered by perceived relevance. For best results, include a location context (city/area) in the query. Avoid ambiguous queries, too many concepts/constraints in one query, PO Boxes, postal address elements not on Google Maps, latitude/longitude coordinates, historical names no longer in use, unofficial/vanity names, and non-geospatial intent (e.g., questions). |
| `country` | string or SelectableOption | No | - | Optional ISO-2 region code to bias results (e.g., AE, US, GB). If omitted, the Places API may bias results based on the caller's IP address. |
| `language` | string or SelectableOption | No | - | Optional language code for results (e.g., EN, AR). Will be normalized to a Places API languageCode. |
| `included_type` | string or SelectableOption | No | - | Optional Places type filter (e.g., restaurant, cafe). |
| `price_levels` | array of string or SelectableOption | No | - | Optional price level filters. Available options: PRICE\_LEVEL\_UNSPECIFIED, PRICE\_LEVEL\_FREE, PRICE\_LEVEL\_INEXPENSIVE, PRICE\_LEVEL\_MODERATE, PRICE\_LEVEL\_EXPENSIVE, PRICE\_LEVEL\_VERY\_EXPENSIVE |
| `limit` | integer | No | `20` | Maximum number of places to return. Uses pagination. Note: Places Text Search (New) returns a maximum of \~60 results across all pages (subject to change). |

### SelectableOption

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `value` | string | Yes | - | |
| `label` | string | Yes | - | |

## Output

**Type**: `List[Dict]`

Returns Google Places results (lightweight).

**Fields**: dynamic (depend on the inputs)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.