Developers

Put sourced city data inside your tools.

WhereToHQ exposes a deterministic screener over roughly 3,000 US cities. Values come from public datasets and documented estimates. Directional metrics include national percentile context where supported. The same data powers the comparison site.

Three tools

list_facets

The metrics you can filter and optimize on, with valid keys.

screen_cities

Structured criteria in, a ranked shortlist out with national context.

get_city

One city's full facet sheet with available national context.

JSON-RPC methods over HTTP

This endpoint implements a bounded subset of MCP 2025-06-18 methods over JSON-RPC HTTP POST for compatible custom clients. It does not implement full MCP Streamable HTTP transport.

https://wheretohq.com/api/mcp

For higher limits, send an issued API key as a bearer token. Confirm method and transport compatibility in your client before relying on this endpoint.

Connect ChatGPT (custom GPT action)

In a custom GPT, add an Action and import the OpenAPI schema:

https://wheretohq.com/api/v1/openapi.json

Set authentication to API Key, Bearer, with an issued key for the higher quota.

Or call the REST API directly

Anonymous callers get a small daily quota; an issued API key raises it. Read-only, open CORS.

# Discover facets
curl https://wheretohq.com/api/v1/facets

# Screen cities (structured criteria)
curl -X POST https://wheretohq.com/api/v1/screen \
  -H 'content-type: application/json' \
  -H 'authorization: Bearer wtq_your_key' \
  -d '{
    "filters": [{"key": "corpTaxRate", "op": "max", "value": 5}],
    "weights": {"pctBachelors": 5, "elecCommercialCents": 3},
    "states": ["TX"],
    "limit": 5
  }'

# One city, full sheet
curl https://wheretohq.com/api/v1/cities/frisco-tx

Create an issued key on your account page. Successful data payloads include WhereToHQ attribution. Values come from public sources and documented estimates; granularity and percentile availability vary by field. Verify primary sources before decisions or republication.