Developers
API
Read endpoints are public and unauthenticated. Write endpoints use your session and respect the same RBAC as the dashboard. Everything is rate-limited per address.
Read
| GET /api/rankings | Leaderboard by scope, geo, category, window. Cursor paginated. |
| GET /api/markets | Market config plus live thresholds for #1, #3, #10, #25, #100. |
| GET /api/listings/:slug | Public listing with all current paid positions. |
| GET /api/categories | Full hierarchical taxonomy. |
| GET /api/geography | Regions, countries and cities with enabled flags. |
| GET /api/bids/quote | Server-authoritative cost to reach a target position. |
| GET /api/activity | Recent rank-changing events. |
| GET /api/stats | Platform-level marketplace metrics. |
| GET /api/stream | Server-sent events: rank changes and activity, live. |
Write
| POST /api/listings | Create a listing (enters moderation). |
| PATCH /api/listings/:slug | Edit an authorized listing. |
| POST /api/bids/checkout | Create a payment intent for a bid. Quote is recomputed server-side. |
| POST /api/campaigns | Create and fund a push campaign. |
| POST /api/auto-defense | Create or update an automatic defense rule. |
| POST /api/events/impression | Log an impression from an external surface. |
| POST /api/reports | Report a listing. |
| POST /api/payments/webhook | Provider webhook. Signature-verified, idempotent. |
Example
curl 'https://www.universerank.com/api/rankings?scope=COUNTRY&geo=CA&category=cybersecurity&window=ALL&limit=5' curl 'https://www.universerank.com/api/bids/quote?scope=COUNTRY&geo=NG&target=1'
Quote responses carry guarantee: "value_not_position". Treat it as authoritative: the amount is what you will be charged, the rank is what that amount would achieve at this instant.
Last updated 2026-08-24.