API Documentation

Everything you need to integrate World mini apps data into your application.

Base URL: api.appmarket.world/apiFormat: JSONCORS: Open

🔑Authentication

All API endpoints require an API key. Include it via the X-API-Key header or as a api_key query parameter.

# Via header (recommended)
curl api.appmarket.world/api/v1/apps \
  -H "X-API-Key: am_your_key_here"

# Via query parameter
curl "api.appmarket.world/api/v1/apps?api_key=am_your_key_here"

Get your API key by registering for free. The /v1/auth/register endpoint does not require authentication.

⚡Rate Limiting

Requests/sec per API key

100

Requests/sec global limit

Rate limit info is included in every response via headers:

X-RateLimit-Limit: 5
X-RateLimit-Remaining: 4
X-RateLimit-Reset: 1693420800000

📋Response Format

All responses follow a consistent JSON structure:

✓ Success Response

{
  "success": true,
  "data": { ... },
  "meta": {
    "total": 150,
    "page": 1,
    "limit": 20,
    "has_next": true,
    "cached": true
  }
}

✗ Error Response

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded.",
    "retry_after": 1
  }
}

🛣️Endpoint Reference

GET/apps/{app_id}Primary

Get App by ID (Primary)

The default endpoint for fetching all data about a single app. Returns 40+ fields.

Example

curl api.appmarket.world/api/apps/app_27391b4f8a8a2548c5a57601e2abed30 \
  -H "X-API-Key: am_your_key"

GET/v1/apps

List All Apps

Fetch all tracked mini apps with powerful filtering, sorting, and pagination.

Query Parameters

category	string	Filter by category ID (e.g., finance, gaming, tokens)
country	string	Filter by 2-letter country code (e.g., US, IN)
search	string	Full-text search in name, description, team
sort	string	Sort field: unique_users, impressions, app_rating, ranking_position, name
order	string	asc or desc (default: asc)
page	number	Page number (default: 1)
limit	number	Results per page, max 100 (default: 20)
verified	boolean	Only verified apps
humans_only	boolean	Only for-humans-only apps
fields	string	Comma-separated fields to return (sparse fieldsets)

Example

curl "api.appmarket.world/api/v1/apps?category=finance&sort=unique_users&order=desc&limit=10" \
  -H "X-API-Key: am_your_key"

GET/v1/apps/{app_id}/history

Historical Data

Time-series data for any metric over any time range. The killer feature for analytics.

Query Parameters

metric	string	unique_users, impressions, app_rating, category_ranking
from	string	Start date (YYYY-MM-DD)
to	string	End date (YYYY-MM-DD)
interval	string	daily, weekly, or monthly

Example

curl "api.appmarket.world/api/v1/apps/grants/history?metric=unique_users&interval=weekly" \
  -H "X-API-Key: am_your_key"

GET/v1/apps/{app_id}/growth

Growth Analytics

Pre-computed growth metrics for 24h, 7d, and 30d periods with absolute and percentage values.

Example

curl api.appmarket.world/api/v1/apps/grants/growth \
  -H "X-API-Key: am_your_key"

GET/v1/trending

Trending Apps

Apps with the highest growth rate in a given period.

Query Parameters

period	string	7d or 30d (default: 7d)
metric	string	unique_users or impressions
limit	number	Max results (default: 10)

Example

curl "api.appmarket.world/api/v1/trending?period=7d&metric=unique_users&limit=5" \
  -H "X-API-Key: am_your_key"

GET/v1/rankings

Rankings & Leaderboards

Rank apps by any metric, optionally filtered by category.

Query Parameters

metric	string	unique_users, impressions, app_rating
category	string	Filter by category
limit	number	Max results (default: 10)

Example

curl "api.appmarket.world/api/v1/rankings?metric=app_rating&limit=10" \
  -H "X-API-Key: am_your_key"

GET/v1/search

Advanced Search

Full-text search with advanced filters.

Query Parameters

q	string	Search query (required)
category	string	Filter by category
min_users	number	Minimum unique users
min_rating	number	Minimum rating (0-5)
country	string	2-letter country code

Example

curl "api.appmarket.world/api/v1/search?q=lending&min_users=1000&min_rating=4.0" \
  -H "X-API-Key: am_your_key"

GET/v1/compare

Compare Apps

Side-by-side comparison of 2-5 apps on all metrics.

Query Parameters

apps

string

Comma-separated app IDs (2-5 required)

Example

curl "api.appmarket.world/api/v1/compare?apps=grants,app_f1e44837a5e3c2af4da8925b46027645" \
  -H "X-API-Key: am_your_key"

GET/v1/stats

Ecosystem Stats

Aggregate statistics for the entire World mini app ecosystem.

Example

curl api.appmarket.world/api/v1/stats \
  -H "X-API-Key: am_your_key"

POST/v1/auth/register

Register Developer

Create a developer account and receive an API key. No authentication required.

Example

curl -X POST api.appmarket.world/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "dev@example.com", "name": "John", "password": "securepass123"}'

🏷️Available Categories

financetokensgamingearnbusinesssocialdefinfttoolseducation