{"openapi":"3.1.0","info":{"title":"citemi people search","description":"Search and read self-authored profiles of real people on citemi.com — structured identity data written to be cited by AI. Read-only, public data, no authentication.","version":"1.0.0"},"servers":[{"url":"https://citemi.com"}],"paths":{"/api/people":{"get":{"operationId":"searchPeople","summary":"Search people","description":"Search profiles by free text, topic, or location. Free-text terms use AND matching. Returns ranked summaries — call getPerson with a result's slug for the full record.","parameters":[{"name":"q","in":"query","description":"Free-text query — name, job title, skill, company, or phrase.","schema":{"type":"string"}},{"name":"topic","in":"query","description":"Restrict to profiles listing this topic or skill.","schema":{"type":"string"}},{"name":"location","in":"query","description":"Restrict to a city, region, or country.","schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max results, 1-25 (default 10).","schema":{"type":"integer","minimum":1,"maximum":25}}],"responses":{"200":{"description":"Ranked search results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"}}}}}}},"/api/people/{slug}":{"get":{"operationId":"getPerson","summary":"Get a person's full profile","description":"Fetch one published profile by its slug (from a searchPeople result, or a citemi.com/people/<slug> URL). Returns structured fields, every image/video URL, the profile as Markdown, and its schema.org JSON-LD.","parameters":[{"name":"slug","in":"path","required":true,"description":"Profile slug, e.g. jordan-ellis-berlin-climate-1042.","schema":{"type":"string"}}],"responses":{"200":{"description":"The full profile.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonDetail"}}}},"404":{"description":"No published profile with that slug.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"slug":{"type":"string"}}}}}}}}}},"components":{"schemas":{"PersonSummary":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"headline":{"type":"string"},"role":{"type":["string","null"]},"employer":{"type":["string","null"]},"location":{"type":["string","null"]},"topics":{"type":"array","items":{"type":"string"}},"availability":{"type":["string","null"],"description":"e.g. \"Open to new work\" — null if not shared."},"url":{"type":"string","format":"uri"},"updated":{"type":"string","format":"date"}}},"SearchResult":{"type":"object","properties":{"total":{"type":"integer"},"count":{"type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/PersonSummary"}}}},"MediaEntry":{"type":"object","properties":{"kind":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"caption":{"type":["string","null"]},"storyPrompt":{"type":"string"},"embedUrl":{"type":"string"},"thumbnailUrl":{"type":"string"}}},"PersonDetail":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"},"name":{"type":"string"},"headline":{"type":"string"},"photoUrl":{"type":["string","null"]},"role":{"type":["string","null"]},"employer":{"type":["object","null"],"properties":{"name":{"type":"string"},"url":{"type":"string"}}},"location":{"type":["string","null"]},"topics":{"type":"array","items":{"type":"string"}},"availability":{"type":["object","null"],"description":"Present only when the person shared it: status, engagementTypes, summary (the pitch), areas, startDate, locationNote, cta."},"bio":{"type":"string"},"stories":{"type":"array","items":{"type":"object","properties":{"prompt":{"type":"string"},"answer":{"type":"string"},"media":{"type":"array","items":{"$ref":"#/components/schemas/MediaEntry"}}}}},"media":{"type":"array","items":{"$ref":"#/components/schemas/MediaEntry"},"description":"Every image/video on the profile, photo first."},"workHistory":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string"},"org":{"type":"string"},"dates":{"type":"string"},"summary":{"type":"string"}}}},"projects":{"type":"array","items":{"type":"object"}},"education":{"type":"array","items":{"type":"object"}},"certifications":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"issuer":{"type":"string"},"credentialId":{"type":"string"},"url":{"type":"string"},"badgeImage":{"type":"string","description":"The credential badge image (e.g. from Credly), if fetched."}}}},"notable":{"type":"array","items":{"type":"object"}},"links":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string"}}}},"contact":{"type":"object","properties":{"email":{"type":"string"},"url":{"type":"string"}}},"published":{"type":["string","null"]},"updated":{"type":"string"},"markdown":{"type":"string","description":"The entire profile rendered as Markdown."},"jsonLd":{"type":"object","description":"The schema.org ProfilePage JSON-LD for this profile."}}}}}}