Quickstart

Make your first Fair API call in about five minutes.

1. Get your API token

Contact the Fair team to get a token. For trying things out, use the staging environment — it's free and doesn't touch your production quota.

2. Make your first request

Search for Indonesian beauty creators between 50K and 500K followers:

curl -X POST https://stg.api.fair-indonesia.com/api/fairservice/discovery \
  -H "Authorization: <your_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "work_platform_id": "9bb8913b-ddd9-430b-a66a-d74d846e6c66",
    "follower_count": { "min": 50000, "max": 500000 },
    "engagement_rate": { "percentage_value": "3" },
    "sort_by": { "field": "FOLLOWER_COUNT", "order": "DESCENDING" },
    "limit": 10
  }'

The Authorization header takes your token directly — there is no Bearer prefix.

3. Read the response

{
  "data": [
    {
      "platform_username": "tasyafarasya",
      "full_name": "Tasya Farasya",
      "follower_count": 5102338,
      "engagement_rate": 0.038,
      "is_verified": true
    }
  ],
  "metadata": { "limit": 10, "offset": 0 }
}

4. Go deeper

• Run a full profile analysis (audience, credibility, pricing) with POST /profile-analytics.
• Vet a creator for brand safety with POST /screening.
• Pull live engagement for any post with POST /public-content.

Next steps

• Core Concepts — environments, async jobs, pagination, errors, entitlements
• API Reference — every endpoint, with full request and response schemas
• Guides — end-to-end recipes