# Social Fetch — API endpoint catalog

> 113 documented REST operations. Each entry links to agent-readable markdown (`.mdx`) with HTTP details, parameters, pagination, credits, SDK examples, and response field outlines.
>
> **Do not download or parse `/openapi.json` for routine integration work.** Use this catalog to pick a route, then read that route's linked markdown page. Reserve OpenAPI for codegen or fields not covered on the operation page.

## How to use

1. Start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt) for orientation and workflow guidance.
2. Find the operation below by platform section (or search this page).
3. Open the **markdown** link for the route you need — for example a Twitter profile tweets page at `/docs/api/v1/twitter/profiles/handle/tweets/get.mdx`.
4. Implement using the HTTP path, parameters, and examples on that page.

Other references:
- [Choose the right endpoint](https://www.socialfetch.dev/docs/choose-endpoint.mdx) — task-oriented route selection when you are unsure which operation fits.
- [`/llms.json`](https://www.socialfetch.dev/llms.json) — same inventory in JSON when registering many tools programmatically.
- [OpenAPI JSON](https://www.socialfetch.dev/openapi.json) — full schemas for codegen only.

## TikTok

- [Get TikTok profile](https://www.socialfetch.dev/docs/api/v1/tiktok/profiles/handle/get.mdx) — `GET /v1/tiktok/profiles/{handle}`
- [List TikTok profile videos](https://www.socialfetch.dev/docs/api/v1/tiktok/profiles/handle/videos/get.mdx) — `GET /v1/tiktok/profiles/{handle}/videos`
- [List TikTok profile followers](https://www.socialfetch.dev/docs/api/v1/tiktok/profiles/handle/followers/get.mdx) — `GET /v1/tiktok/profiles/{handle}/followers`
- [List TikTok profile following](https://www.socialfetch.dev/docs/api/v1/tiktok/profiles/handle/following/get.mdx) — `GET /v1/tiktok/profiles/{handle}/following`
- [Get TikTok profile region](https://www.socialfetch.dev/docs/api/v1/tiktok/profiles/handle/region/get.mdx) — `GET /v1/tiktok/profiles/{handle}/region`
- [Get TikTok live stream](https://www.socialfetch.dev/docs/api/v1/tiktok/profiles/handle/live/get.mdx) — `GET /v1/tiktok/profiles/{handle}/live`
- [Search TikTok users](https://www.socialfetch.dev/docs/api/v1/tiktok/users/search/get.mdx) — `GET /v1/tiktok/users/search`
- [Search TikTok videos](https://www.socialfetch.dev/docs/api/v1/tiktok/search/get.mdx) — `GET /v1/tiktok/search`
- [Search TikTok by hashtag](https://www.socialfetch.dev/docs/api/v1/tiktok/search/hashtags/get.mdx) — `GET /v1/tiktok/search/hashtags`
- [Get TikTok video](https://www.socialfetch.dev/docs/api/v1/tiktok/videos/get.mdx) — `GET /v1/tiktok/videos`
- [List TikTok video comments](https://www.socialfetch.dev/docs/api/v1/tiktok/videos/comments/get.mdx) — `GET /v1/tiktok/videos/comments`
- [Get TikTok video transcript](https://www.socialfetch.dev/docs/api/v1/tiktok/videos/transcript/get.mdx) — `GET /v1/tiktok/videos/transcript`
- [List TikTok trending feed](https://www.socialfetch.dev/docs/api/v1/tiktok/feed/trending/get.mdx) — `GET /v1/tiktok/feed/trending`
- [Search TikTok Shop products](https://www.socialfetch.dev/docs/api/v1/tiktok/shop/products/search/get.mdx) — `GET /v1/tiktok/shop/products/search`
- [List TikTok Shop store products](https://www.socialfetch.dev/docs/api/v1/tiktok/shop/products/get.mdx) — `GET /v1/tiktok/shop/products`
- [Get TikTok Shop product](https://www.socialfetch.dev/docs/api/v1/tiktok/products/get.mdx) — `GET /v1/tiktok/products`
- [List TikTok Shop product reviews](https://www.socialfetch.dev/docs/api/v1/tiktok/products/reviews/get.mdx) — `GET /v1/tiktok/products/reviews`
- [List TikTok profile showcase products](https://www.socialfetch.dev/docs/api/v1/tiktok/profiles/handle/showcase-products/get.mdx) — `GET /v1/tiktok/profiles/{handle}/showcase-products`
## Facebook

- [Get Facebook profile](https://www.socialfetch.dev/docs/api/v1/facebook/profiles/get.mdx) — `GET /v1/facebook/profiles`
- [List Facebook profile posts](https://www.socialfetch.dev/docs/api/v1/facebook/profiles/posts/get.mdx) — `GET /v1/facebook/profiles/posts`
- [List Facebook profile reels](https://www.socialfetch.dev/docs/api/v1/facebook/profiles/reels/get.mdx) — `GET /v1/facebook/profiles/reels`
- [List Facebook profile photos](https://www.socialfetch.dev/docs/api/v1/facebook/profiles/photos/get.mdx) — `GET /v1/facebook/profiles/photos`
- [Get Facebook post or reel](https://www.socialfetch.dev/docs/api/v1/facebook/posts/get.mdx) — `GET /v1/facebook/posts`
- [List Facebook post or reel comments](https://www.socialfetch.dev/docs/api/v1/facebook/posts/comments/get.mdx) — `GET /v1/facebook/posts/comments`
- [Get Facebook post transcript](https://www.socialfetch.dev/docs/api/v1/facebook/posts/transcript/get.mdx) — `GET /v1/facebook/posts/transcript`
- [List Facebook group posts](https://www.socialfetch.dev/docs/api/v1/facebook/groups/posts/get.mdx) — `GET /v1/facebook/groups/posts`
- [Get Facebook Marketplace item](https://www.socialfetch.dev/docs/api/v1/facebook/marketplace/items/get.mdx) — `GET /v1/facebook/marketplace/items`
- [Search Facebook Marketplace locations](https://www.socialfetch.dev/docs/api/v1/facebook/marketplace/locations/search/get.mdx) — `GET /v1/facebook/marketplace/locations/search`
- [Search Facebook Marketplace listings](https://www.socialfetch.dev/docs/api/v1/facebook/marketplace/search/get.mdx) — `GET /v1/facebook/marketplace/search`
- [Get Facebook Ad Library ad](https://www.socialfetch.dev/docs/api/v1/facebook/ad-library/ads/get.mdx) — `GET /v1/facebook/ad-library/ads`
- [Search Facebook Ad Library ads](https://www.socialfetch.dev/docs/api/v1/facebook/ad-library/ads/search/get.mdx) — `GET /v1/facebook/ad-library/ads/search`
- [List Facebook company ads](https://www.socialfetch.dev/docs/api/v1/facebook/ad-library/companies/ads/get.mdx) — `GET /v1/facebook/ad-library/companies/ads`
- [Search Facebook ad library companies](https://www.socialfetch.dev/docs/api/v1/facebook/ad-library/companies/search/get.mdx) — `GET /v1/facebook/ad-library/companies/search`
## Instagram

- [Get Instagram profile](https://www.socialfetch.dev/docs/api/v1/instagram/profiles/handle/get.mdx) — `GET /v1/instagram/profiles/{handle}`
- [Get Instagram basic profile](https://www.socialfetch.dev/docs/api/v1/instagram/profiles/userid/basic/get.mdx) — `GET /v1/instagram/profiles/{userId}/basic`
- [List Instagram profile posts](https://www.socialfetch.dev/docs/api/v1/instagram/profiles/handle/posts/get.mdx) — `GET /v1/instagram/profiles/{handle}/posts`
- [List Instagram profile reels](https://www.socialfetch.dev/docs/api/v1/instagram/profiles/handle/reels/get.mdx) — `GET /v1/instagram/profiles/{handle}/reels`
- [List Instagram profile highlights](https://www.socialfetch.dev/docs/api/v1/instagram/profiles/handle/highlights/get.mdx) — `GET /v1/instagram/profiles/{handle}/highlights`
- [Get Instagram highlight](https://www.socialfetch.dev/docs/api/v1/instagram/highlights/highlightid/get.mdx) — `GET /v1/instagram/highlights/{highlightId}`
- [Get Instagram post or reel](https://www.socialfetch.dev/docs/api/v1/instagram/posts/get.mdx) — `GET /v1/instagram/posts`
- [List Instagram post or reel comments](https://www.socialfetch.dev/docs/api/v1/instagram/posts/comments/get.mdx) — `GET /v1/instagram/posts/comments`
- [Get Instagram post transcript](https://www.socialfetch.dev/docs/api/v1/instagram/posts/transcript/get.mdx) — `GET /v1/instagram/posts/transcript`
- [Search Instagram Reels](https://www.socialfetch.dev/docs/api/v1/instagram/search/reels/get.mdx) — `GET /v1/instagram/search/reels`
## LinkedIn

- [Get LinkedIn profiles](https://www.socialfetch.dev/docs/api/v1/linkedin/profiles/get.mdx) — `GET /v1/linkedin/profiles`
- [List LinkedIn profile posts](https://www.socialfetch.dev/docs/api/v1/linkedin/profiles/posts/get.mdx) — `GET /v1/linkedin/profiles/posts`
- [Search LinkedIn people](https://www.socialfetch.dev/docs/api/v1/linkedin/people/search/get.mdx) — `GET /v1/linkedin/people/search`
- [Get LinkedIn organization page](https://www.socialfetch.dev/docs/api/v1/linkedin/organizations/get.mdx) — `GET /v1/linkedin/organizations`
- [Get LinkedIn company page](https://www.socialfetch.dev/docs/api/v1/linkedin/companies/get.mdx) — `GET /v1/linkedin/companies`
- [List LinkedIn company posts](https://www.socialfetch.dev/docs/api/v1/linkedin/companies/posts/get.mdx) — `GET /v1/linkedin/companies/posts`
- [Get LinkedIn post or article](https://www.socialfetch.dev/docs/api/v1/linkedin/posts/get.mdx) — `GET /v1/linkedin/posts`
- [Get LinkedIn jobs](https://www.socialfetch.dev/docs/api/v1/linkedin/jobs/get.mdx) — `GET /v1/linkedin/jobs`
- [Search LinkedIn jobs](https://www.socialfetch.dev/docs/api/v1/linkedin/jobs/search/get.mdx) — `GET /v1/linkedin/jobs/search`
## YouTube

- [Get YouTube channel](https://www.socialfetch.dev/docs/api/v1/youtube/channel/get.mdx) — `GET /v1/youtube/channel`
- [List YouTube channel videos](https://www.socialfetch.dev/docs/api/v1/youtube/channels/videos/get.mdx) — `GET /v1/youtube/channels/videos`
- [List YouTube channel shorts](https://www.socialfetch.dev/docs/api/v1/youtube/channels/shorts/get.mdx) — `GET /v1/youtube/channels/shorts`
- [Get YouTube playlist](https://www.socialfetch.dev/docs/api/v1/youtube/playlists/get.mdx) — `GET /v1/youtube/playlists`
- [Get YouTube community post](https://www.socialfetch.dev/docs/api/v1/youtube/community-posts/get.mdx) — `GET /v1/youtube/community-posts`
- [Search YouTube](https://www.socialfetch.dev/docs/api/v1/youtube/search/get.mdx) — `GET /v1/youtube/search`
- [Search YouTube by hashtag](https://www.socialfetch.dev/docs/api/v1/youtube/search/hashtags/get.mdx) — `GET /v1/youtube/search/hashtags`
- [List trending YouTube Shorts](https://www.socialfetch.dev/docs/api/v1/youtube/shorts/trending/get.mdx) — `GET /v1/youtube/shorts/trending`
- [Get YouTube video](https://www.socialfetch.dev/docs/api/v1/youtube/videos/get.mdx) — `GET /v1/youtube/videos`
- [List YouTube video comments](https://www.socialfetch.dev/docs/api/v1/youtube/videos/comments/get.mdx) — `GET /v1/youtube/videos/comments`
- [List YouTube comment replies](https://www.socialfetch.dev/docs/api/v1/youtube/videos/comments/replies/get.mdx) — `GET /v1/youtube/videos/comments/replies`
- [Get YouTube video transcript](https://www.socialfetch.dev/docs/api/v1/youtube/videos/transcript/get.mdx) — `GET /v1/youtube/videos/transcript`
## X / Twitter

- [Get Twitter profile](https://www.socialfetch.dev/docs/api/v1/twitter/profiles/handle/get.mdx) — `GET /v1/twitter/profiles/{handle}`
- [List Twitter profile tweets](https://www.socialfetch.dev/docs/api/v1/twitter/profiles/handle/tweets/get.mdx) — `GET /v1/twitter/profiles/{handle}/tweets`
- [Get Twitter tweet](https://www.socialfetch.dev/docs/api/v1/twitter/tweets/get.mdx) — `GET /v1/twitter/tweets`
- [List Twitter tweet replies](https://www.socialfetch.dev/docs/api/v1/twitter/tweets/replies/get.mdx) — `GET /v1/twitter/tweets/replies`
- [Get Twitter tweet transcript](https://www.socialfetch.dev/docs/api/v1/twitter/tweets/transcript/get.mdx) — `GET /v1/twitter/tweets/transcript`
- [Search Twitter posts](https://www.socialfetch.dev/docs/api/v1/twitter/search/get.mdx) — `GET /v1/twitter/search`
- [Search Twitter by hashtag](https://www.socialfetch.dev/docs/api/v1/twitter/hashtags/get.mdx) — `GET /v1/twitter/hashtags`
- [Get Twitter community](https://www.socialfetch.dev/docs/api/v1/twitter/communities/get.mdx) — `GET /v1/twitter/communities`
- [List Twitter community tweets](https://www.socialfetch.dev/docs/api/v1/twitter/communities/tweets/get.mdx) — `GET /v1/twitter/communities/tweets`
## Auth

- [Whoami](https://www.socialfetch.dev/docs/api/v1/whoami.mdx) — `GET /v1/whoami`
- [Get account balance](https://www.socialfetch.dev/docs/api/v1/balance.mdx) — `GET /v1/balance`
## System

- [Ask in natural language](https://www.socialfetch.dev/docs/api/v1/ask/post.mdx) — `POST /v1/ask`
- [Health check](https://www.socialfetch.dev/docs/api/health/get.mdx) — `GET /health`
## Telegram

- [Get Telegram channel](https://www.socialfetch.dev/docs/api/v1/telegram/channels/handle/get.mdx) — `GET /v1/telegram/channels/{handle}`
- [List Telegram channel posts](https://www.socialfetch.dev/docs/api/v1/telegram/channels/handle/posts/get.mdx) — `GET /v1/telegram/channels/{handle}/posts`
- [Get Telegram channel post](https://www.socialfetch.dev/docs/api/v1/telegram/channels/handle/posts/postid/get.mdx) — `GET /v1/telegram/channels/{handle}/posts/{postId}`
## Threads

- [Get Threads profile](https://www.socialfetch.dev/docs/api/v1/threads/profiles/handle/get.mdx) — `GET /v1/threads/profiles/{handle}`
- [List Threads profile posts](https://www.socialfetch.dev/docs/api/v1/threads/profiles/handle/posts/get.mdx) — `GET /v1/threads/profiles/{handle}/posts`
- [Search Threads posts](https://www.socialfetch.dev/docs/api/v1/threads/search/get.mdx) — `GET /v1/threads/search`
- [Get Threads post](https://www.socialfetch.dev/docs/api/v1/threads/posts/get.mdx) — `GET /v1/threads/posts`
- [Search Threads users](https://www.socialfetch.dev/docs/api/v1/threads/users/search/get.mdx) — `GET /v1/threads/users/search`
## Reddit

- [Get Reddit subreddit](https://www.socialfetch.dev/docs/api/v1/reddit/subreddits/get.mdx) — `GET /v1/reddit/subreddits`
- [List Reddit subreddit posts](https://www.socialfetch.dev/docs/api/v1/reddit/subreddits/subreddit/posts/get.mdx) — `GET /v1/reddit/subreddits/{subreddit}/posts`
- [Search Reddit subreddit](https://www.socialfetch.dev/docs/api/v1/reddit/subreddits/search/get.mdx) — `GET /v1/reddit/subreddits/search`
- [List Reddit post comments](https://www.socialfetch.dev/docs/api/v1/reddit/posts/comments/get.mdx) — `GET /v1/reddit/posts/comments`
- [Get Reddit post transcript](https://www.socialfetch.dev/docs/api/v1/reddit/posts/transcript/get.mdx) — `GET /v1/reddit/posts/transcript`
- [Search Reddit posts](https://www.socialfetch.dev/docs/api/v1/reddit/search/get.mdx) — `GET /v1/reddit/search`
## Rumble

- [Search Rumble](https://www.socialfetch.dev/docs/api/v1/rumble/search/get.mdx) — `GET /v1/rumble/search`
- [List Rumble channel videos](https://www.socialfetch.dev/docs/api/v1/rumble/channels/videos/get.mdx) — `GET /v1/rumble/channels/videos`
- [Get Rumble video](https://www.socialfetch.dev/docs/api/v1/rumble/videos/get.mdx) — `GET /v1/rumble/videos`
- [Get Rumble video transcript](https://www.socialfetch.dev/docs/api/v1/rumble/videos/transcript/get.mdx) — `GET /v1/rumble/videos/transcript`
- [List Rumble video comments](https://www.socialfetch.dev/docs/api/v1/rumble/videos/comments/get.mdx) — `GET /v1/rumble/videos/comments`
## GitHub

- [Get GitHub profile](https://www.socialfetch.dev/docs/api/v1/github/profiles/handle/get.mdx) — `GET /v1/github/profiles/{handle}`
- [List GitHub profile repositories](https://www.socialfetch.dev/docs/api/v1/github/profiles/handle/repositories/get.mdx) — `GET /v1/github/profiles/{handle}/repositories`
- [Get GitHub repository](https://www.socialfetch.dev/docs/api/v1/github/repositories/get.mdx) — `GET /v1/github/repositories`
- [List GitHub profile activity](https://www.socialfetch.dev/docs/api/v1/github/profiles/handle/activity/get.mdx) — `GET /v1/github/profiles/{handle}/activity`
- [List GitHub profile followers](https://www.socialfetch.dev/docs/api/v1/github/profiles/handle/followers/get.mdx) — `GET /v1/github/profiles/{handle}/followers`
- [List GitHub profile following](https://www.socialfetch.dev/docs/api/v1/github/profiles/handle/following/get.mdx) — `GET /v1/github/profiles/{handle}/following`
- [Get GitHub contribution graph](https://www.socialfetch.dev/docs/api/v1/github/profiles/handle/contributions/get.mdx) — `GET /v1/github/profiles/{handle}/contributions`
- [List trending GitHub repositories](https://www.socialfetch.dev/docs/api/v1/github/trending/repositories/get.mdx) — `GET /v1/github/trending/repositories`
- [List trending GitHub developers](https://www.socialfetch.dev/docs/api/v1/github/trending/developers/get.mdx) — `GET /v1/github/trending/developers`
## Spotify

- [Get Spotify artist](https://www.socialfetch.dev/docs/api/v1/spotify/artist/get.mdx) — `GET /v1/spotify/artist`
- [Get Spotify album](https://www.socialfetch.dev/docs/api/v1/spotify/album/get.mdx) — `GET /v1/spotify/album`
- [Get Spotify track](https://www.socialfetch.dev/docs/api/v1/spotify/track/get.mdx) — `GET /v1/spotify/track`
## Web

- [Search the web](https://www.socialfetch.dev/docs/api/v1/web/search/get.mdx) — `GET /v1/web/search`
- [Generate web page markdown](https://www.socialfetch.dev/docs/api/v1/web/markdown/get.mdx) — `GET /v1/web/markdown`
- [Ask a question about a web page](https://www.socialfetch.dev/docs/api/v1/web/ask/get.mdx) — `GET /v1/web/ask`
- [Generate web page HTML](https://www.socialfetch.dev/docs/api/v1/web/html/get.mdx) — `GET /v1/web/html`
- [Crawl web pages](https://www.socialfetch.dev/docs/api/v1/web/crawl/get.mdx) — `GET /v1/web/crawl`