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, and the engagement earned.
live
#MumbaiRains
312Posts
1.4MViews
Social Listening API
Search by anything
Track a keyword, a hashtag, a mention, or a TikTok audio.
Four platforms
TikTok, Instagram, YouTube, and X covered with one schema.
Engagement built in
Likes, comments, views, and shares with every post.
Built to run alone
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 upload window on YouTube.
- Hashtags and mentions surfaced inside each result.
Matching posts
@WeatherMumbai42.1K likes
@cityscape.id28.4K likes
@dailymonsoon19.7K likes
HOW IT WORKS
From key to production in four steps.
01
Submit a query
POST keywords, hashtags, or handles to track.
02
We crawl
Fair searches TikTok, IG, YouTube, and X for matches.
03
Webhook fires
Get notified when the listening job finishes.
04
Fetch posts
GET the report with matched posts and creator profiles.
THE ENDPOINT
One call. Structured data back.
POST /api/fairservice/listening
POST /api/fairservice/listening
curl -X POST "https://stg.api.fair-indonesia.com/api/fairservice/listening" \
-H "Authorization: <your_token>" \
-H "Content-Type: application/json" \
-d '{
"keyword": "fairinfluence",
"timeframe": "7d"
}'FAQ
Frequently asked questions
Which social platforms are supported for listening?+
TikTok, Instagram, YouTube, and X are all covered under a single unified API.
Get Instant API Access Today
Contact our team for a free trial and staging credentials.