Skip to main content

Overview

The Space API provides access to space information and loyalty points leaderboards.

Core Queries

Get Space Information

Get Loyalty Points Rankings

Variables:

Alternative: Direct Rankings Query

Field Reference

Key Fields

Pagination Parameters

LoyaltyPointsRank Fields

Integration Patterns

Basic Leaderboard Query

Sprint-Specific Rankings

To get rankings for a specific sprint period, include the sprintId parameter:

Pagination Pattern

  1. Start with cursorAfter: null
  2. Use pageInfo.endCursor from response as next cursorAfter
  3. Continue until pageInfo.hasNextPage is false

User Position Lookup

No Direct User Lookup: The B2B API does not provide a direct user position lookup field like addressLoyaltyPoints. To find a specific user’s rank, you must paginate through the leaderboard pages.

Search Strategy

  1. Limited Search: Search first 10-20 pages for UI responsiveness
  2. Background Search: Comprehensive search for analytics
  3. Cache Results: Store user positions to reduce future searches
  4. Pagination Required: Use cursorAfter/cursorBefore for efficient traversal

Best Practices

  1. Pagination: Use cursor-based pagination (cursorAfter/cursorBefore)
  2. Rate Limiting: Add 200-500ms delays between pagination requests
  3. Caching: Cache leaderboard data for 30-60 seconds
  4. Search Limits: Limit user searches to reasonable page counts (50-100 pages)
  5. Sprint Context: Use sprintId for time-limited competitions

Common Errors

Next Steps