Discover capabilities at runtime
GET /v1/platforms is the source of truth for enabled operations, maximum result limits, base costs and per-result credit rates. Build dynamic clients from this response instead of hard-coding assumptions.
[
{
"platform": "instagram",
"label": "Instagram",
"operations": [
{
"operation": "profile",
"max_results": 1,
"credits_per_result": 1,
"results_per_credit": 1,
"base_credits": 0
},
{
"operation": "followers",
"max_results": 5000,
"credits_per_result": 2,
"results_per_credit": 1,
"base_credits": 0
},
{
"operation": "stories",
"max_results": 50,
"credits_per_result": 0,
"results_per_credit": 1,
"base_credits": 10
}
]
}
]Current public operations
Full operation catalog
Prices below are in Caelario credits. Flat, non-empty pricing charges once for the returned list; empty and failed results are not charged.
Instagram14 operations
profilePublic profile metadataUsername11 / resultpostOne post or reelContent URL or shortcode11 / resultfollowersVisible follower profilesUsername5,0002 / profilefollowingVisible followed profilesUsername5,0002 / profilepostsRecent feed postsUsername1002 / postreelsRecent reelsUsername1002 / reelcommentsTop-level commentsContent URL or shortcode2002 / commenthighlightsHighlight metadata and IDsUsername5010 flat when non-emptyhighlight_itemsStories inside one highlightHighlight ID or URL10010 flat when non-emptystoriesCurrently active storiesUsername5010 flat when non-emptyhashtagHashtag contentHashtag502 / resultsearch_usersMatching profilesSearch query502 / profiletaggedPosts tagging a profileUsername502 / posttranscriptVideo transcript with timingsVideo post/reel URL or shortcode120 / transcriptTikTok11 operations
profilePublic profile metadataUsername11 / resultpostsRecent public videosUsername2002 / videopostOne video or photo postVideo URL11 / resultcommentsVisible commentsVideo URL or ID2002 / commenthashtagHashtag videosHashtag2002 / resultsearchMatching videosSearch query2002 / resultsearch_usersMatching accountsSearch query2002 / profiletrendingTrending videos by marketTwo-letter country code2002 / videotranscriptVideo transcript with timingsVideo URL120 / transcriptadlibrary_searchMatching TikTok adsSearch query10010 flat when non-emptyadlibrary_adOne ad and creative metadataAd ID or Top Ads URL110 / adYouTube10 operations
profileChannel metadataHandle, channel ID, or URL11 / resultpostsRecent channel videosHandle, channel ID, or URL2001 / videovideoOne videoVideo ID or URL11 / resultcommentsTop-level commentsVideo ID or URL1001 / commentsearchMatching videosSearch query501 / resulttranscriptVideo transcript with timingsVideo ID or URL110 / transcriptshortsRecent channel ShortsHandle, channel ID, or URL2001 / ShorttrendingTrending videos by marketTwo-letter country code2001 / videoplaylistPlaylist metadataPlaylist ID or URL11 / resultplaylist_itemsVideos in a playlistPlaylist ID or URL5001 / videoX7 operations
profilePublic profile metadataUsername11 / resultfollowersVisible follower profilesUsername25,0002 / profilefollowingVisible followed profilesUsername25,0002 / profilepostsRecent public postsUsername1002 / postpostOne public postStatus URL or ID11 / resultsearchMatching public postsSearch query1002 / posttranscriptVideo transcript with timingsVideo status URL or ID120 / transcriptFacebook13 operations
profilePage/profile metadataHandle, numeric ID, or URL11 / resultpostsRecent public postsHandle, numeric ID, or URL2002 / postreelsRecent public reelsHandle, numeric ID, or URL2002 / reelpostOne post, reel, or videoContent URL or supported ID11 / resultcommentsTop-level commentsContent URL or ID2002 / commentcomment_repliesReplies to one commentcomment_url from comments2002 / replyadlibrary_companiesMatching advertisersCompany search query1003 / delivered advertiseradlibrary_company_adsAds for one advertiserAdvertiser page_id2003 / delivered adadlibrary_searchMatching public adsAd search query2003 / delivered adadlibrary_adOne ad and creative metadataAd ID or URL13 / adadlibrary_ad_transcriptAd creative transcriptAd ID or URL120 / transcripttranscriptPost/video transcriptVideo, reel, or post URL120 / transcriptprofile_analyticsSample-aware profile analyticsHandle, numeric ID, or URL15 / reportInstagram relationship lists
followers and following are separate collection operations supporting up to 5,000 requested profiles per job. Caelario walks bounded upstream pages internally, checkpoints progress, and settles at 2 credits per unique profile actually delivered.
Stories and highlights
Instagram stories, highlights, and highlight_items each cost a flat 10 credits when the returned list is non-empty. First request highlights for cover images, titles and highlight IDs; pass one returned ID to highlight_items to retrieve the stories inside it.
X relationship lists
followers and following accept a total requested maximum of up to 25,000 profiles. Large requests run as durable jobs: Caelario collects bounded cursor pages, checkpoints unique profiles and progress after each page, and returns one deduplicated result.
Normalized recent content
YouTube posts combines ordinary channel videos and Shorts, deduplicates them, and returns the newest public items first. Each item exposes its title separately from its description in caption.
Instagram post results include collaborative posts when the requested profile is an explicit co-author. The primary publisher remains in username, while collaborator_usernames lists the participating accounts.
Profile bundles
For supported profile operations, include_posts returns profile metadata and recent content in one job. The result is shaped as { profile, posts } and credits settle against the profile plus content actually returned.