Start with the manifest
GET https://botlens.cc/api/v1/index.json
It lists badge counts, how many search shards exist, and the row format: [id, name, badge, category, coverage, source_index, author, description].
Search the shards
Safe and Caution rows live in /api/v1/search/SC-0.json and onward; unscanned ones in U-*.json. Each shard holds up to 2,000 rows. Filter by name and description, prefer badge S, then C.
Fetch the full record
GET https://botlens.cc/api/v1/bots/{floor(id/250)}.jsonThe record has the scan findings, coverage, commit, SHA-256 and source URL. Show the findings to your user before installing.
Machine-readable docs
openapi.json and llms.txt describe the same thing for agents. A hosted search endpoint and a submission API are planned; see For agents.
FAQ
Do I need an API key?
No. The read API is static JSON.
Are Risky bots in the API?
No. They are excluded everywhere.
Read next
Browse by category: Research · Coding & Dev · Design & Video · Writing & Content · Productivity · Finance & Crypto