# CuriosityGraph
> The Observatory of Human Curiosity. Every search is a question in disguise. CuriosityGraph maps every question a market asks about any topic — clustered by semantic identity, ranked by real monthly search demand (DataForSEO), and served as a compounding question graph for content teams and AI agents.

## How agents use it
Point at a topic, get the ranked list of real questions your audience asks, expand any question into related and narrower ones, then generate a structured article brief. All numbers are real search volumes — never invented.

## API (OpenAPI: https://curiositygraph.com/api/openapi.json · Docs: https://curiositygraph.com/docs)
- POST https://curiositygraph.com/v1/jobs — chart a topic (async job; returns id to poll)
- GET  https://curiositygraph.com/v1/jobs/{id} — job status  ·  GET https://curiositygraph.com/v1/jobs/{id}/result — full result
- GET  https://curiositygraph.com/v1/topics/{slug}/cached — cached ranked questions for a charted topic
- GET  https://curiositygraph.com/v1/topics/{slug}/tags — keyword tags with volume
- POST https://curiositygraph.com/v1/expand — expand a question (mode: related | sub)
- GET  https://curiositygraph.com/v1/clusters/{id}/related — semantic sibling questions
- GET  https://curiositygraph.com/v1/clusters/{id}/sub — narrower sub-questions
- POST https://curiositygraph.com/v1/briefs — generate an article brief from cluster ids (1 credit)
Auth: Authorization: Bearer qra_live_… (create a key at https://curiositygraph.com/app/keys)

## MCP server
https://curiositygraph.com/mcp — Model Context Protocol (Streamable HTTP, JSON-RPC 2.0).
Tools: research_topic, get_tree, get_tags, expand_question, generate_brief.
Auth: same Bearer API key.

## Charted topics
- sourdough bread — 23 questions, 1,969,600 monthly searches — https://curiositygraph.com/questions/sourdough-bread
- cast iron skillet care — 9 questions, 22,260 monthly searches — https://curiositygraph.com/questions/cast-iron-skillet-care
- baha u llah — 16 questions, 30 monthly searches — https://curiositygraph.com/questions/baha-u-llah
- baha i faith — 17 questions, 0 monthly searches — https://curiositygraph.com/questions/baha-i-faith
- baha i prayer — 5 questions, 0 monthly searches — https://curiositygraph.com/questions/baha-i-prayer