GET /api/leaderboard — community contributor rankings

The Leaderboard endpoint returns a ranked list of PRIXO’s most active price contributors for any geographic scope. Use it to celebrate top contributors in a specific district, show a community-wide ranking, or surface your users’ relative standing. Only contributors who have opted in to public visibility appear here — no private user data is ever exposed.

Endpoint

GET /api/leaderboard

Authentication: Not required

Query parameters

string

default:"country"

The geographic level to rank contributors within. Accepted values:

country — all of Saudi Arabia
city — a specific city (pair with area)
district — a specific district (pair with area)

string

The name of the city or district to filter by, in Arabic. Required when scope is city or district. Example: العليا

number

default:"20"

Maximum number of contributors to return. Accepted range is 1–100.

Response fields

array

Ordered array of contributor objects, ranked by contribution count (descending).

Show Contributor object fields

string

The contributor’s public username.

string

The contributor’s chosen display name.

string

URL of the contributor’s avatar image.

number

Total number of accepted price contributions by this user within the requested scope.

number

Current points balance earned by this user.

object

The user’s current trust level badge.

Show Trust level fields

string

Trust level name in Arabic, e.g. خبير.

string

Trust level name in English, e.g. Expert.

string

Emoji icon representing the trust level, e.g. ⭐.

number

The contributor’s numeric rank position within the returned list, starting at 1.

number

Total number of eligible public contributors in the requested scope, before the limit is applied. Useful for pagination or showing “X of Y contributors”.

Privacy

Only users who have explicitly set show_public_profile to true are included in leaderboard results. The following fields are never returned by this endpoint: email address, phone number, physical location data, and points ledger history.

Example

Request

GET /api/leaderboard?scope=district&area=العليا&limit=10

Response

{
  "leaderboard": [
    {
      "username": "user123",
      "display_name": "Ahmed",
      "avatar_url": "https://cdn.prixo.ai/avatars/user123.jpg",
      "contribution_count": 142,
      "points_balance": 3850,
      "trust_level": {
        "name_ar": "خبير",
        "name_en": "Expert",
        "icon": "⭐"
      },
      "rank": 1
    },
    {
      "username": "sara_r",
      "display_name": "Sara",
      "avatar_url": "https://cdn.prixo.ai/avatars/sara_r.jpg",
      "contribution_count": 98,
      "points_balance": 2410,
      "trust_level": {
        "name_ar": "محترف",
        "name_en": "Pro",
        "icon": "🏆"
      },
      "rank": 2
    }
  ],
  "total": 47
}

Use cases

Combine the scope=district leaderboard with the Popular Intents endpoint to build a neighborhood dashboard — show who’s contributing the most prices for the foods trending near the user.

Community pages — display top contributors per district to drive healthy competition.
In-app leaderboard widget — show a user their rank and the two people just above them to encourage more contributions.
Country-wide rankings — use the default scope=country call to feature PRIXO’s most dedicated contributors platform-wide.

Overview

Endpoints

GET /api/leaderboard — community contributor rankings

Endpoint

Query parameters

Response fields

Privacy

Example

Request

Response

Use cases

​Endpoint

​Query parameters

​Response fields

​Privacy

​Example

​Request

​Response

​Use cases

Endpoint

Query parameters

Response fields

Privacy

Example

Request

Response

Use cases