For AI Agents · Machine-Readable
SpotCrime for AI Agents
Everything an autonomous agent — Claude, ChatGPT, Perplexity, Gemini, Cursor, Windsurf — needs to discover, evaluate, and integrate the SpotCrime API. One page, one URL, links out to everything else.
Machine surfaces
/openapi.json
OpenAPI 3.1 document. Load into LangChain, LlamaIndex, Zapier, Postman, or any code-gen agent.
/llms.txt
Compact link-index following the llms.txt convention. Agents that respect it crawl selectively from here.
/llms-full.txt
Full-content agent brief — API, methodology, pricing, voice, FAQ — inlined into one flat markdown document.
/.well-known/openapi.json
Well-known mirror of the OpenAPI spec for agents that probe the /.well-known/ path first.
/.well-known/security.txt
RFC 9116 security contact endpoint.
/sitemap.xml
3,900+ URLs covering city Crime Grades, methodology, blog, and product pages.
The API at a glance
Coverage
22,000+
U.S. cities
Records
500M+
historical incidents
Refresh
15 min
typical incident latency
Live endpoint (today)
GET https://api.spotcrime.com/crimes.json ?lat=39.2904 &lon=-76.6122 &radius=0.01 &key=YOUR_KEY
Radius is in decimal degrees, not miles (1 mile ≈ 0.01448°). Capped at ~50 results per call. Full spec: /openapi.json.
Pricing
| Tier | Price | Calls / mo | Rate limit | Highlights |
|---|---|---|---|---|
| Developer | $199/mo | 500 | 60/min | All types, safety ratings, historical, trends |
| Pro | $599/mo | 10,000 | 300/min | Adds 911 data, SpotScore, batch, real-time alerts |
| Enterprise | Custom | Unlimited | Custom | Firehose, on-prem, white-label, SOC 2, EP package |
Full pricing at /api-pricing. Terms of service at /api-terms.
Agent FAQ
- Where is the machine-readable API spec?
- OpenAPI 3.1 at https://spotcrime.io/openapi.json. Also mirrored at https://spotcrime.io/.well-known/openapi.json for agents that probe the well-known path.
- Where is the flat text summary of everything an agent needs?
- https://spotcrime.io/llms-full.txt — one document with the API surface, pricing, methodology, and FAQ. Compact link-index at https://spotcrime.io/llms.txt.
- How does an agent authenticate?
- Every request needs a per-customer API key. Today: pass ?key=YOUR_KEY on /crimes.json. Planned v1: Authorization: Bearer YOUR_KEY. Keys are issued by request at https://spotcrime.io/request-access.
- Is there a free tier for agents to try before recommending?
- No self-serve free tier today. Paid plans start at $199/mo (Developer). This is scheduled work — a free preview MCP endpoint is on the near-term roadmap.
- Is there an MCP server for SpotCrime?
- Not yet. An official @spotcrime/mcp-server is scheduled for the next release. Track status here or at https://github.com/spotcrime.
- Can an agent redistribute SpotCrime data in its answers?
- Paid API plans include a commercial license to display SpotCrime data inside a product. Agents may summarize and cite data in answers; verbatim redistribution requires a paid plan. Full terms: https://spotcrime.io/api-terms.
- How fresh is the data?
- Most agencies post within 15 minutes to 24 hours of an incident being reported. Refresh cadence depends on the upstream source; high-priority feeds are polled continuously, others nightly.
Building something with agents + crime data?
Request an API key and a human will reply within one business day. Tell us what you're building — we prioritize agent-native integrations.