API Reference

The Fair API is organized into product families. Every endpoint is REST, returns JSON, and is called the same way — only the path changes.

Base URL

https://api.fair-indonesia.com/api/fairservice        (production)
https://stg.api.fair-indonesia.com/api/fairservice    (staging — use for free trials)

Authentication

Every request needs your API token in the Authorization header. Pass the token value directly — there is no Bearer prefix.

Authorization: <your_token>

See Authentication for full details and Core Concepts for environments, pagination, errors, and how asynchronous jobs work.

Each family page renders directly from the Fair OpenAPI spec, so every endpoint has full request and response schemas with examples, generated directly from the spec.

---

Product families

Family	What it does
Creator Search & Analytics	Discover creators across 400M+ profiles, analyze audiences, look up contacts, and resolve emails to profiles.
Purchase Intent	Score whether a creator's audience shows real buying intent.
Comments Relevance	Identify which comments on a post are relevant to a product or topic.
Social Background Check	Risk-score profiles, content, and media for brand safety, with flagging criteria and continuous monitoring.
Content & Comments	Fetch public content and comments for a profile or single item, including LinkedIn.
Social Listening	Track the conversation around a brand, topic, or hashtag.

Async products (search export, profile analytics, email lookup, audience overlap, purchase intent, comments relevance, screening, social listening) follow a submit-then-fetch pattern: a POST returns an id, and you poll GET .../{id} until the result is ready. See Core Concepts.

Related

• Quickstart — your first call in five minutes
• Core Concepts — environments, async jobs, pagination, errors
• Authentication — how to get and use your API token
• Dictionaries — shared lookups for search filters