Route reference
Loaded from the live OpenAPI document and filled in with the published query notes. Base URL https://api.hooks.social.
| Method | Path | Query | Auth |
|---|---|---|---|
| GET | /v1/tiktok/profileTikTok profile with exact counts | username | Bearer |
| GET | /v1/tiktok/videoTikTok video detail | id?, url? | Bearer |
| GET | /v1/tiktok/postsTikTok profile posts | username, cursor?, count? | Bearer |
| GET | /v1/tiktok/commentsTikTok comments | video_id, cursor?, count? | Bearer |
| GET | /v1/tiktok/comments/repliesTikTok comment replies | video_id, comment_id, cursor? | Bearer |
| GET | /v1/tiktok/search/videosTikTok keyword video search | q, cursor?, search_id? | Bearer |
| GET | /v1/tiktok/search/usersTikTok user search | q, cursor?, search_id? | Bearer |
| GET | /v1/tiktok/hashtagTikTok hashtag detail | name | Bearer |
| GET | /v1/tiktok/hashtag/videosTikTok hashtag videos | id?, name?, cursor? | Bearer |
| GET | /v1/tiktok/soundTikTok sound detail | id | Bearer |
| GET | /v1/tiktok/sound/videosTikTok sound videos | id, cursor? | Bearer |
| GET | /v1/instagram/profileInstagram profile with recent posts and reels. Degraded responses are free. | username | Bearer |
| GET | /v1/instagram/postInstagram post: caption, owner, likes, comments, taken_at, view_count / play_count for a video or Reel, and audio (id, title, artist, original) for the sound it uses. Instagram shows shares and saves only to the account owner, so they are not included; a count the owner hid is null. | shortcode?, url? | Bearer |
| GET | /v1/instagram/commentsInstagram comments | shortcode, cursor? | Bearer |
| GET | /v1/instagram/postsInstagram posts, 12 per page. Every post carries likes, comments and taken_at; videos and Reels add view_count and play_count (plays on page 1). Instagram shows shares and saves only to the account owner, so they are not included; a count the owner hid is null. A cached page is free. | username, cursor? | Bearer |
| GET | /v1/instagram/reelsInstagram Reels, 12 per page, each with play_count, likes, comments and taken_at. Instagram shows shares and saves only to the account owner, so they are not included; a count the owner hid is null. | username, cursor? | Bearer |
| GET | /v1/instagram/audio/reelsReels that use an Instagram sound. audio_id is the audio.id from /v1/instagram/post. | audio_id, cursor? | Bearer |
| GET | /v1/instagram/relatedInstagram related accounts | username | Bearer |
| GET | /v1/instagram/searchInstagram keyword search: top posts with likes, comments, plays and taken_at, and the accounts behind them. Use two or more words. | q, cursor? | Bearer |
| GET | /v1/meCredit balance and account settings for this key | — | Bearer |
| GET | /v1/statusService status | — | Public |
| GET | /v1/tiktok/trendsWhat is trending on TikTok, for a topic or the whole platform: the sounds, hashtags and creators that appear most in recent videos, weighted by views, plus the top videos. 1 credit. | q?, days? | Bearer |
| GET | /v1/tiktok/viralThe most viewed TikTok videos about a topic from the last 1, 7 or 30 days. Scans several pages of search and ranks by views. 1 credit. | q, days? | Bearer |
GET /v1/tiktok/profile
TikTok profile with exact counts
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/tiktok/profile?username=tiktok"
Try it
Sign in to run this with your key.
GET /v1/tiktok/video
TikTok video detail
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/tiktok/video?id=&url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F1"
Try it
Sign in to run this with your key.
GET /v1/tiktok/posts
TikTok profile posts
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/tiktok/posts?username=tiktok&cursor=&count=5"
Try it
Sign in to run this with your key.
GET /v1/tiktok/comments
TikTok comments
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/tiktok/comments?video_id=&cursor=&count=5"
Try it
Sign in to run this with your key.
GET /v1/tiktok/comments/replies
TikTok comment replies
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/tiktok/comments/replies?video_id=&comment_id=&cursor="
Try it
Sign in to run this with your key.
GET /v1/tiktok/search/videos
TikTok keyword video search
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/tiktok/search/videos?q=nairobi&cursor=&search_id="
Try it
Sign in to run this with your key.
GET /v1/tiktok/search/users
TikTok user search
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/tiktok/search/users?q=nairobi&cursor=&search_id="
Try it
Sign in to run this with your key.
GET /v1/tiktok/hashtag
TikTok hashtag detail
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/tiktok/hashtag?name="
Try it
Sign in to run this with your key.
GET /v1/tiktok/hashtag/videos
TikTok hashtag videos
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/tiktok/hashtag/videos?id=&name=&cursor="
Try it
Sign in to run this with your key.
GET /v1/tiktok/sound
TikTok sound detail
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/tiktok/sound?id="
Try it
Sign in to run this with your key.
GET /v1/tiktok/sound/videos
TikTok sound videos
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/tiktok/sound/videos?id=&cursor="
Try it
Sign in to run this with your key.
GET /v1/instagram/profile
Instagram profile with recent posts and reels. Degraded responses are free.
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/instagram/profile?username=tiktok"
Try it
Sign in to run this with your key.
GET /v1/instagram/post
Instagram post: caption, owner, likes, comments, taken_at, view_count / play_count for a video or Reel, and audio (id, title, artist, original) for the sound it uses. Instagram shows shares and saves only to the account owner, so they are not included; a count the owner hid is null.
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/instagram/post?shortcode=&url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F1"
Try it
Sign in to run this with your key.
GET /v1/instagram/comments
Instagram comments
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/instagram/comments?shortcode=&cursor="
Try it
Sign in to run this with your key.
GET /v1/instagram/posts
Instagram posts, 12 per page. Every post carries likes, comments and taken_at; videos and Reels add view_count and play_count (plays on page 1). Instagram shows shares and saves only to the account owner, so they are not included; a count the owner hid is null. A cached page is free.
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/instagram/posts?username=tiktok&cursor="
Try it
Sign in to run this with your key.
GET /v1/instagram/reels
Instagram Reels, 12 per page, each with play_count, likes, comments and taken_at. Instagram shows shares and saves only to the account owner, so they are not included; a count the owner hid is null.
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/instagram/reels?username=tiktok&cursor="
Try it
Sign in to run this with your key.
GET /v1/instagram/audio/reels
Reels that use an Instagram sound. audio_id is the audio.id from /v1/instagram/post.
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/instagram/audio/reels?audio_id=&cursor="
Try it
Sign in to run this with your key.
GET /v1/instagram/related
Instagram related accounts
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/instagram/related?username=tiktok"
Try it
Sign in to run this with your key.
GET /v1/instagram/search
Instagram keyword search: top posts with likes, comments, plays and taken_at, and the accounts behind them. Use two or more words.
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/instagram/search?q=nairobi&cursor="
Try it
Sign in to run this with your key.
GET /v1/me
Credit balance and account settings for this key
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/me"
Try it
Use the curl above. Account routes run with the same key from your server.
GET /v1/status
Service status
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ "https://api.hooks.social/v1/status"
Try it
Use the curl above. Account routes run with the same key from your server.
GET /v1/tiktok/trends
What is trending on TikTok, for a topic or the whole platform: the sounds, hashtags and creators that appear most in recent videos, weighted by views, plus the top videos. 1 credit.
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/tiktok/trends?q=nairobi&days="
Try it
Sign in to run this with your key.
GET /v1/tiktok/viral
The most viewed TikTok videos about a topic from the last 1, 7 or 30 days. Scans several pages of search and ranks by views. 1 credit.
curl -sS \ -H "Accept: application/json" \ -H "User-Agent: hooks-social" \ -H "Authorization: Bearer hk_live_…" \ "https://api.hooks.social/v1/tiktok/viral?q=nairobi&days="
Try it
Sign in to run this with your key.
HTML docs: https://api.hooks.social/docs