For the complete documentation index, see llms.txt. This page is also available as Markdown.

Developer Overview

The Fair API gives you programmatic access to public data on 400M+ creators across Instagram, TikTok, YouTube, and more. Search and filter creators, analyze their audiences, vet them for brand safety, measure campaigns, and listen to the conversation around a brand — all over a simple REST API.

What you can build

Product family
Use it to
Reference

Creator Search & Analytics

Find creators with 40+ filters, analyze audiences and credibility, look up contacts, resolve emails to profiles

Reference

Purchase Intent

Score whether a creator's audience shows real buying intent

Reference

Comments Relevance

Identify which comments on a post are relevant to a product or topic

Reference

Social Background Check

Risk-score profiles, content, and media for brand safety

Reference

Content & Comments

Fetch public content and comments for a profile or single item, including LinkedIn

Reference

Social Listening

Track the conversation around a brand, topic, or hashtag

Reference

New here? Start with the Quickstart, then read Core Concepts.

Base URLs

https://api.fair-indonesia.com/api/fairservice        Production
https://stg.api.fair-indonesia.com/api/fairservice    Staging (free trial)

All requests use HTTPS. Request and response bodies are JSON.

Authentication

Pass your API token in the Authorization header — directly, with no Bearer prefix:

Authorization: <your_token>

Full details on Authentication. To get credentials, contact the Fair team.

Error codes

Status
Meaning

400

Bad request, or the product isn't enabled on your key (product_not_subscribed)

401

Missing or invalid API token

403

Your plan does not include API access

422

Request failed validation (missing or malformed fields)

429

Rate limit exceeded — back off and retry

5xx

Server error

See Core Concepts → Errors for the error response shape.

  • Quickstart — your first call in five minutes

  • Core Concepts — environments, async jobs, pagination, errors, entitlements

  • API Reference — interactive, testable docs for every endpoint

  • Dictionaries — shared lookups for search filters

Last updated

Was this helpful?