API

The OnlyDancers API provides programmatic access to campaign data, dancer profiles, and submission metadata. Build dashboards, integrate contests into your app, or pull analytics—all via REST endpoints.

Base URL

https://api.onlydancers.fun

Endpoints

Campaigns

GET /v1/campaigns

List all active, past, and upcoming campaigns.

GET https://api.onlydancers.fun/v1/campaigns

Returns an array of Campaign objects.

GET /v1/campaigns/{campaignId}

Retrieve a specific campaign with full tier structure and submission rules.

GET https://api.onlydancers.fun/v1/campaigns/1

Returns a single Campaign object.

GET /v1/campaigns/{campaignId}/submissions

List all submissions for a specific campaign, including dancer info and platform links.

GET https://api.onlydancers.fun/v1/campaigns/1/submissions

Returns an array of submission objects.

Dancers

GET /v1/dancers/{dancerId}

Retrieve a dancer's profile, lifetime earnings, and contest history.

GET https://api.onlydancers.fun/v1/dancers/abc123

Returns a dancer object with profile data and earnings summary.

GET /v1/dancers/{dancerId}/submissions

List all submissions made by a specific dancer across all campaigns.

GET https://api.onlydancers.fun/v1/dancers/abc123/submissions

Returns an array of submission objects.

Example Request

Here's a simple example fetching all campaigns using axios:

const axios = require('axios');

async function getAllCampaigns() {
  try {
    const response = await axios.get('https://api.onlydancers.fun/v1/campaigns');
    console.log(response.data);
  } catch (error) {
    console.error('Error fetching campaigns:', error);
  }
}

getAllCampaigns();

Campaign Object

See Campaign Object for the full JSON structure and field documentation.

Rate Limits

API requests are rate-limited to 100 requests per minute per IP address. Include retry logic in production applications.