Social Listening API
Follow every post about your brand in one place
Submit a keyword, hashtag, or mention and Fair searches TikTok, Instagram, YouTube, and X for matching content. You get back the posts, the creators behind them, and the engagement they earned.
#MumbaiRains
312 posts across 4 platforms
312Posts
1.4MViews
187Creators
4.8%Avg. eng.
TikTok
44%
Instagram
31%
YouTube
15%
X
10%
Search by anything
Track a keyword, a hashtag, a mention, or a TikTok audio track.
Four platforms
TikTok, Instagram, YouTube, and X covered with one schema.
Engagement built in
Likes, comments, views, and shares come with every post.
Built to run on its own
Submit a job, get a webhook when results are ready.
Coverage
See who is posting, not just how much.
- ✓Every match comes with the creator's handle, profile, and link.
- ✓Likes, comments, views, and shares attached to each post.
- ✓Filter by date on X and by upload window on YouTube.
- ✓Hashtags and mentions surfaced inside each result.
Matching posts
@WeatherMumbai
42.1K likes
@cityscape.id
28.4K likes
@dailymonsoon
19.7K likes
Async by design
Submit once, get notified when it's done.
- ✓POST a search and get back a job id right away.
- ✓Poll the status endpoint or wait for the CONTENTS_SEARCH webhook.
- ✓Pull insights with the fetch endpoint when the job completes.
- ✓Page through large result sets with offset and limit.
Job 497f6eca
Submitted just now
Request accepted
Crawling platforms
Building insights
How it works
From key to production in four steps.
01
Submit a search
POST a platform plus a keyword, hashtag, or mention.
02
Get a job id
The request returns immediately with an id and status.
03
Wait for results
Poll the status route or listen for the webhook event.
04
Fetch insights
GET the fetch route to pull matching posts and engagement.
The endpoint
One call. Structured data back.
POST
/fairservice/social-listeningcurl -X POST "https://stg.api.fair-indonesia.com/api/fairservice/social-listening" \
-H "Authorization: <your_token>" \
-H "Content-Type: application/json" \
-d '{
"work_platform_id": "9bb8913b-ddd9-430b-a66a-d74d846e6c66",
"hashtag": "MumbaiRains",
"items_limit": 50
}'FAQ
Frequently asked questions
TikTok, Instagram, YouTube, and X. You pass a work platform id with each request and results come back in the same shape across all four.
Build with brand today.
Real creator data, at scale, straight from the source.