# CityBotMagic, free preview, GET /api/v1/search.json: Local business search API

> Query by city, category or service over a JSON API or our MCP server. Every price carries its source URL and the date we read it.

CityBotMagic's Local business search API on its Free preview plan. It costs $0.00 per 1,000 places. CityBotMagic's docs list 4 of the 8 key fields we check: Address, Phone, Website, Category.
CityBotMagic limits how many pages you get but gives no number.
We ran CityBotMagic in [our Local business search API benchmark](https://datacircle.dev/best-local-business-search-api.txt). We didn't score any CityBotMagic plan.
Half of the 239 plans we rank by price cost $0.365 per 1,000 places or less. This plan and 9 others tie for the lowest price per 1,000 places of the 239 plans.
[LocationIQ](https://datacircle.dev/local-business-search-apis/locationiq/100-monthly/llms.txt), [ScrapeField](https://datacircle.dev/local-business-search-apis/scrapefield/39-pack/llms.txt) and [TomTom](https://datacircle.dev/local-business-search-apis/tomtom/pay-as-you-go-pay-as-you-grow-tier-1-get-search-2-poisearch-query-ext/llms.txt) are the best local business search API providers in the Datacircle benchmark.

- This page: https://datacircle.dev/local-business-search-apis/citybotmagic/free-preview-get-api-v1-search-json
- [Local business search API: the 19 best providers compared](https://datacircle.dev/best-local-business-search-api.txt)
- Get it: https://citybotmagic.com/agents/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=local-business-search-api-pricing
- Request: `GET https://citybotmagic.com/api/v1/search.json`
- API key: not needed
- Its API docs: https://citybotmagic.com/openapi.json?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=local-business-search-api-pricing
- Sold by: CityBotMagic (https://citybotmagic.com?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=local-business-search-api-pricing)
- Checked: 2026-11-06

## In the answer

- Completeness: 50%
- Address: ✓
- Phone: ✓
- Website: ✓
- Category: ✓

## Price

- $ per 1,000 places: $0.00
- Per: page of 100
- Billing: free

## Charges

- Most per search: 100
- Also pays for: nothing else

## Not found

- $ per 1,000: $0.00

## In their words

- Their pitch: Query by city, category or service over a JSON API or our MCP server. Every price carries its source URL and the date we read it.

## Data

- Freshness: stored
- Keep data: no limit
- Use data: Each record keeps the license of its original source, shown on its page and in the API: Most records: Community Data License Agreement – Permissive 2.0. Foursquare-sourced records: Apache License 2.0. AllThePlaces-sourced records: CC0 1.0. [...] Business owners can correct or remove their data at any time by emailing hello@citybotmagic.com.

## Plan

- Pay: $0

## Rate limit

- Batch: 1

## Speed

- Answer: in the call

## The call

- You send: state, city, q. Optional: limit, group, has_prices
- Method: GET
- Path: /api/v1/search.json

## About the plan

- Plan: Free preview
- Who can get it: anyone

## The 29 fields the plan's answer can hold

query, city name, city state, city state name, city slug, city Census GEOID, city latitude, city longitude, city population, city business count, city count of businesses with prices, city data updated, city URL, city API URL, total results, business ID, slug, name, category, category label, category group, address, phone, website, chain, price count, has opening hours, bookable, CityBotMagic URL

## CityBotMagic's plans (1)

- [CityBotMagic, free preview, GET /api/v1/search.json](https://datacircle.dev/local-business-search-apis/citybotmagic/free-preview-get-api-v1-search-json/llms.txt): $0.00 per 1,000, 50% complete, stored

## CityBotMagic's calls (2)

- `GET /api/v1/us/{state}/{city}.json`: [CityBotMagic, free preview, GET /api/v1/us/{state}/{city}.json](https://datacircle.dev/local-business-search-apis/citybotmagic/free-preview-get-api-v1-us-state-city-json/llms.txt)
- `GET /api/v1/search.json`: [CityBotMagic, free preview, GET /api/v1/search.json](https://datacircle.dev/local-business-search-apis/citybotmagic/free-preview-get-api-v1-search-json/llms.txt)

## CityBotMagic's APIs (1)

- [CityBotMagic: Local business search API pricing, 1 plan, GET /api/v1/search.json](https://datacircle.dev/local-business-search-apis/citybotmagic/free-preview-get-api-v1-search-json/llms.txt)

## CityBotMagic: Local business search API alternatives

- [G Maps Crawl, free](https://datacircle.dev/local-business-search-apis/g-maps-crawl/free/llms.txt): $0.00 per 1,000, 100% complete, stored
- [Datafiniti, free](https://datacircle.dev/local-business-search-apis/datafiniti/free/llms.txt): $0.00 per 1,000, 75% complete, stored
- [Factori, free, POST /v1/poi/by-address](https://datacircle.dev/local-business-search-apis/factori/free-post-v1-poi-by-address/llms.txt): $0.00 per 1,000, 75% complete, stored
- [openrouteservice, free, Standard](https://datacircle.dev/local-business-search-apis/openrouteservice/free-standard/llms.txt): $0.00 per 1,000, 63% complete, stored

## Sources

From each provider's own pricing page and docs, and from what providers tell us. We read this row from these pages on 2026-11-06.

- https://citybotmagic.com?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=local-business-search-api-pricing
- https://citybotmagic.com/agents/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=local-business-search-api-pricing
- https://citybotmagic.com/api/v1/search.json?state=nv&city=reno&q=oil+change&utm_source=datacircle.dev&utm_medium=referral&utm_campaign=local-business-search-api-pricing
- https://citybotmagic.com/data-sources/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=local-business-search-api-pricing
- https://citybotmagic.com/llms.txt?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=local-business-search-api-pricing
- https://citybotmagic.com/openapi.json?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=local-business-search-api-pricing