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

# List API searches

> List searches created through the public API.

Returns Google Maps discovery jobs whose `origin` is `api`, newest first. Dashboard-created searches remain available in the web app but are not included here. Standalone enrichment jobs are listed by `GET /enrichments`.

<ParamField query="page" type="integer" default="1">Page number, starting at `1`.</ParamField>
<ParamField query="page_size" type="integer" default="20">Items per page, from `1` to `100`.</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://www.mapsdata.io/api/v1/searches?page=1&page_size=20" \
    -H "x-api-key: md_live_your_key"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
        "name": "New York plumbers",
        "status": "running",
        "actor_input": {
          "query": "plumbers",
          "location": "New York, New York",
          "countryCode": "US",
          "maxResults": 100,
          "language": "en"
        },
        "source": "apify",
        "origin": "api",
        "run_id": "provider-run-id",
        "error": null,
        "lead_count": 38,
        "credits_charged": 100,
        "enrich_contacts": true,
        "enriched_count": 16,
        "delete_requested": false,
        "created_at": "2026-10-01T09:12:30Z",
        "finished_at": null
      }
    ],
    "total": 1
  }
  ```
</ResponseExample>

The response does not include `has_more`. Another page exists when `page × page_size < total`.


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