API

Add an entry with one request

No key, no signup, no sandbox. If you are a person, the form is quicker. If you are a script or an assistant doing this on someone's behalf, post JSON here.

Add an entry

curl -X POST https://bestofitsclass.com/api/v1/entries/ \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Tracker",
    "website": "https://acme.example",
    "email": "[email protected]",
    "category": "portfolio-trackers",
    "evidence_url": "https://acme.example/pricing",
    "pitch": "Tracks bonds and options, not just equities."
  }'

Only name, website and email are required. Leave category out and we will place it. evidence_url is what turns a listing into a ranked place, so send one if you have it, but nothing is rejected for missing it.

Find a category

curl https://bestofitsclass.com/api/v1/categories/

Returns every published category with its slug, what we look at, and what evidence helps. /api/v1/ describes the whole API in the same way.

The small stuff

20 entries an hour, 60 a day, per IP.
Posting the same website twice returns the first one rather than creating a second.
Success is 201 with the entry id. Problems come back as {"ok": false, "error": "..."} with a readable message.
Review is automatic and usually takes under an hour. Accepted entries show up on their category page.