Developers

Open API

Read-only, no auth, CORS enabled. Company ratings, distributions and reviews, ready to use.

Overview

Base URL: https://ok.one. All endpoints are GET and return JSON.
No authentication. Responses include Access-Control-Allow-Origin: *, so browser calls work.
Machine-readable spec: /openapi.json (OpenAPI 3.1). Site guide: /llms.txt. Updates feed: /rss.xml.
List endpoints end with a trailing slash (otherwise you get a 308 redirect).
Company, category and methodology pages support content negotiation: send Accept: text/markdown to get a markdown rendition (with an x-markdown-tokens header) at a fraction of the HTML token cost.

List companies

GET https://ok.one/api/companies/?category=electronics_technology&sort=score&limit=60&offset=0

`category`	Category id (see categories endpoint)
`q`	Fuzzy match on name/domain
`sort`	score (default) \| reviews \| recent
`limit`	Page size, max 100, default 60
`offset`	Offset, default 0

Company detail

GET https://ok.one/api/companies/www.otterbox.com

The slug is the company domain as recorded from the source, sometimes with a www. prefix (contains a dot, no trailing slash); requests for the other variant get a 308 to the actual slug. Returns company info, the latest page of reviews, exact per-star counts and pagination.

Search

GET https://ok.one/api/search/?q=bank&page=1

Chinese queries are expanded cross-lingually to match English company names. `total` is the real hit count; `data` is just the current page.

Field notes

`trustScore`	Overall score, 1-5
`distribution`	Percentages for 5→1 stars
`ratingCounts`	Exact counts for [5,4,3,2,1] stars
`updatedAt`	When this record was last updated

For how scores are computed and where data comes from, see our methodology.

Terms of use

Data may be used for retrieval, research and citation. Please attribute OK.one and link back to the company page. Avoid aggressive polling — responses are cached, identical queries return the same result for ~5 minutes.