Sign in Get ranked
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/rankingsLeaderboard by scope, geo, category, window. Cursor paginated.
GET /api/marketsMarket config plus live thresholds for #1, #3, #10, #25, #100.
GET /api/listings/:slugPublic listing with all current paid positions.
GET /api/categoriesFull hierarchical taxonomy.
GET /api/geographyRegions, countries and cities with enabled flags.
GET /api/bids/quoteServer-authoritative cost to reach a target position.
GET /api/activityRecent rank-changing events.
GET /api/statsPlatform-level marketplace metrics.
GET /api/streamServer-sent events: rank changes and activity, live.

Write

POST /api/listingsCreate a listing (enters moderation).
PATCH /api/listings/:slugEdit an authorized listing.
POST /api/bids/checkoutCreate a payment intent for a bid. Quote is recomputed server-side.
POST /api/campaignsCreate and fund a push campaign.
POST /api/auto-defenseCreate or update an automatic defense rule.
POST /api/events/impressionLog an impression from an external surface.
POST /api/reportsReport a listing.
POST /api/payments/webhookProvider 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.