API keys

Mint a Bearer key to call CityLens from a script, a notebook, or a CI job. Keys inherit your plan limits — every run made with a key counts against your monthly quota the same as a dashboard run. See the docs for examples.

Sign in to manage API keys.

Quick test

After you create a key, verify it from your terminal:

# Replace clk_live_… with the plaintext from the create response.
curl -s https://www.citylens.dev/v1/me \
  -H "Authorization: Bearer clk_live_…" | jq '{user, quota}'

You should see your email, plan, and current monthly usage. If you get 401, the key was either revoked or never enabled — generate a new one.