# Schemas

Overview

Every endpoint of a resource returns the same fields on every platform, so you learn each schema once. `null` means unknown, never 0 or "".

## Available

- [Ads](https://socialtap.dev/resources/ad/index.md): Public ad library entries with their advertiser, creatives, run dates, placements and, where disclosed, reach and spend ranges. (Facebook Ad Library, Google Ads Transparency Center, LinkedIn Ad Library and TikTok Ad Library)
- [Albums](https://socialtap.dev/resources/album/index.md): Albums, singles and EPs with their artists, cover, release date, label, UPC, genres and tracks in order. (Apple Music and Spotify)
- [Comments](https://socialtap.dev/resources/comment/index.md): Public comments and replies with their author, text, place in the thread, and like and reply counts. (Bluesky, Facebook, Instagram, Reddit, Rumble, Snapchat, Threads, TikTok and YouTube)
- [Communities](https://socialtap.dev/resources/community/index.md): Public communities people join and post in (subreddits, Facebook groups), with their description, rules, privacy and member count. (Facebook, Reddit and X)
- [Downloads](https://socialtap.dev/resources/download/index.md): Direct download links for public video and photo posts, watermark-free first, with format, size, resolution and when each link expires. (TikTok)
- [Effects](https://socialtap.dev/resources/effect/index.md): Camera effects, filters and lenses creators use in their videos, with their creator and how many posts use them. (TikTok)
- [Embeds](https://socialtap.dev/resources/embed/index.md): Platforms' own embed code for public posts, videos, playlists and profiles: the HTML to paste, its iframe URL and size, and the title, author and thumbnail it shows. (Instagram)
- [Engagement stats](https://socialtap.dev/resources/engagement/index.md): Engagement rate, average views, likes and comments, posting cadence and top post for an account, computed from its recent posts the same way on every platform. (Facebook, Instagram, Reddit, Rumble, TikTok and YouTube)
- [Events](https://socialtap.dev/resources/event/index.md): Public events with their start and end, time zone, venue or online flag, hosts, categories, ticket link and attendance. (Facebook Events)
- [Hashtags](https://socialtap.dev/resources/hashtag/index.md): Public hashtags with their description, image and how many posts carry them (and, where shown, their views). (Instagram and TikTok)
- [Livestreams](https://socialtap.dev/resources/live/index.md): Live broadcasts (TikTok LIVE rooms, live streams) with their host, status, start and end, people watching and stream links. (TikTok and Twitch)
- [Offers](https://socialtap.dev/resources/offer/index.md): Every seller's offer of a product: price, condition, availability, shipping fee and delivery estimate, and the seller with its rating. (Amazon)
- [Places](https://socialtap.dev/resources/place/index.md): Locations posts are tagged with (venues, landmarks, areas), with their address, coordinates and post count. (Facebook Marketplace and Instagram)
- [Playlists](https://socialtap.dev/resources/playlist/index.md): Public playlists and collections of posts curated by an account, with their title, owner, cover and post count. (Amazon, Apple Music, Instagram, Pinterest, Spotify and TikTok)
- [Podcasts](https://socialtap.dev/resources/podcast/index.md): Podcasts with their publisher, description, cover, rating, categories, episode count and when the latest episode came out. (Spotify)
- [Posts](https://socialtap.dev/resources/post/index.md): Public posts (videos, reels, shorts, photos, carousels, tweets and text) with their author, text, media, and views, likes and comments. (Amazon, Apple Music, Bluesky, Facebook, Instagram, Kick, Kwai, LinkedIn, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, Truth Social, Twitch, X and YouTube)
- [Products](https://socialtap.dev/resources/product/index.md): Products and listings for sale, with their price, seller, images, specifications, condition, availability and shipping. (Amazon, Facebook Marketplace and TikTok Shop)
- [Profiles](https://socialtap.dev/resources/profile/index.md): Public accounts (creators, channels, pages, companies, communities) with their bio, links, and follower and post counts. (Amazon, Apple Music, Bluesky, Facebook, Facebook Ad Library, Google Ads Transparency Center, Instagram, Komi, Kwai, Lnk.Bio, LinkedIn, Linkme, Linktree, Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, Truth Social, Twitch, X and YouTube)
- [Reviews](https://socialtap.dev/resources/review/index.md): Buyers' public reviews of a product, with their star rating, text, photos, the variant bought and whether the purchase was verified. (Amazon and TikTok Shop)
- [Sounds](https://socialtap.dev/resources/sound/index.md): Sounds posts use (catalog tracks or creators' original audio) with their artist, length, audio link and how many posts use them. (Instagram and TikTok)
- [Suggestions](https://socialtap.dev/resources/suggestion/index.md): Autocomplete suggestions from a platform's search box for a partial query: completed searches, accounts, hashtags and websites, in its order. (Google Ads Transparency Center, Instagram and TikTok)
- [Topics](https://socialtap.dev/resources/topic/index.md): Public topic pages from a platform's search, with their title, the platform's summary and the related searches it suggests. (Instagram and Pinterest)
- [Transcripts](https://socialtap.dev/resources/transcript/index.md): Timed transcripts of public videos: the platform's caption track, or speech-to-text on the audio when there is none. (Facebook Ad Library, Facebook, Instagram, Kick, Reddit, Rumble, TikTok, Twitch and YouTube)
- [Trends](https://socialtap.dev/resources/trend/index.md): What is trending on a platform: the searches or topics rising there, in the platform's rank order, with how they move. (Pinterest)
- [Usernames](https://socialtap.dev/resources/username/index.md): Whether a username is free to register on a platform, why not if it's taken, and the free alternatives its sign-up form suggests. (Instagram)
- [Web Pages](https://socialtap.dev/resources/web_page/index.md): How many times a web page's link was shared or saved on a platform, for any page on or off it. (Pinterest)
- [Web results](https://socialtap.dev/resources/web_result/index.md): Profiles, posts and other platform pages found through a web search engine: what the result shows and, on request, the platform's own record. (Facebook, Instagram, LinkedIn, Telegram, TikTok and X)

---

[HTML version](https://socialtap.dev/resources/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)
