API reference
Public, read-only access to approved conversations, models, topics and dataset releases, plus authenticated contribution endpoints. All read endpoints are rate limited per IP. Unpublished content is never returned. Contributions are never auto-published: they enter moderation (or are stored as private drafts).
Authorization: Bearer oc_…) with the submit scope.get/api/conversations
List or search approved conversations
| q | query | Keyword query (prompt and response text) |
| mode | query | keyword | semantic |
| provider | query | Provider slug |
| model | query | Model slug |
| tag | query | Topic slug |
| language | query | ISO 639-1 code |
| source | query | user_contributed | external_dataset |
| dataset | query | External dataset slug |
| minTurns | query | Minimum user turns |
| maxTurns | query | Maximum user turns |
| minScore | query | Minimum community score |
| from | query | Published on/after (YYYY-MM-DD) |
| to | query | Published on/before (YYYY-MM-DD) |
| corrections | query | Only conversations where the user corrected the model |
| evaluated | query | Only with verified evaluations |
| sort | query | recent | top | longest | relevance |
| cursor | query | Opaque cursor from next_cursor |
| limit | query | 1–50 |
post/api/conversations
Submit a conversation for moderation(auth required)
get/api/search
Alias of GET /api/conversations
get/api/conversations/{id}
Get one approved conversation (public export schema)
| id | path | Stable conversation id (ULID) |
delete/api/conversations/{id}
Remove your own conversation (adds it to the suppression registry)(auth required)
| id | path | Stable conversation id (ULID) |
get/api/conversations/{id}/download
Download one conversation as JSON
| id | path | Stable conversation id (ULID) |
post/api/contributions/import
Import an export file or one conversation as PRIVATE DRAFTS(auth required)
Accepts {filename, content} (ChatGPT export, Claude export, OpenAI-style messages JSON/JSONL, The Chat Archive records) or {conversation}. Drafts are never public until individually reviewed and consented in the web UI or via POST /api/drafts/{id}.
get/api/models
Providers and models with conversation counts
get/api/topics
Topics with conversation counts
get/api/datasets
Published releases and the external dataset catalog
get/api/datasets/{version}
Release manifest (partitions, files, checksums, methodology)
| version | path |
get/api/datasets/{version}/files/{path}
Download a release file (JSONL.gz / Parquet / manifest / SHA256SUMS)
| version | path | |
| path | path |
get/api/users/{username}
Public contributor profile
| username | path |
post/api/reports
Report a conversation (privacy, inaccurate metadata, harmful content, takedown)
No sign-in required, so data subjects can request removal.