---
title: "Run a Full Grid Search"
method: POST
path: "/v1/scan/"
tags: ["On-Demand API"]
---

# Run a Full Grid Search

`POST /v1/scan/`

Get search results and ranking data for the specified business across a full grid of coordinate points.

This endpoint runs searches only against Google Maps and requires on_demand_api_access permission.

## Response `200`

Full grid search completed successfully.

## Other responses

- `400` — The request was malformed or missing required parameters.
- `401` — The API key is missing, invalid, or does not have permission for the requested resource.
- `429` — You have exceeded the rate limit. Please wait before making additional requests.
- `500` — An unexpected error occurred on the server. Please try again later.

---

[API](https://skmtc.net/localfalcon/apis/local-falcon-api.md) · [All operations](https://skmtc.net/localfalcon/apis/local-falcon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/localfalcon/local-falcon-api/revisions/06b5d428ba9e/schema)