{"openapi":"3.1.0","info":{"title":"Imprint Public API","version":"1.0.0","description":"Public REST endpoints for the Imprint creator-audience intelligence engine. For richer access via MCP, see https://byimprint.com/agents.","contact":{"name":"James Hutchings","email":"james@byimprint.com"},"license":{"name":"Imprint Terms","url":"https://byimprint.com/terms"}},"servers":[{"url":"https://byimprint.com/api/v1"}],"paths":{"/niches":{"get":{"summary":"List public niches","operationId":"listNiches","responses":{"200":{"description":"Array of public niches","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NicheListResponse"}}}}}}},"/niches/{slug}":{"get":{"summary":"Get niche landscape","operationId":"getNiche","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Niche landscape with creators","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NicheLandscape"}}}},"404":{"description":"Niche not found or not public"}}}},"/creators/{slug}":{"get":{"summary":"Get creator summary","operationId":"getCreator","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Creator summary. Full profile sections (purchase context, risk factors, audience personas, partnerships) require Indie tier or higher via MCP.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatorSummary"}}}},"404":{"description":"Creator not found"}}}}},"components":{"schemas":{"NicheSummary":{"type":"object","required":["slug","name","creatorCount","url","apiUrl"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"creatorCount":{"type":"integer"},"url":{"type":"string","format":"uri"},"apiUrl":{"type":"string","format":"uri"}}},"NicheListResponse":{"type":"object","required":["niches","total"],"properties":{"niches":{"type":"array","items":{"$ref":"#/components/schemas/NicheSummary"}},"total":{"type":"integer"},"documentation":{"type":"string"}}},"CreatorSummary":{"type":"object","required":["slug","name"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"niche":{"type":"string","nullable":true},"subscriberCount":{"type":"integer","nullable":true},"fitScore":{"type":"number","nullable":true},"channelUrl":{"type":"string","format":"uri","nullable":true},"fullProfileUrl":{"type":"string","format":"uri"},"note":{"type":"string"}}},"NicheLandscape":{"type":"object","required":["slug","name","publishedStatus","creators","creatorCount"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"publishedStatus":{"type":"string","enum":["public"]},"url":{"type":"string","format":"uri"},"creators":{"type":"array","items":{"$ref":"#/components/schemas/CreatorSummary"}},"creatorCount":{"type":"integer"},"catalogCreatorCount":{"type":"integer"},"documentation":{"type":"string"}}}}}}