Search location datasets
search_datasetsFind LocationLists datasets by brand, kind of business or industry (e.g. 'bobcat', 'restaurants', 'bank branches', 'dental practices', 'hardware stores'). Returns EVERY matching dataset, best first, with slug, name, business type, industry, record count, coverage, whether it can be searched by distance (distanceSearch), and page URL. A kind of business or an industry in the query matches every dataset of that kind, and kinds names it as a category that count_locations can combine into one answer. Each brand or chain is its own dataset. After finding one you can filter it by city, state, zip, any column, or a radius around a place (e.g. within 25 miles of Los Angeles, CA) when it has coordinates: use count_locations for how many match, and get_sample with the same filters for that count plus the list's fixed free sample rows, each marked matches_your_question. Both are free. To cover several chains near one place, pass datasets or category and a total to count_locations, and you get one answer, one price and one file. kind "register" searches LIVE public registers instead (a state's licensed child care, liquor licences, SNAP retailers…): each result's source is the key relate_locations takes as a set's opendata {source, state}, compared by distance (mode near). Registers are read live, never sold.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | list (default): the lists we sell. register: live public registers read from their publisher, e.g. {"query": "child care", "kind": "register", "state": "NY"} — each result's source goes in relate_locations as {"opendata": {"source": "<source>", "state": "NY"}}. | |
| limit | No | Max results (default: every match) | |
| query | No | Free text: brand, kind of business, industry or product | |
| state | No | With kind "register": prefer registers covering this state, e.g. "NY" | |
| category | No | Restrict to one catalog category, industry or subcategory |