Developer API

Read-only JSON endpoints for building integrations. No API key required for public catalog data. Rate limits apply in production — cache responses when possible.

Base URL

https://ai-ranked-platform.vercel.app

Endpoints

GET/api/tools?q=optional search

List approved tools (JSON). Optional q filters by name.

GET/api/tools/[slug]

Single tool with metrics, pros, cons, and scores.

GET/api/categories

All categories with approved tool counts.

GET/api/trending

Trending movers, domain leaders, and community favorites.

GET/api/ticker

Compact score movers for the homepage ticker strip.

GET/api/embed/[slug]

Embed badge data, JSON (?format=json), or HTML snippet (?format=html).

GET/embed/[slug]

Minimal iframe-friendly score badge page.

GET/api/tools/[slug]/reviews

Community review summary and recent reviews for a tool.

Example

curl "https://ai-ranked-platform.vercel.app/api/tools?q=cursor"
curl "https://ai-ranked-platform.vercel.app/api/trending"
curl "https://ai-ranked-platform.vercel.app/api/tools/chatgpt/reviews"

Authenticated routes

Votes, bookmarks, reviews, and score alerts require a signed-in user session (NextAuth). Admin and cron routes are not public — see methodology for scoring details.