Resources
Discovery
Trend surfaces — hashtags, sounds, and feeds — for monitoring what is moving on a platform.
Posts for a hashtag
GET/v1/{platform}/hashtags/{tag}/postsPage through recent posts under a hashtag.
FieldInTypeDescription
platformrequiredpathenumPlatform slug.tagrequiredpathstringHashtag, without the #.limitdefault 20queryintegerItems per page, 1–50.Request
curl "https://api.socialiq.dev/v1/tiktok/hashtags/aiagents/posts?limit=3" \ -H "Authorization: Bearer sc_live_..."
Response
[ .JSON ]
{ "request_id": "sc_778899001122334455aa", "data": { "tag": "aiagents", "items": [ { "id": "7350900000000000010", "platform": "tiktok", "type": "post", "text": "#aiagents demo" } ] }, "page": { "next_cursor": "c2_eyJvIjozfQ", "has_more": true }}
Posts for a sound
GET/v1/{platform}/sounds/{id}/postsPage through posts that use a given sound or track.
FieldInTypeDescription
platformrequiredpathenumPlatform slug.idrequiredpathstringThe sound / track ID.limitdefault 20queryintegerItems per page, 1–50.Request
curl "https://api.socialiq.dev/v1/tiktok/sounds/7012345678901234567/posts?limit=3" \ -H "Authorization: Bearer sc_live_..."
Response
[ .JSON ]
{ "request_id": "sc_8899001122334455aabb", "data": { "sound_id": "7012345678901234567", "items": [ { "id": "7350900000000000020", "platform": "tiktok", "type": "post", "text": "uses this sound" } ] }, "page": { "next_cursor": "c2_eyJvIjozfQ", "has_more": true }}
Trending feed
GET/v1/{platform}/feeds/trendingPage through the platform's trending / popular ranking.
FieldInTypeDescription
platformrequiredpathenumPlatform slug (currently Reddit).limitdefault 20queryintegerItems per page, 1–50.sortqueryenumReddit — hot, new, top, best, rising, controversial.withinqueryenumReddit — hour, day, week, month, year. Invalid values return 400.Request
curl "https://api.socialiq.dev/v1/reddit/feeds/trending?limit=3" \ -H "Authorization: Bearer sc_live_..."
Response
[ .JSON ]
{ "request_id": "sc_99001122334455aabbcc", "data": { "items": [ { "id": "t3_abc123", "platform": "reddit", "type": "post", "text": "trending now" } ] }, "page": { "cursor": "t3_abc123", "has_more": true }}
Trending searches
GET/v1/{platform}/trendsThe platform's currently trending search terms / topics.
FieldInTypeDescription
platformrequiredpathenumPlatform slug — TikTok, Twitter/X, or Reddit.Request
curl "https://api.socialiq.dev/v1/tiktok/trends" \ -H "Authorization: Bearer sc_live_..."
Response
[ .JSON ]
{ "request_id": "sc_77ee88ff99aa00bb11cc", "data": { "collection": "trends.topics", "items": [ { "term": "FIFA World Cup 2026", "type": "0" }, { "term": "Conor McGregor" } ] }}