Reference

Every endpoint, what it costs, what it needs.

All endpoints are GET and take the key in a header. Live status comes from the hourly probe, so an endpoint marked needs setup is waiting on a credential, not broken.

Authentication

Any one of these headers works:

X-SocialAPI-Key: sk_live_…
X-API-Key:       sk_live_…
Authorization:   Bearer sk_live_…

tiktok

/api/v1/tiktok/user/info 1 credit down

Get User Info

Parameter	Required
username	required

Example

curl "https://api.socialapi.store/api/v1/tiktok/user/info?username=…" \
  -H "X-SocialAPI-Key: sk_live_…"

Also answers at /api/v1/user/info for older integrations.

/api/v1/tiktok/user/videos 2 credits down

Get User Videos

Parameter	Required
username	required
count	optional
cursor	optional

Example

curl "https://api.socialapi.store/api/v1/tiktok/user/videos?username=…" \
  -H "X-SocialAPI-Key: sk_live_…"

Also answers at /api/v1/user/videos for older integrations.

/api/v1/tiktok/user/liked 2 credits down

Get User Liked Videos

Parameter	Required
username	required
count	optional

Example

curl "https://api.socialapi.store/api/v1/tiktok/user/liked?username=…" \
  -H "X-SocialAPI-Key: sk_live_…"

Also answers at /api/v1/user/liked for older integrations.

/api/v1/tiktok/video/info 1 credit live

Get Video Info

Parameter	Required
url	required

Example

curl "https://api.socialapi.store/api/v1/tiktok/video/info?url=…" \
  -H "X-SocialAPI-Key: sk_live_…"

Also answers at /api/v1/video/info for older integrations.

/api/v1/tiktok/video/comments 2 credits live

Get Video Comments

Parameter	Required
url	optional
video_id	optional
count	optional
cursor	optional

Example

curl "https://api.socialapi.store/api/v1/tiktok/video/comments?" \
  -H "X-SocialAPI-Key: sk_live_…"

Also answers at /api/v1/video/comments for older integrations.

/api/v1/tiktok/search/users 3 credits live

Search Users

Parameter	Required
keyword	required
page	optional

Example

curl "https://api.socialapi.store/api/v1/tiktok/search/users?keyword=…" \
  -H "X-SocialAPI-Key: sk_live_…"

Also answers at /api/v1/search/users for older integrations.

/api/v1/tiktok/hashtag/info 1 credit live

Get Hashtag Info

Parameter	Required
name	required

Example

curl "https://api.socialapi.store/api/v1/tiktok/hashtag/info?name=…" \
  -H "X-SocialAPI-Key: sk_live_…"

Also answers at /api/v1/hashtag/info for older integrations.

/api/v1/tiktok/hashtag/videos 2 credits down

Get Hashtag Videos

Parameter	Required
name	required
cursor	optional

Example

curl "https://api.socialapi.store/api/v1/tiktok/hashtag/videos?name=…" \
  -H "X-SocialAPI-Key: sk_live_…"

Also answers at /api/v1/hashtag/videos for older integrations.

/api/v1/tiktok/trending/videos 2 credits live

Get Trending Videos

Takes no parameters.

Example

curl "https://api.socialapi.store/api/v1/tiktok/trending/videos" \
  -H "X-SocialAPI-Key: sk_live_…"

Also answers at /api/v1/trending/videos for older integrations.

/api/v1/tiktok/sound/info 1 credit down

Get Sound Info

Parameter	Required
id	required

Example

curl "https://api.socialapi.store/api/v1/tiktok/sound/info?id=…" \
  -H "X-SocialAPI-Key: sk_live_…"

Also answers at /api/v1/sound/info for older integrations.

/api/v1/tiktok/sound/videos 2 credits down

Get Sound Videos

Parameter	Required
id	required
page	optional
count	optional

Example

curl "https://api.socialapi.store/api/v1/tiktok/sound/videos?id=…" \
  -H "X-SocialAPI-Key: sk_live_…"

Also answers at /api/v1/sound/videos for older integrations.

/api/v1/reddit/user/info 1 credit needs setup

Get User Info

Parameter	Required
username	required

Example

curl "https://api.socialapi.store/api/v1/reddit/user/info?username=…" \
  -H "X-SocialAPI-Key: sk_live_…"

/api/v1/reddit/user/posts 2 credits needs setup

Get User Posts

Parameter	Required
username	required
count	optional
cursor	optional
sort	optional

Example

curl "https://api.socialapi.store/api/v1/reddit/user/posts?username=…" \
  -H "X-SocialAPI-Key: sk_live_…"

/api/v1/reddit/user/comments 2 credits needs setup

Get User Comments

Parameter	Required
username	required
count	optional
cursor	optional

Example

curl "https://api.socialapi.store/api/v1/reddit/user/comments?username=…" \
  -H "X-SocialAPI-Key: sk_live_…"

/api/v1/reddit/subreddit/info 1 credit needs setup

Get Subreddit Info

Parameter	Required
name	required

Example

curl "https://api.socialapi.store/api/v1/reddit/subreddit/info?name=…" \
  -H "X-SocialAPI-Key: sk_live_…"

/api/v1/reddit/subreddit/posts 2 credits needs setup

Get Subreddit Posts

Parameter	Required
name	required
count	optional
cursor	optional
sort	optional
t	optional

Example

curl "https://api.socialapi.store/api/v1/reddit/subreddit/posts?name=…" \
  -H "X-SocialAPI-Key: sk_live_…"

/api/v1/reddit/post/info 1 credit needs setup

Get Post Info

Parameter	Required
id	optional
url	optional

Example

curl "https://api.socialapi.store/api/v1/reddit/post/info?" \
  -H "X-SocialAPI-Key: sk_live_…"

/api/v1/reddit/post/comments 2 credits needs setup

Get Post Comments

Parameter	Required
id	optional
url	optional
count	optional
sort	optional

Example

curl "https://api.socialapi.store/api/v1/reddit/post/comments?" \
  -H "X-SocialAPI-Key: sk_live_…"

/api/v1/reddit/search/posts 3 credits needs setup

Search Posts

Parameter	Required
keyword	required
count	optional
cursor	optional
subreddit	optional
sort	optional
t	optional

Example

curl "https://api.socialapi.store/api/v1/reddit/search/posts?keyword=…" \
  -H "X-SocialAPI-Key: sk_live_…"

/api/v1/reddit/trending/subreddits 2 credits needs setup

Trending Subreddits

Takes no parameters.

Example

curl "https://api.socialapi.store/api/v1/reddit/trending/subreddits" \
  -H "X-SocialAPI-Key: sk_live_…"

youtube

/api/v1/youtube/video/info 1 credit live

Get Video Info

Parameter	Required
url	optional
id	optional

Example

curl "https://api.socialapi.store/api/v1/youtube/video/info?" \
  -H "X-SocialAPI-Key: sk_live_…"

Currently answered by piped.

/api/v1/youtube/video/comments 2 credits live

Get Video Comments

Parameter	Required
url	optional
id	optional
count	optional
cursor	optional

Example

curl "https://api.socialapi.store/api/v1/youtube/video/comments?" \
  -H "X-SocialAPI-Key: sk_live_…"

Currently answered by piped.

/api/v1/youtube/search/videos 3 credits live

Search Videos

Parameter	Required
keyword	required
count	optional

Example

curl "https://api.socialapi.store/api/v1/youtube/search/videos?keyword=…" \
  -H "X-SocialAPI-Key: sk_live_…"

Currently answered by piped.

/api/v1/youtube/channel/info 1 credit live

Get Channel Info

Parameter	Required
handle	optional
id	optional
url	optional

Example

curl "https://api.socialapi.store/api/v1/youtube/channel/info?" \
  -H "X-SocialAPI-Key: sk_live_…"

Currently answered by piped.

/api/v1/youtube/channel/videos 2 credits live

Get Channel Videos

Parameter	Required
handle	optional
id	optional
url	optional
count	optional

Example

curl "https://api.socialapi.store/api/v1/youtube/channel/videos?" \
  -H "X-SocialAPI-Key: sk_live_…"

Currently answered by rss.

threads

/api/v1/threads/post/info 1 credit needs setup

Get Post Info

Parameter	Required
url	optional
code	optional

Example

curl "https://api.socialapi.store/api/v1/threads/post/info?" \
  -H "X-SocialAPI-Key: sk_live_…"

/api/v1/threads/user/info 1 credit needs setup

Get User Info

Parameter	Required
username	required

Example

curl "https://api.socialapi.store/api/v1/threads/user/info?username=…" \
  -H "X-SocialAPI-Key: sk_live_…"

instagram

/api/v1/instagram/user/info 2 credits needs setup

Get User Info

Parameter	Required
username	required

Example

curl "https://api.socialapi.store/api/v1/instagram/user/info?username=…" \
  -H "X-SocialAPI-Key: sk_live_…"

/api/v1/instagram/post/info 2 credits needs setup

Get Post Info

Parameter	Required
url	optional
code	optional

Example

curl "https://api.socialapi.store/api/v1/instagram/post/info?" \
  -H "X-SocialAPI-Key: sk_live_…"

Errors

Failures carry a stable error_type so you can branch on it without parsing prose.

AUTH_REQUIRED 401

Missing or invalid key — or the endpoint needs a credential we have not configured.

RATE_LIMITED 429

Too many requests for this key this minute. Retry-After tells you when.

QUOTA_EXHAUSTED 402

Daily allowance used up and no credits left.

INVALID_INPUT 400

A required parameter is missing or malformed.

NOT_FOUND 400

The user, video or post does not exist.

SERVICE_ERROR 400

Every source for this endpoint failed. retry_after suggests when to try again.

UNKNOWN_ENDPOINT 400

No endpoint at that path.