Gamezop Publishers: Integration Docs
  • 👋Introduction
  • Getting started
    • 🤝Sign up to be a Gamezop Publisher
    • 🤩Explore our products
    • ✌️2 key terms
  • Integrate Gamezop
    • 🤌Types of integration
      • Integrate via Gamezop Unique Link
        • Add Unique Link to your website
      • Integrate via All Games API
    • 🔎Add analytics / other scripts
    • 👀Custom Unique Links for Gamezop
    • 💪Advanced guides
      • Save users' in-game progress
      • Receive user scores
        • Gamezop Leaderboards API
      • Create multiplayer experiences
        • Receive data on match winners
        • Client-side callbacks
      • Implement Android WebView
      • Implement game-events listener
  • Integrate Quizzop
    • 🔗Integrate via Quizzop Unique Link
      • Add Unique Link to your website
    • 👀Custom Unique Links for Quizzop
    • 🔎Add analytics scripts
  • Integrate Newszop
    • 🔗Integrate via Newszop Unique Link
      • Add Unique Link to your website
  • Integrate Astrozop
    • 🔗Integrate via Astrozop Unique Link
      • Add Unique Link to your website
    • 🛎️Astrozop Notifications Content API
    • 🔎Add analytics scripts
  • Integrate Criczop
    • 🔗Integrate via Criczop Unique Link
      • Add Unique Link to your website
    • 🔎Add analytics scripts
  • Integrate Performance Ad Campaigns
    • 🎯Understand Gamezop Campaign Links
    • 🔀Configure your Postback URL
  • Other Guides and APIs
    • 💰Ad Revenue Reports API
    • 🍄Custom Ad Attribution Parameters (CAAP)
    • 🤖Add Unique Link to your Android App
Powered by GitBook
On this page
  • Understanding Leaderboards
  • Get all Leaderboards for a game

Was this helpful?

  1. Integrate Gamezop
  2. Advanced guides
  3. Receive user scores

Gamezop Leaderboards API

Some games may have multiple types of scores. You can use Gamezop Leaderboard APIs to distinguish them from one another.

Understanding Leaderboards

Let's say there's an endless runner game with 2 modes: "easy" and "hard". If you wanted to create leaderboards for the game for your users, it would only be fair that there are 2 separate leaderboards — one for the easy mode, and one for the hard mode.

To be able to do that, you need to distinguish which mode the user was playing in when we post a score to your webhook. This is where Leaderboards come in. Scores are not recorded against a game, they are recorded against a Leaderboards. A game may have more than one Leaderboard. Once again, please note these are not user-facing leaderboards within games. This is way to add context to the scores we broadcast to you.

Most games have a single Leaderboard. This document is useful if you're taking a game from us which has multiple Leaderboards.

Get all Leaderboards for a game

The Leaderboards API can be used to fetch details of all the Leaderboards that can be made for a particular game.

API endpoint

GET https://pub.gamezop.com/v2/leaderboards/info?code={game-code}

The API returns a list of all Leaderboard IDs for any game, along with a description of what that Leaderboard captures.

Query parameters

Name
Description

code*

Unique code assigned to each game — this is the code value received in the All Games API

Sample response

The response contains an array of leaderboards objects. Each object contains the following:

Key
Description

leaderboardId

A unique identifier for the leaderboard

name

description

Note: If you send an invalid game-code in the request, you will get a null array.

Last updated 9 days ago

Was this helpful?

💪