🚀 Free & Open Source

World App Data API

Access comprehensive data for 500+ World App mini-apps. Get rankings, statistics, rewards, and historical trends.

587 Mini-Apps

20+ Endpoints

Free Forever

Quick Example

// Get top 10 mini-apps
const response = await fetch(
  'https://api.example.com/api/v1/apps/top?limit=10'
);
const { data } = await response.json();

// Result: Array of top-ranked apps
console.log(data[0].app_name); // "World App"

Why Use This API?

📱

Comprehensive Data

Access detailed information for all World App mini-apps including names, descriptions, logos, and developer info.

📊

Real-time Rankings

Get up-to-date rankings based on user count, app opens, ratings, and weekly growth trends.

🏆

Rewards Data

Track rewards across different seasons with detailed breakdowns by app and time period.

📈

Historical Trends

Analyze growth patterns with historical data for user counts, ranks, and engagement metrics.

🔍

Powerful Search

Search apps by name, description, developer, platform, and filter by various criteria.

⚡

Rate Limited

Fair usage with generous rate limits: 100 requests per 15 minutes for most endpoints.

Quick Start

No Authentication Required

The API is completely free and requires no API keys or authentication.

Make Your First Request

curl https://your-api-domain.com/api/v1/apps/top

Parse the Response

All responses are in JSON format with consistent structure.

API Endpoints

📱 Apps

GET /api/v1/apps List all apps (paginated)

GET /api/v1/apps/top Get top ranked apps

GET /api/v1/apps/trending Get trending apps

GET /api/v1/apps/search Search apps

GET /api/v1/apps/{appId} Get app by ID

GET /api/v1/apps/rank/{rank} Get app by rank

GET /api/v1/apps/stats Get overall statistics

🏆 Rewards

GET /api/v1/rewards List all rewards

GET /api/v1/rewards/seasons Get available seasons

GET /api/v1/rewards/season/{season} Get rewards by season

GET /api/v1/rewards/app/{appId} Get app rewards

📈 History

GET /api/v1/history/{appId} Get app history

GET /api/v1/history/{appId}/rank Get rank history

GET /api/v1/history/{appId}/users Get user growth

View Full Documentation

Code Examples

// Fetch top 10 apps with JavaScript
async function getTopApps() {
  const response = await fetch(
    'https://your-api.com/api/v1/apps/top?limit=10'
  );
  const { data, pagination } = await response.json();
  
  data.forEach(app => {
    console.log(`#${app.rank} ${app.app_name} - ${app.total_users} users`);
  });
}

// Search apps
async function searchApps(query) {
  const response = await fetch(
    `https://your-api.com/api/v1/apps/search?q=${query}`
  );
  return response.json();
}

import requests

# Fetch top 10 apps with Python
def get_top_apps():
    response = requests.get(
        'https://your-api.com/api/v1/apps/top',
        params={'limit': 10}
    )
    data = response.json()
    
    for app in data['data']:
        print(f"#{app['rank']} {app['app_name']} - {app['total_users']} users")

# Search apps
def search_apps(query):
    response = requests.get(
        'https://your-api.com/api/v1/apps/search',
        params={'q': query}
    )
    return response.json()

# Get top 10 apps
curl -X GET "https://your-api.com/api/v1/apps/top?limit=10"

# Search for apps
curl -X GET "https://your-api.com/api/v1/apps/search?q=game"

# Get app by ID
curl -X GET "https://your-api.com/api/v1/apps/app_123456"

# Get trending apps
curl -X GET "https://your-api.com/api/v1/apps/trending"

# Filter by minimum rating
curl -X GET "https://your-api.com/api/v1/apps?minRating=4&limit=20"