Combien d'outils expose io.github.CDCStream/captapi ?

io.github.CDCStream/captapi expose 178 outil(s). Le coût de contexte pour les charger tous est d'environ 47014 tokens (coût unique au chargement, pas par appel).

accueil / serveurs / Médias / io.github.CDCStream/captapi

io.github.CDCStream/captapi

serveur MCP (Model Context Protocol) · captapi 0.1.0

▸ Médias

[ Non encore testé ]

Verdict MCP Hub
Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur.

streamable-httpType / transport

configAccès

~47014 tokensCoût de contexte

178Outils

Est-ce que io.github.CDCStream/captapi est sûr ?

Au dernier audit MCP Hub, le serveur MCP « io.github.CDCStream/captapi » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 178 outils

account_balance≈ 84 tokens
Plan, subscription vs top-up credits, monthly quota, and renewsAt — 0 credits. Costs 0 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (0)
Exemple d'appel
```
{"name": "account_balance", "arguments": {}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
account_daily_usage≈ 107 tokens
Day-by-day credit usage for spend monitoring (0 credits). Costs 0 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (1)
Paramètres
- days · integer · optionnel
  Number of days to include (default 30, max 365).
Exemple d'appel
```
{"name": "account_daily_usage", "arguments": {"days": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
account_most_used_routes≈ 145 tokens
Ranked list of which Captapi routes your key calls most (0 credits). Costs 0 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- days · integer · optionnel
  Number of days to include (default 30, max 365).
- limit · integer · optionnel
  Max rows to return (default 20, max 100). Free — does not consume credits.
Exemple d'appel
```
{"name": "account_most_used_routes", "arguments": {"days": 1, "limit": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
account_request_history≈ 264 tokens
Recent API requests for your key — requestId, status, credits, cacheHit (0 credits). Costs 0 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (6)
Paramètres
- limit · integer · optionnel
  Max rows to return (default 50, max 500). Free — does not consume credits.
- since · string · optionnel
  Inclusive lower bound on createdAt (ISO date or datetime).
- until · string · optionnel
  Exclusive upper bound on createdAt (ISO date or datetime).
- cursor · string · optionnel
  Pagination cursor from nextCursor (createdAt of the last row). Leave empty for the first page.
- endpoint · string · optionnel
  Exact Captapi path filter, e.g. /v1/instagram/basic-profile.
- statusCode · integer · optionnel
  Filter by HTTP status code (e.g. 500).
Exemple d'appel
```
{"name": "account_request_history", "arguments": {"limit": 1, "since": "texte", "until": "texte", "cursor": "texte", "endpoint": "texte", "statusCode": 1}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
amazon_shop_page≈ 352 tokens
Third-party seller storefronts (/sp?seller= / /s?me=) — ASIN + canonical /dp URLs, price, badges. Not influencer /shop/{handle}. Costs 1 credit per 16 products (default limit 20 = 2). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (5)
Paramètres
- url · string · requis
  Amazon seller storefront URL (/sp?seller=… or /s?me=…) or raw seller ID. Not influencer /shop/<handle> pages. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max products to include (default 20, max 200; 0 = seller metadata only). Billed per 16-product storefront page: ceil(limit / 16) credits, minimum 1 — the default 20 costs 2.
- cursor · string · optionnel
  Pagination cursor from nextCursor (page or page:offset). Leave empty for the first page.
- marketplace · string · optionnel
  Amazon marketplace code. Default US.
Exemple d'appel
```
{"name": "amazon_shop_page", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
analytics_compare≈ 186 tokens
Compare unified metrics across up to 10 URLs — each row is the analytics/post object (1 credit/resolved URL). Costs 1 credit/url. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- urls · string · requis
  Comma-separated post/video/reel URLs (up to 10), any mix of the same 11 platforms as Post Analytics. Example: a TikTok URL and a YouTube URL in one call.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "analytics_compare", "arguments": {"urls": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
analytics_post≈ 224 tokens
Unified metrics for one post, video, or reel — platform auto-detected (1 credit). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Public post/video/reel URL from one of 11 platforms: YouTube, TikTok, Instagram, Facebook, X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, or Rumble. Platform is auto-detected — cross-platform URLs are expected here (unlike single-platform endpoints). Not in scope: Kwai, Twitch, Spotify, Snapchat, and other Captapi platforms.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "analytics_post", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
bluesky_post_details≈ 258 tokens
Post thread via getPostThread — nested replies[], facet links/mentions/hashtags, rich author (1 credit). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Bluesky post URL, e.g. https://bsky.app/profile/handle/post/RKEY. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- depth · integer · optionnel
  Reply nesting levels under the post (0 = post only with no replies[], default 1, max 6). Maps to Bluesky getPostThread depth.
Exemple d'appel
```
{"name": "bluesky_post_details", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
bluesky_profile≈ 261 tokens
Bluesky profile — handle, did, bio, counts, banner, verification{}, labels[], and associated{} (1 credit). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Bluesky profile URL, @handle, or handle, e.g. bsky.app/profile/handle. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.
- cacheMaxAge · string · optionnel
  Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.
Exemple d'appel
```
{"name": "bluesky_profile", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
bluesky_user_posts≈ 427 tokens
Author feed — posts and reposts (isRepost marked), quote/external/images embeds, opaque cursor. Costs ~3 credits (0.1/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (6)
Paramètres
- url · string · requis
  Bluesky profile URL, @handle, or handle, e.g. https://bsky.app/profile/handle.bsky.social. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 25, max 100). Billed per result.
- cursor · string · optionnel
  Opaque pagination cursor from the previous nextCursor. Leave empty for the first page. Do not invent a cursor from publishedAt — the feed is ordered by feed time (reposts sort by repost time).
- filter · string · optionnel
  Bluesky getAuthorFeed filter: posts_with_replies (default), posts_no_replies, posts_with_media, posts_and_author_threads, or posts_with_video. Controls replies/media/threads — not reposts. Use includeReposts=false to drop reposts.
- includeReposts · boolean · optionnel
  When false, omit repost rows (reasonRepost). Default true — reposts are included and marked with isRepost / repostedBy / repostedAt.
Exemple d'appel
```
{"name": "bluesky_user_posts", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_ad_library_ad_details≈ 207 tokens
One Meta ad by ID — same creative as search, plus delivery breakdowns when Meta publishes them. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Meta Ad Library ad URL or ad ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "facebook_ad_library_ad_details", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_ad_library_ad_transcript≈ 240 tokens
Written creative copy from a Meta ad — headline, body, CTA, landing URL. Not a speech transcript. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Meta Ad Library ad URL or ad ID. Returns the ad's written copy — headline, body text, CTA and landing URL. Meta does not expose ad audio, so this is not a speech transcript. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "facebook_ad_library_ad_transcript", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_ad_library_company_ads≈ 410 tokens
Ads for one Meta page — active by default, cursor through the HTML batch, same envelope as /facebook/search. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (6)
Paramètres
- url · string · requis
  pageId from /search-companies (preferred), libraryUrl, vanity page URL (facebook.com/nike/), or Ad Library URL with view_all_page_id. Do not pass profileId from facebook.com/{digits}/ when it differs from pageId. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 200). Flat 2 credits per call on the native path; the extended fallback bills per returned ad.
- cursor · string · optionnel
  Pagination cursor from a previous nextCursor. Pages through the current Meta HTML result batch.
- status · string · optionnel
  Ad delivery status: ACTIVE (default), INACTIVE, or ALL. Use ACTIVE for "what are they running now?".
- country · string · optionnel
  Two-letter ISO country code. Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY.
Exemple d'appel
```
{"name": "facebook_ad_library_company_ads", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_ad_library_search≈ 613 tokens
Search Meta Ad Library by keyword — active/inactive, media type, date range, platforms, cursor, and spend/impressions when Meta publishes them. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (14)
Paramètres
- q · string · requis
  Keyword, brand, or advertiser to search Meta Ad Library (min 2 characters).
- trim · boolean · optionnel
  When true, omit cards/images/videos typed arrays (media[] stays). Captapi payloads are already lean vs Meta nested snapshots.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 200). Flat 2 credits per call.
- cursor · string · optionnel
  Pagination cursor from a previous nextCursor. Pages through the current Meta HTML result batch.
- status · string · optionnel
  Ad delivery status: ACTIVE (default), INACTIVE, or ALL. Use ACTIVE for "what are they running now?".
- ad_type · string · optionnel
  all (default) or political_and_issue_ads. Spend/impressions are typically only filled for political/issue ads.
- country · string · optionnel
  Two-letter ISO country code (e.g. US, GB, DE). Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY — Meta would otherwise ignore the code and search globally while echoing it back as if the filter worked.
- sort_by · string · optionnel
  Meta sort mode: total_impressions or relevancy_monthly_grouped.
- end_date · string · optionnel
  Only ads with delivery start on/before this date (YYYY-MM-DD).
- platforms · string · optionnel
  Comma-separated publisher platforms to keep: FACEBOOK, INSTAGRAM, MESSENGER, AUDIENCE_NETWORK, THREADS.
- media_type · string · optionnel
  Creative filter: ALL (default), IMAGE, VIDEO, MEME, IMAGE_AND_MEME, or NONE.
- start_date · string · optionnel
  Only ads with delivery start on/after this date (YYYY-MM-DD).
- search_type · string · optionnel
  keyword_unordered (default) or keyword_exact_phrase.
Exemple d'appel
```
{"name": "facebook_ad_library_search", "arguments": {"q": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_ad_library_search_companies≈ 238 tokens
Find Meta Ad Library pages by brand — name-matched, pageId for company-ads (not profileId). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- q · string · requis
  Company or brand name to search for (min 2 characters). Name-matched — off-brand pages are dropped.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 200). Flat 2 credits per call.
- country · string · optionnel
  Two-letter ISO country code. Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY.
Exemple d'appel
```
{"name": "facebook_ad_library_search_companies", "arguments": {"q": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_comment_replies≈ 261 tokens
Comment Replies Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- url · string · requis
  Facebook post URL the comment belongs to. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 50, max 500). Flat 2 credits per call.
- commentId · string · requis
  ID of the parent (top-level) comment to fetch replies for — from the comments endpoint. Legacy alias: comment_id.
Exemple d'appel
```
{"name": "facebook_comment_replies", "arguments": {"url": "texte", "commentId": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_comments≈ 288 tokens
Facebook post comments with reactionCount, reactions.like when mixed, author.id (pfbid), and replyCount. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- url · string · optionnel
  Facebook post or Reel URL. Omit when feedbackId is set. The URL platform must match this endpoint's platform. A page/profile URL also works: Facebook renders the page's most recent post first, so you get that post's comments (each comment's url names the actual post).
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 50, max 500). Flat 2 credits per call.
- feedbackId · string · optionnel
  Post feedback id from /v1/facebook/details (base64 feedback:POSTID). Prefer when you already have it — also accepts feedback_id.
Exemple d'appel
```
{"name": "facebook_comments", "arguments": {"url": "texte", "cache": true, "limit": 1, "feedbackId": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_details≈ 204 tokens
Facebook post or Reel — caption, engagement, author id, video{} playback, and music when Facebook exposes them. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Public Facebook video or post URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "facebook_details", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_event_details≈ 209 tokens
Get a Facebook event — title, local start/end, timezone, place, host id, and attendance when exposed. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Facebook event URL, e.g. https://facebook.com/events/ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "facebook_event_details", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_event_search≈ 350 tokens
Search Facebook events by topic and city — local startDate/timezone, venue. 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (7)
Paramètres
- q · string · requis
  Topic keyword, e.g. 'comedy'. Pair with location for city-scoped results.
- to · string · optionnel
  Inclusive local start date filter YYYY-MM-DD.
- from · string · optionnel
  Inclusive local start date filter YYYY-MM-DD. Use for upcoming-only windows — Facebook/SERP may return past events.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 200). Flat 2 credits per call. Response `source` is native or extended (fetch path — not a price change).
- location · string · optionnel
  City/place geo filter (e.g. London). Matches timezone, location.city, or coords near the city — not a title substring.
- upcoming · boolean · optionnel
  When true and from is omitted, sets from to today's UTC date so past events are dropped.
Exemple d'appel
```
{"name": "facebook_event_search", "arguments": {"q": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_group_posts≈ 337 tokens
Newest posts from a public Facebook group — caption, author, engagement, sortBy; 1 credit per post. Costs ~20 credits (1/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- url · string · requis
  Public Facebook group URL, e.g. https://facebook.com/groups/ID. Must contain /groups/ — profile/page URLs are a definitive 400 (use /v1/facebook/profile-posts for those). The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max posts to return (default 20, max 200; up to 80 per call — above that you get 80 with truncatedReason per-call-cap). Billed 1 credit per returned post, minimum 2.
- sortBy · string · optionnel
  TOP_POSTS | RECENT_ACTIVITY | CHRONOLOGICAL (default) | CHRONOLOGICAL_LISTINGS. Maps to Facebook sorting_setting.
Exemple d'appel
```
{"name": "facebook_group_posts", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_marketplace_item≈ 200 tokens
Marketplace listing — title, priceAmount, status, seller{}, condition, coords (2 credits). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Facebook Marketplace item URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "facebook_marketplace_item", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_marketplace_location_search≈ 209 tokens
Disambiguate city names into Marketplace hubs — id + lat/lng. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- q · string · requis
  City/place query. Bare names like 'Austin' may return multiple candidates (TX/MN/IN); include a state for a single hit (e.g. 'Austin, TX').
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 10, max 50). Flat 2 credits per call.
Exemple d'appel
```
{"name": "facebook_marketplace_location_search", "arguments": {"q": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_marketplace_search≈ 714 tokens
Search Marketplace by keyword + city — filters, isLocal/shipsOutsideRadius, opaque cursor (2 credits). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (16)
Paramètres
- q · string · requis
  Product or keyword to search Facebook Marketplace for.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  How many listings to return (1–200). Flat 2 credits when details=false; details=true billed as 2 + 2 per listing.
- cursor · string · optionnel
  Opaque pagination cursor from a previous nextCursor.
- sortBy · string · optionnel
  suggested | distance | creation_time | price_ascend | price_descend.
- details · boolean · optionnel
  When true, adds description/condition/coordinates/full photo gallery/seller/distanceMiles — billed as 2 + 2 credits per listing. Default false → flat 2 credits; cover photo is still in image.
- category · string · optionnel
  Top-level category slug, e.g. electronics.
- location · string · optionnel
  Alias of searchLocation. Prefer searchLocation. Either one is required.
- maxPrice · integer · optionnel
  Maximum price in local currency units.
- minPrice · integer · optionnel
  Minimum price in local currency units.
- condition · string · optionnel
  new, like_new, good, fair (comma-separated ok).
- radiusMiles · integer · optionnel
  Radius in miles: 1,2,5,10,20,40,60,80,100,250,500. Does not exclude nationwide shipped inventory.
- availability · string · optionnel
  available | sold | all.
- deliveryMethod · string · optionnel
  local_pickup | shipping | all. Shipped listings can appear nationwide outside radiusMiles — use local_pickup for nearby-only; rows expose isLocal / shipsOutsideRadius.
- searchLocation · string · requis
  Search-origin city or place name, e.g. 'Austin, TX'. Required — there is no default city. Echoed on the envelope and inside filters. Not listings[].location. Names that don't resolve to a real place are a definitive 400 UNKNOWN_LOCATION (Facebook would otherwise silently search an unrelated metro) — /v1/facebook/marketplace-location-search finds valid ones.
- daysSinceListed · string · optionnel
  Facebook calendar-day recency: 1 = since the start of yesterday (not a rolling 24 hours), 7, or 30.
Exemple d'appel
```
{"name": "facebook_marketplace_search", "arguments": {"q": "texte", "searchLocation": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_page_details≈ 215 tokens
Facebook page profile — likes vs followers (distinct), talkingAbout, category, website, and public email. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Facebook page URL, @handle, or page name, e.g. https://facebook.com/PageName. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "facebook_page_details", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_profile_events≈ 252 tokens
List a Facebook Page's events — local startDate, timezone, venue. 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Facebook profile/page URL, @handle, or page name. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 200). Flat 2 credits per call. Response `source` is native or extended (fetch path — not a price change).
Exemple d'appel
```
{"name": "facebook_profile_events", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_profile_photos≈ 274 tokens
Photo grid from a Facebook Page — full image URL plus accessibilityCaption (alt-text, not a post caption). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Facebook profile/page URL, @handle, or page name. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 200). The public /photos grid is a single SSR batch (often ~8) — retrievableCount is that batch, not a promise Facebook will fill limit. Flat 2 credits per call.
Exemple d'appel
```
{"name": "facebook_profile_photos", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_profile_posts≈ 354 tokens
Latest posts and Reels from a Facebook page — listingHits / timings.phase; 60s deadline, failures 0 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Facebook profile/page URL, @handle, or page name. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 4, max 4). The logged-out listing hop is ~23–29s typical, hard-capped at 40s. Each hydrate is typically 6–10s (can be ~100ms when listing already carried the post) and is capped at 12s. The next-item fit check uses that 12s cap, not the typical 6–10s, so a call cannot exceed 60s. The loop stops when the next item would miss the 60s deadline and returns what it has (truncatedReason=hydrate-budget | deadline). Asking for 20 cannot return 20 inside that ceiling. Flat 2 credits per call.
Exemple d'appel
```
{"name": "facebook_profile_posts", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_profile_reels≈ 239 tokens
Latest Facebook page Reels — views, likes, comments, shares; newest-first without archive padding. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Facebook profile/page URL, @handle, or page name. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 200). Flat 2 credits per call.
Exemple d'appel
```
{"name": "facebook_profile_reels", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
facebook_summarize≈ 180 tokens
Summarizer Costs 4 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Public Facebook video or post URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "facebook_summarize", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
github_activity≈ 227 tokens
Public events with typed payload (Push commits/ref, PR/issue action) — 90-event ceiling. Costs ~12 credits (0.4/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 30, max 90). Billed per result.
- cursor · string · optionnel
  Opaque cursor from a previous nextCursor. Pagination stops after GitHub's 90-event public activity ceiling.
- username · string · requis
  GitHub username or profile URL, e.g. getify.
Exemple d'appel
```
{"name": "github_activity", "arguments": {"username": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
github_contributions≈ 165 tokens
GitHub contribution graph — sorted days[], currentStreak (today grace), longestStreak (2 credits). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- username · string · requis
  GitHub username or profile URL, e.g. getify or https://github.com/getify.
Exemple d'appel
```
{"name": "github_contributions", "arguments": {"username": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
github_followers≈ 225 tokens
Follower cards {id, login, type, url, avatar} — ~0.1/row; large accounts are expensive to page fully. Costs ~3 credits (0.1/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 30, max 100). Billed per result.
- cursor · string · optionnel
  Opaque cursor from a previous nextCursor (GitHub Link page=). Not a bare page number.
- username · string · requis
  GitHub username or profile URL, e.g. getify.
Exemple d'appel
```
{"name": "github_followers", "arguments": {"username": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
github_following≈ 218 tokens
Accounts a user follows — same card and ~0.1/row pricing as followers. Costs ~3 credits (0.1/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 30, max 100). Billed per result.
- cursor · string · optionnel
  Opaque cursor from a previous nextCursor (GitHub Link page=). Not a bare page number.
- username · string · requis
  GitHub username or profile URL, e.g. getify.
Exemple d'appel
```
{"name": "github_following", "arguments": {"username": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
github_pull_requests≈ 261 tokens
List repo PRs — draft, labels, author{}, head/base, opaque Link cursor (state echoed). Costs ~12 credits (0.4/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (5)
Paramètres
- repo · string · requis
  Repository URL or owner/name, e.g. vercel/next.js.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 30, max 100). Billed per result.
- state · string · optionnel
  open (API default), closed, or all. Echoed as data.state. Docs example uses closed so mergedAt is visible.
- cursor · string · optionnel
  Opaque cursor from a previous nextCursor (GitHub Link page=). Not a bare page number.
Exemple d'appel
```
{"name": "github_pull_requests", "arguments": {"repo": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
github_repositories≈ 322 tokens
List a user's repos with sort/direction/type — opaque Link cursor (~0.4/repo). Costs ~12 credits (0.4/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (7)
Paramètres
- sort · string · optionnel
  created | updated | pushed | full_name (default updated). Not stars — GitHub's user-repos API has no stars sort. Echoed as data.sort.
- type · string · optionnel
  owner (default) | member | all — affiliation filter. Echoed as data.type.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 30, max 100). Billed per result.
- cursor · string · optionnel
  Opaque cursor from a previous nextCursor (GitHub Link page=). Not a bare page number.
- username · string · requis
  GitHub username or profile URL, e.g. torvalds.
- direction · string · optionnel
  asc or desc (default desc). Echoed as data.direction.
Exemple d'appel
```
{"name": "github_repositories", "arguments": {"username": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
github_repository≈ 167 tokens
GitHub repo — stars, real watchers (subscribers), openIssuesAndPrs, license, parent when fork (1 credit). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- repo · string · requis
  Repository URL or owner/name, e.g. torvalds/linux or https://github.com/torvalds/linux.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "github_repository", "arguments": {"repo": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
github_trending_developers≈ 226 tokens
github.com/trending/developers — windowed ranks with popularRepo + followers (2 credits). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 25, max 100). Flat 2 credits per call.
- since · string · optionnel
  Trending window: daily (default), weekly, or monthly — matches github.com/trending/developers?since=.
- language · string · optionnel
  Optional programming-language slug → /trending/developers/{language}.
Exemple d'appel
```
{"name": "github_trending_developers", "arguments": {"cache": true, "limit": 1, "since": "texte", "language": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
github_trending_repositories≈ 232 tokens
github.com/trending — repos ranked by starsGained (daily|weekly|monthly), not all-time stars (2 credits). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 25, max 100). Flat 2 credits per call.
- since · string · optionnel
  Trending window: daily (default), weekly, or monthly — matches github.com/trending?since=.
- language · string · optionnel
  Optional programming-language slug (e.g. python, typescript) → /trending/{language}.
Exemple d'appel
```
{"name": "github_trending_repositories", "arguments": {"cache": true, "limit": 1, "since": "texte", "language": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
github_user≈ 162 tokens
GitHub public profile — login, type User|Organization, email when public, followers (1 credit). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- username · string · requis
  GitHub username or profile URL, e.g. getify or https://github.com/getify.
Exemple d'appel
```
{"name": "github_user", "arguments": {"username": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
google_ad_library_ad_details≈ 258 tokens
Google publishes spend and impression ranges only for election ads; commercial advertisers omit both. isActive is true when lastShown is within 7 UTC days. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- country · string · optionnel
  Two-letter ISO country code. Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY.
- creative_id · string · requis
  Google Ads Transparency URL containing AR... advertiser and CR... creative IDs. A creative that does not exist under the advertiser is a definitive 404 AD_NOT_FOUND (upstream answered) — 503 is reserved for actual transport failures.
Exemple d'appel
```
{"name": "google_ad_library_ad_details", "arguments": {"creative_id": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
google_ad_library_advertiser_search≈ 260 tokens
Find Google Ads Transparency AR… entities — ranked multi-result (1 credit when found; empty is free). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- q · string · requis
  Brand, domain, or advertiser name (min 2 characters). Expanded + ranked so US prefers Inc. over SRL.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 10, max 50). Flat 1 credit when results are returned; 0 credits when totalReturned is 0.
- country · string · optionnel
  Two-letter ISO country code used for ranking (e.g. US). Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY.
Exemple d'appel
```
{"name": "google_ad_library_advertiser_search", "arguments": {"q": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
google_ad_library_company_ads≈ 474 tokens
Google publishes spend and impression ranges only for election ads; commercial advertisers omit both. isActive is true when lastShown is within 7 UTC days. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (10)
Paramètres
- sort · string · optionnel
  Client-side sort: last_shown (recent activity first) or first_shown. Default is ATC order.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 200). Flat 2 credits when results are returned; 0 credits when totalReturned is 0.
- topic · string · optionnel
  Only "all" is supported (commercial ATC). Google publishes spend and impression ranges only for election ads; commercial advertisers omit both. isActive is true when lastShown is within 7 UTC days.
- cursor · string · optionnel
  Pagination cursor from nextCursor.
- region · string · optionnel
  Alias for country.
- country · string · optionnel
  Two-letter ISO country / region code (soft filter). Default US. Alias: region. Non-ISO codes are a definitive 400 INVALID_COUNTRY.
- end_date · string · optionnel
  YYYY-MM-DD — keep creatives whose shown window overlaps this end.
- advertiser · string · requis
  Advertiser name, domain (e.g. nike.com), or Google advertiser ID (AR…). Prefer AR… from advertiser-search.
- start_date · string · optionnel
  YYYY-MM-DD — keep creatives whose shown window overlaps this start.
Exemple d'appel
```
{"name": "google_ad_library_company_ads", "arguments": {"advertiser": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
google_maps_business_search≈ 381 tokens
Local businesses from a Maps search — name, address, phone, website, rating, hours, place id. Flat 2 credits. No emails. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (6)
Paramètres
- q · string · requis
  Keyword, for example plumber or coffee. Min 2 characters.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max businesses to return (default 20, max 100). Not a page cursor — there is no next page. Flat 2 credits on every successful call, including zero businesses.
- language · string · optionnel
  Language code, for example en. Default en.
- location · string · optionnel
  Place name: City, Country or City, Region, Country — for example Austin, TX, Istanbul, Turkey, Paris, France, or a country such as Germany. Case, accents, US state codes, and country aliases (USA, UK, Turkey) are handled. A city name shared by several places (Paris) returns 400 with suggestions. When set, the locationCode parameter is ignored.
- locationCode · integer · optionnel
  Numeric place code, used only when location is omitted. Default 2840 (United States).
Exemple d'appel
```
{"name": "google_maps_business_search", "arguments": {"q": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
instagram_basic_profile≈ 246 tokens
Instagram profile by user ID or @handle — camelCase schema aligned with Channel Details (followers, externalUrl, businessAddress). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- cache · boolean · optionnel
  Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.
- userId · string · requis
  Instagram numeric pk (e.g. 13460080 — the id field on this endpoint), or a profile URL / @handle / username. A Facebook/Graph fbid (17-digit 17841…) is 400 WRONG_ID_TYPE.
- cacheMaxAge · string · optionnel
  Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.
Exemple d'appel
```
{"name": "instagram_basic_profile", "arguments": {"userId": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
instagram_channel_details≈ 266 tokens
Instagram profile stats — fixed key set (null fillers), fbid, bioLinks, isBusinessAccount, approx flags. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Instagram profile URL, @handle, or username, e.g. https://instagram.com/username/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.
- cacheMaxAge · string · optionnel
  Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.
Exemple d'appel
```
{"name": "instagram_channel_details", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
instagram_channel_posts≈ 311 tokens
Latest posts from a public Instagram profile — carousel children[], mediaCount, user{} in one call. Costs ~6 credits (0.3/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- url · string · requis
  Instagram profile URL, @handle, or username, e.g. https://instagram.com/username/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 200). Billed per result.
- cursor · string · optionnel
  Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (e.g. 3937014945555313553_1697296). A null nextCursor means the end of the list.
Exemple d'appel
```
{"name": "instagram_channel_posts", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
instagram_channel_reels≈ 338 tokens
Latest Reels from a public Instagram profile — pass userId to skip resolve; ceil(n×0.3) credits; nextCursor + hasMore. Costs ~6 credits (0.3/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (5)
Paramètres
- url · string · optionnel
  Instagram profile URL, @handle, or username. Omit when userId is set. The URL platform must match this endpoint's platform.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 200). Billed per result.
- cursor · string · optionnel
  Pagination cursor. Leave empty for the first page; then pass nextCursor from the previous response (clips:{userId}:{opaque} on the native Reels path, or legacy {mediaId}_{userId}). Stop when hasMore is false.
- userId · string · optionnel
  Instagram numeric user ID (e.g. 173560420). Skips handle→ID resolve (legacy sequential WPI alone could cost ~80s). Prefer when you already have the ID from basic-profile or profile-search.
Exemple d'appel
```
{"name": "instagram_channel_reels", "arguments": {"url": "texte", "cache": true, "limit": 1, "cursor": "texte", "userId": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
instagram_comments≈ 314 tokens
Session-paged Instagram comments — a logged-out 2-row preview of a larger thread is 503 SESSION_UNAVAILABLE at 0 credits. Costs ~45 credits (0.9/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- url · string · requis
  Instagram post or reel URL, e.g. https://instagram.com/reel/ID/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 50, max 500). Billed per result.
- cursor · string · optionnel
  Pagination cursor from the previous nextCursor ({mediaPk}:{minId}). Omit on the first page. hasMore is true when nextCursor is set, or when more exist and cannot be paged (nextCursor null + truncatedReason).
Exemple d'appel
```
{"name": "instagram_comments", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
instagram_details≈ 217 tokens
Get an Instagram post, Reel or carousel — caption, likes, comments, views, media URLs, author, and per-slide children on carousels. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Instagram post or reel URL, e.g. https://instagram.com/reel/ID/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "instagram_details", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
instagram_embed≈ 222 tokens
Classic Instagram embed snippet — blockquote.instagram-media + embed.js. Drop html into your page. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Instagram post, reel, or profile URL (or @handle), e.g. https://instagram.com/reel/ID/ or https://instagram.com/username/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "instagram_embed", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
instagram_hashtag_search≈ 225 tokens
Hashtag Explore: native grid first, fallback path only on miss. Max 50. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- q · string · requis
  Hashtag without the # (min 2 characters). One token — spaces are 400 HASHTAG_HAS_SPACES.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 50). Flat 2 credits per call.
- mediaType · string · optionnel
  all (default) or reels — return only Reels/clips when set to reels.
Exemple d'appel
```
{"name": "instagram_hashtag_search", "arguments": {"q": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
instagram_highlights≈ 215 tokens
Persistent Story Highlight albums for a public profile — id, title, cover, owner. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · optionnel
  Instagram profile URL, @handle, or username. Omit when userId is set.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- userId · string · optionnel
  Numeric Instagram user ID. Prefer when known — skips handle→ID resolve. When only userId is set we reverse-resolve the username so the WPI / profile-HTML shelf can still run.
Exemple d'appel
```
{"name": "instagram_highlights", "arguments": {"url": "texte", "cache": true, "userId": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
instagram_highlights_details≈ 164 tokens
Items inside one Instagram Story Highlight album — media URLs, type, takenAt. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- id · string · requis
  Highlight id from /v1/instagram/highlights (with or without highlight: prefix).
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "instagram_highlights_details", "arguments": {"id": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
instagram_profile_search≈ 214 tokens
Resolve a brand or @handle to one public Instagram profile — stable id, bio, links, and stats (not niche discovery). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- q · string · requis
  Account name, @handle, or profile URL to resolve (min 2 characters). A leading _, accents (misión → mision), spaces and URL query strings (?igsh=…) are stripped. A q with no usable username characters is 400 BAD_REQUEST. Not a niche keyword search.
- cache · boolean · optionnel
  Serve from the 24h shared cache when available (0 credits on hit). Default true — set false to always fetch fresh.
Exemple d'appel
```
{"name": "instagram_profile_search", "arguments": {"q": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
instagram_reels_by_audio_id≈ 200 tokens
Is this Instagram sound trending? Reels that use it + isTrendingInClips / trendRank / rich music{}. Costs ~28 credits (1.4/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 200). Billed per result.
- audioId · string · requis
  Instagram audio/music ID or full audio URL, e.g. 27919946310946207.
Exemple d'appel
```
{"name": "instagram_reels_by_audio_id", "arguments": {"audioId": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
instagram_reels_search≈ 232 tokens
Native tag feed first, slower fallback paths on a miss. Max 50. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- q · string · requis
  Hashtag without the # (min 2 characters). One token — spaces are 400 HASHTAG_HAS_SPACES.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 50). Flat 2 credits per call.
- datePosted · string · optionnel
  last_24_hours | last_week | last_month | last_year (aliases: today, this_week, this_month, this_year).
Exemple d'appel
```
{"name": "instagram_reels_search", "arguments": {"q": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
instagram_summarize≈ 254 tokens
Get an AI summary of any Instagram Reel — a short paragraph plus key points, without watching the video. Costs 4 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Instagram Reel URL, e.g. https://instagram.com/reel/ID/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- language · string · optionnel
  ISO code, e.g. "tr": pins the speech language and sets the summary output language. Defaults to auto-detect + English summary.
Exemple d'appel
```
{"name": "instagram_summarize", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
instagram_tagged_posts≈ 290 tokens
Posts that tag an Instagram account — author verified/avatar when available, staleFeed when Instagram only exposes an archive. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- url · string · requis
  Instagram profile URL, @handle, or username, e.g. https://instagram.com/username/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 200). Flat 1 credit per call.
- cursor · string · optionnel
  Leave empty for the first page; then pass the nextCursor value returned in the previous response.
Exemple d'appel
```
{"name": "instagram_tagged_posts", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
instagram_transcript≈ 250 tokens
Turn any Instagram Reel's speech into text — the full transcript plus timestamped segments, ready for search, subtitles, or AI pipelines. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Instagram Reel URL, e.g. https://instagram.com/reel/ID/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- language · string · optionnel
  Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.
Exemple d'appel
```
{"name": "instagram_transcript", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
instagram_trending_reels≈ 285 tokens
Cache-first trending Reels. Feed outage → labelled country hashtag-clips stand-in (listing field), never a silent swap. Max 50. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Successful calls bill even on cache hits.
Paramètres, retour & exemple (3)
Paramètres
- cache · boolean · optionnel
  Default true (cache-first): serve the per-country response cache when present (TTL 4 hours). Every successful call costs 2 credits — including cache hits. Set false to force a live scrape (measured miss 45–75s, hard-capped at 110s). Raise client timeouts above 90s — n8n/Make defaults will fail a miss. The fresh result still refreshes the cache.
- limit · integer · optionnel
  Max items to return (default 10, max 50). Flat 2 credits per call.
- country · string · optionnel
  Country for Reels localization — full name or ISO code (e.g. 'United States', 'US', 'Turkey', 'TR'). Default United States. Unsupported values return 400 with supportedCountries[].
Exemple d'appel
```
{"name": "instagram_trending_reels", "arguments": {"cache": true, "limit": 1, "country": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
kick_clip≈ 334 tokens
Get a Kick clip — source, 7d clip cache, fallback paths on a miss. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- url · string · requis
  Kick clip URL for one enriched clip (e.g. https://kick.com/{channel}/clips/clip_…), or channel input for recent clips[]: kick.com/{name}, kick.com/@{name}, @{name}, or {name}. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.
- limit · integer · optionnel
  Channel mode only — max recent clips to return (default 30, max 100). Ignored when url is a clip. Flat 1 credit. No cursor — Kick returns a single page.
- cacheMaxAge · string · optionnel
  Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.
Exemple d'appel
```
{"name": "kick_clip", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
komi_page≈ 269 tokens
Komi link-in-bio → identity, socials{} (incl. website), content LINK/PRODUCT rows with price/currency. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Komi page URL or username, e.g. https://komi.io/kimkardashian or https://kimkardashian.komi.io/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.
- cacheMaxAge · string · optionnel
  Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.
Exemple d'appel
```
{"name": "komi_page", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
kwai_post≈ 209 tokens
Single Kwai video — caption ("" when none), hashtags[], author, mp4 (2 credits). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Kwai video URL, e.g. https://www.kwai.com/@topfilmeseseriesnatv/video/5240932700689736196. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "kwai_post", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
kwai_profile≈ 207 tokens
Fetch Kwai profile — display name, bio, counts, and verification as structured JSON. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Kwai profile URL or @handle, e.g. https://www.kwai.com/@topfilmeseseriesnatv. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "kwai_profile", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
kwai_user_posts≈ 285 tokens
Kwai profile posts — caption ("" when none), engagement, mp4 + transcript (~1 credit/post). Costs ~20 credits (1/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- url · string · requis
  Kwai profile URL or @handle, e.g. https://www.kwai.com/@topfilmeseseriesnatv. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max posts to return (1–200). Default 20. ~1 credit per post returned (min 2).
- cursor · string · optionnel
  Opaque pagination cursor from the previous nextCursor. Pages within posts from one profile fetch.
Exemple d'appel
```
{"name": "kwai_user_posts", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
linkbio_page≈ 257 tokens
lnk.bio → id, socials{}, titled links[], website/email/whatsapp, other[]. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Linkbio (lnk.bio) page URL or username, e.g. https://lnk.bio/charlidamelio. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.
- cacheMaxAge · string · optionnel
  Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.
Exemple d'appel
```
{"name": "linkbio_page", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
linkedin_ad_library_ad_details≈ 248 tokens
One LinkedIn Ad Library ad by ID. LinkedIn withholds Ran-from / impressions / targeting on most creatives — those keys are omitted, not 404. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  LinkedIn Ad Library URL or numeric ad ID (also accepts urn:li:sponsoredCreative:ID). Inputs that are neither numeric nor an ad-library detail URL are a definitive 400. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "linkedin_ad_library_ad_details", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
linkedin_ad_library_search_ads≈ 608 tokens
LinkedIn publishes run dates, impressions and targeting only on a subset of creatives. Search is the SERP card; source is native|extended. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (12)
Paramètres
- q · string · optionnel
  Advertiser / account owner name (min 2 when used). Provide q/company, keyword, or companyId.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 200). One LinkedIn SERP page is ~25 cards — when limit is higher, further pages are pulled automatically within the request's time budget, so limit=50 fills to 50 when LinkedIn has the ads (hasMore + nextCursor cover the rest). Flat 2 credits per call on the native path; the extended fallback bills ~3.5 credits per returned ad. Response `source` is native or extended so you can see which price applied.
- cursor · string · optionnel
  Pagination token from paginationToken / nextCursor.
- company · string · optionnel
  Alias of q — advertiser / account owner name.
- country · string · optionnel
  Single ISO country code. Default US. Ignored when countries is set. Non-ISO codes are a definitive 400 INVALID_COUNTRY — LinkedIn would otherwise answer an empty result set as if the filter worked.
- endDate · string · optionnel
  Custom range end YYYY-MM-DD (use with startDate).
- keyword · string · optionnel
  Optional keyword filter on ad creative copy. Whole-word hits are ordered first; already-fetched SERP cards without a literal hit fill behind them up to limit (matchedFrom [] = ranked fill).
- companyId · string · optionnel
  LinkedIn numeric company id for exact advertiser match.
- countries · string · optionnel
  Comma-separated ISO country codes (e.g. US,CA,MX). Each code is validated — non-ISO codes are a 400 INVALID_COUNTRY.
- startDate · string · optionnel
  Custom range start YYYY-MM-DD (use with endDate).
- paginationToken · string · optionnel
  Alias of cursor.
Exemple d'appel
```
{"name": "linkedin_ad_library_search_ads", "arguments": {"q": "texte", "cache": true, "limit": 1, "cursor": "texte", "company": "texte", "country": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
linkedin_company≈ 214 tokens
Company page for B2B intel — specialties, similarPages, employeeCount, founded, slogan, cover. Native 1 / enrich 2. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  LinkedIn company URL, e.g. https://www.linkedin.com/company/shopify. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "linkedin_company", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
linkedin_company_posts≈ 337 tokens
The recent posts a company page shows logged-out visitors (about 10), with engagement{likes,comments}. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- url · string · requis
  LinkedIn company URL, e.g. https://linkedin.com/company/slug. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 100). Only the ~10 posts the public page shows are available. Flat 1 credit.
- cursor · string · optionnel
  Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 5). A null nextCursor means the end of the list. Only the recent posts LinkedIn shows logged-out visitors (about 10) are available.
Exemple d'appel
```
{"name": "linkedin_company_posts", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
linkedin_post_details≈ 198 tokens
Get a LinkedIn post — text, author, reactions, and comments count as structured JSON. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  LinkedIn post or activity URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "linkedin_post_details", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
linkedin_post_transcript≈ 200 tokens
LinkedIn post text as a transcript — paragraph segments, timingSource none. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  LinkedIn post or activity URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "linkedin_post_transcript", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
linkedin_profile≈ 214 tokens
Public LinkedIn person profile — what a logged-out visitor sees: name, headline, location, about. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  LinkedIn profile URL, e.g. https://www.linkedin.com/in/paul-martin-a5aa98. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "linkedin_profile", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
linkedin_search_posts≈ 280 tokens
Keyword search of public LinkedIn posts — offset cursor, ceiling 50. Costs ~16 credits (0.8/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (5)
Paramètres
- q · string · requis
  Search query or keywords (min 2 characters).
- sort · string · optionnel
  relevance (default, search-engine rank — dates can span years) or date (found posts newest first).
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 50). Billed per result.
- cursor · string · optionnel
  Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 20). A null nextCursor means the end of the list (max 50 posts).
Exemple d'appel
```
{"name": "linkedin_search_posts", "arguments": {"q": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
linkme_profile≈ 262 tokens
Linkme profile → bio, profileVisitCount, featured links, webLinks, email/infoLinks, stripeStatus. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Linkme profile URL or username, e.g. https://link.me/danucd or danucd. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.
- cacheMaxAge · string · optionnel
  Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.
Exemple d'appel
```
{"name": "linkme_profile", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
linktree_page≈ 260 tokens
Link-in-bio → creator graph: typed links, socialAccounts{} that feed TikTok/Instagram/Spotify/SoundCloud, email, verticals. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Linktree profile URL or username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.
- cacheMaxAge · string · optionnel
  Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.
Exemple d'appel
```
{"name": "linktree_page", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
pillar_page≈ 248 tokens
Pillar link-in-bio → identity, socials{}, links[] with per-link clicks, products[]. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Pillar page URL or username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.
- cacheMaxAge · string · optionnel
  Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.
Exemple d'appel
```
{"name": "pillar_page", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
pinterest_board≈ 328 tokens
Pins on a Pinterest board — saves, imageOriginal, destinationUrl, top-level author. ~0.5 credits/pin. Costs ~13 credits (0.5/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- url · string · requis
  Pinterest board URL (.../username/board-name/), not a /pin/ URL. Example: https://www.pinterest.com/potterybarn/rustic-lodge-lookbook/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 25, max 200). Billed per result.
- cursor · string · optionnel
  Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 25). A null nextCursor means the end of the retrievable window (pidgets ~100).
Exemple d'appel
```
{"name": "pinterest_board", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
pinterest_pin_details≈ 209 tokens
Get a Pinterest pin — title, description, link, board, origin creator, and engagement as structured JSON. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Pinterest pin URL, e.g. https://pinterest.com/pin/ID/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "pinterest_pin_details", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
pinterest_search≈ 239 tokens
Keyword pin search — offset cursor, SERP window 40. Costs ~13 credits (0.5/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- q · string · requis
  Keywords or search query (min 2 characters).
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 25, max 200). Billed per result.
- cursor · string · optionnel
  Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 25). A null nextCursor means the end of the SERP window (max 40).
Exemple d'appel
```
{"name": "pinterest_search", "arguments": {"q": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
pinterest_user_boards≈ 304 tokens
Boards on a Pinterest profile — pinCount, coverImage (474x), privacy, sections. Board followers when scoped. Costs ~13 credits (0.5/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- url · string · requis
  Pinterest profile URL or username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 25, max 200). Billed per result.
- cursor · string · optionnel
  Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 25). A null nextCursor means the end of the retrievable window (max 200).
Exemple d'appel
```
{"name": "pinterest_user_boards", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
pinterest_user_pins≈ 295 tokens
Pins from a Pinterest profile — offset cursor, pidgets window ~100. Costs ~13 credits (0.5/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- url · string · requis
  Pinterest profile URL or username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 25, max 200). Billed per result.
- cursor · string · optionnel
  Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 25). A null nextCursor means the end of the retrievable window (pidgets ~100).
Exemple d'appel
```
{"name": "pinterest_user_pins", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
reddit_post_comments≈ 267 tokens
Flat Reddit comment threads with depth/parentId and the parent post in one call. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- url · string · requis
  Reddit post URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 50, max 500). Flat 2 credits per call.
- cursor · string · optionnel
  Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.
Exemple d'appel
```
{"name": "reddit_post_comments", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
reddit_post_details≈ 208 tokens
Get a Reddit post — title, body, score, comments count, subreddit, and author as structured JSON. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Reddit post URL, e.g. https://reddit.com/r/sub/comments/ID/... The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "reddit_post_details", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
reddit_post_transcript≈ 228 tokens
Written post text — title, body and top comments. Not a speech transcript. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Reddit post URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 50, max 200). Flat 2 credits per call.
Exemple d'appel
```
{"name": "reddit_post_transcript", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
reddit_search≈ 298 tokens
Reddit site-wide post search — sort + timeframe + cursor, score/upvoteRatio, authorFullname. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (6)
Paramètres
- q · string · requis
  Keyword or phrase to search Reddit posts site-wide (min 2 characters).
- sort · string · optionnel
  relevance (default) | new | top | hot | comments (alias: comment_count).
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 25, max 200). Flat 2 credits per call.
- cursor · string · optionnel
  Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.
- timeframe · string · optionnel
  For sort=top or comments: hour | day | week | month | year | all (default all).
Exemple d'appel
```
{"name": "reddit_search", "arguments": {"q": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
reddit_subreddit_details≈ 217 tokens
Subreddit card — id (t5_…), weekly visitors and contributions, rules[], ISO createdAt. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Subreddit URL, r/name, or bare name (case-insensitive), e.g. r/technology or AskReddit. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "reddit_subreddit_details", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
reddit_subreddit_posts≈ 340 tokens
List posts from a subreddit with sort, timeframe, and cursor pagination — title, score, upvote ratio, flair, and more. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (6)
Paramètres
- url · string · requis
  Subreddit URL, r/name, or bare name, e.g. r/technology. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- sort · string · optionnel
  Feed sort: best, hot, new (default), top, or rising.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 25, max 200). Flat 2 credits per call.
- cursor · string · optionnel
  Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.
- timeframe · string · optionnel
  For sort=top: hour, day (default), week, month, year, or all.
Exemple d'appel
```
{"name": "reddit_subreddit_posts", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
reddit_subreddit_search≈ 372 tokens
Search posts inside one subreddit — not subreddit discovery. Same sort/timeframe as site-wide Search. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (7)
Paramètres
- q · string · requis
  Keywords or search query (min 2 characters).
- url · string · requis
  Subreddit URL, r/name, or bare name, e.g. r/technology. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- sort · string · optionnel
  relevance (default) | new | top | hot | comments (alias: comment_count).
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 25, max 200). Flat 2 credits per call.
- cursor · string · optionnel
  Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.
- timeframe · string · optionnel
  For sort=top or comments: hour | day | week | month | year | all (default all).
Exemple d'appel
```
{"name": "reddit_subreddit_search", "arguments": {"q": "texte", "url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
rumble_channel_videos≈ 239 tokens
Rumble channel uploads — lean streams[{url,type}]; call video-details for rendition meta. Costs ~12 credits (0.6/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Rumble channel URL, e.g. https://rumble.com/c/name. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 200). Billed per result.
Exemple d'appel
```
{"name": "rumble_channel_videos", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
rumble_comments≈ 238 tokens
Rumble top-level comments — publishedAt ISO-8601 UTC from title= on the comment time link. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Rumble video URL, e.g. https://rumble.com/vXXXX-title.html. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 50, max 500). Flat 2 credits per call.
Exemple d'appel
```
{"name": "rumble_comments", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
rumble_search≈ 192 tokens
Rumble keyword search — same video card shape as channel-videos (type, durationSeconds + durationText, UTC publishedAt). Costs ~12 credits (0.6/result). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- q · string · requis
  Keywords or search query (min 2 characters).
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 200). Billed per result.
Exemple d'appel
```
{"name": "rumble_search", "arguments": {"q": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
rumble_video_details≈ 206 tokens
Rumble video metadata — uniform streams[] with rendition meta, captions[], audioStreams. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Rumble video URL, e.g. https://rumble.com/vXXXX-title.html. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "rumble_video_details", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
rumble_video_transcript≈ 242 tokens
Rumble published captions as timed segments — parses the .vtt from video-details (not speech-to-text). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Rumble video URL, e.g. https://rumble.com/vXXXX-title.html. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- language · string · optionnel
  Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.
Exemple d'appel
```
{"name": "rumble_video_transcript", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
snapchat_user_profile≈ 202 tokens
Snapchat profile — stable identity card, millisecond timestamps, mediaType image/video (1 credit). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Snapchat username or profile URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "snapchat_user_profile", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
soundcloud_artist≈ 250 tokens
SoundCloud artist — handle + name, subscriptionTier, externalLinks, verified (1 credit). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  SoundCloud artist profile URL or username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.
- cacheMaxAge · string · optionnel
  Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.
Exemple d'appel
```
{"name": "soundcloud_artist", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
soundcloud_artist_tracks≈ 279 tokens
Artist track list — opaque cursor, native-window when the api-v2 page ends (2 credits; empty is 0). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- url · string · requis
  SoundCloud artist profile URL or username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 100). Flat 2 credits per call.
- cursor · string · optionnel
  Opaque pagination cursor from the previous nextCursor. Leave empty for the first page. Do not edit or invent values.
Exemple d'appel
```
{"name": "soundcloud_artist_tracks", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
soundcloud_track≈ 248 tokens
SoundCloud track — plays/likes/license, tags[], nested artist{}, streamUrl when streamable (1 credit). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  SoundCloud track URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.
- cacheMaxAge · string · optionnel
  Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.
Exemple d'appel
```
{"name": "soundcloud_track", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
spotify_album≈ 239 tokens
Spotify album — tracks[] with playCount, joinable artists[], releaseDate, explicit (1 credit). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- raw · boolean · optionnel
  Include the upstream GraphQL payload as data.raw. Default false — omit unless you need fields not in the normalized shape.
- url · string · requis
  Spotify URL, URI, or ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "spotify_album", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
spotify_artist≈ 257 tokens
Spotify artist — followers, monthlyListeners, worldRank, topCities, topTracks with playCount, concerts, and related artists (1 credit). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- raw · boolean · optionnel
  Include the upstream GraphQL payload as data.raw. Default false — omit unless you need fields not in the normalized shape (~80% of the old response body).
- url · string · requis
  Spotify URL, URI, or ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "spotify_artist", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
spotify_podcast≈ 170 tokens
Spotify podcast show — publisher, rating, topics, explicit flag, and totalEpisodes as clean JSON. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Spotify show/podcast URL, URI, or ID (e.g. https://open.spotify.com/show/…). Not an artist URL.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "spotify_podcast", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
spotify_podcast_episodes≈ 292 tokens
Podcast episode archive — previewUrl, releaseDate, explicit, cursor pagination (flat 2 credits). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (5)
Paramètres
- raw · boolean · optionnel
  Include slimmed per-episode upstream payload as episodes[].raw. Default false. visualIdentity / playedState / podcastV2 are never included.
- url · string · requis
  Spotify show/podcast URL, URI, or ID (e.g. https://open.spotify.com/show/…). Not an artist URL.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 50). Flat 2 credits per call.
- cursor · string · optionnel
  Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response.
Exemple d'appel
```
{"name": "spotify_podcast_episodes", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
spotify_search≈ 249 tokens
Search Spotify — canonical spotify: URIs, explicit, fetchedAt (flat 2 credits). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (5)
Paramètres
- q · string · requis
  Search term (min 2 chars).
- raw · boolean · optionnel
  Include per-result upstream payload as results[].raw. Default false. Pathfinder GraphQL vs fallback-path shapes differ — see FAQ.
- type · string · optionnel
  Result kind: tracks (default), albums, artists, podcasts, or episodes.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 50). Flat 2 credits per call.
Exemple d'appel
```
{"name": "spotify_search", "arguments": {"q": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
spotify_track≈ 234 tokens
Spotify track — playCount, joinable artists[]/album{}, explicit, releaseDate (1 credit). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- raw · boolean · optionnel
  Include the upstream GraphQL payload as data.raw. Default false — getTrack embeds bulky artist discography.
- url · string · requis
  Spotify URL, URI, or ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "spotify_track", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
threads_post_details≈ 210 tokens
Threads post — engagement (views when exposed), comments[], relatedPosts[], threadId/isReply. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Threads post URL, e.g. https://threads.net/@user/post/CODE. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "threads_post_details", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
threads_profile≈ 222 tokens
Threads profile — displayName, private/isPrivate, bioLinks (Meta verified), isThreadsOnlyUser, transparencyLabel, bioFragments, HD avatars (1 credit). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  Threads profile URL or @handle, e.g. https://threads.net/@username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "threads_profile", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
threads_search≈ 254 tokens
Threads keyword search — posts with engagement + media. orderBy relevant | post_dated | engagement. Flat 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- q · string · requis
  Keyword or phrase to search public Threads posts (min 2 characters).
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 25, max 200). Flat 2 credits per call.
- orderBy · string · optionnel
  Sort the fetched page: relevant (default, Meta Top / similar to query), post_dated (newest publishedAt first), or engagement (likes+replies+reposts+quotes+views). Unknown values are 400.
Exemple d'appel
```
{"name": "threads_search", "arguments": {"q": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
threads_search_users≈ 188 tokens
Threads user discovery from keyword search — id, handle, avatar, verified. Flat 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- q · string · requis
  Keyword to find Threads users / creators (min 2 characters).
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 100). Flat 1 credit per call.
Exemple d'appel
```
{"name": "threads_search_users", "arguments": {"q": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
threads_user_posts≈ 286 tokens
Recent Threads posts — engagement{views,likes,replies,reposts,quotes}, threadId/isReply. Flat 2 credits. source + stages/ms. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  Threads profile URL or @handle. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 100). Threads exposes only a short window of recent public posts on this surface. limit caps what you receive; it cannot increase what Threads returns. Flat 2 credits on every successful path (native and extended).
Exemple d'appel
```
{"name": "threads_user_posts", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
tiktok_ad_library_ad_details≈ 314 tokens
One TikTok Commercial Content Library ad by ID — calendar-day dates, always 2 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (3)
Paramètres
- url · string · requis
  TikTok Ad Library URL or numeric ad ID. Inputs with no extractable numeric ID are a definitive 400. An ID TikTok's library positively reports as nonexistent is a definitive 404 AD_NOT_FOUND (ads outside the EU/EEA+UK+CH never enter the library, and entries expire one year after last impression). The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- country · string · optionnel
  Two-letter ISO country code. Default GB. Only EU/EEA + UK + CH are covered by TikTok's library; other codes return 400 UNSUPPORTED_REGION.
Exemple d'appel
```
{"name": "tiktok_ad_library_ad_details", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
tiktok_ad_library_search≈ 371 tokens
Search TikTok Commercial Content Library — relevance-filtered, uniform null schema (2 credits native, 5 via fallback). Costs 2 credits (5 via fallback path). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (5)
Paramètres
- q · string · requis
  Keyword or advertiser to search TikTok Commercial Content Library (min 2 characters).
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 200). Does not change the price: 2 credits native, 5 via the fallback path, 0 when empty.
- match · string · optionnel
  Keyword token mode: "any" (default, OR whole-word) or "all" (AND). hair ≠ wheelchair. Literal hits lead; already-fetched SERP ads fill behind them up to limit (matchedFrom [] = ranked fill). Empty results are free.
- country · string · optionnel
  Two-letter ISO country code (e.g. GB, DE, FR). Default GB. TikTok's Commercial Content Library only covers the EU/EEA, the UK and Switzerland (32 countries) — other codes (US, SA, …) return 400 UNSUPPORTED_REGION with the supported list; TikTok has no ad-library data for them.
Exemple d'appel
```
{"name": "tiktok_ad_library_search", "arguments": {"q": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
tiktok_ad_library_top_ads≈ 630 tokens
TikTok Creative Center Top Ads — one ~20-row leaderboard page, not a library search (flat 2; ~1/ad on the fallback path). Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (10)
Paramètres
- q · string · optionnel
  Optional keyword that ranks the one ~20-row leaderboard page — not a library search. Case-insensitive whole-word hits on title/brandName/industry/objective (hair ≠ wheelchair) come first; the rest of TikTok's keyword-ranked page follows as fill (matchedFrom [] on those ads, rankedFill in the envelope). There is no tags field. advertiser.name is often null in the default US market. Envelope candidatesScanned is the pre-filter pool size. For a known advertiser, use /tiktok/ad-details by ad id.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 20, max 20). One Creative Center leaderboard page is ~20 rows; limit only trims that pool — it cannot scan more candidates. Flat 2 credits on the native path; the fallback path ~1 credit per returned ad (min 2).
- match · string · optionnel
  Keyword token mode: "any" (default, OR) or "all" (AND). Zero whole-word hits still return TikTok's keyword-ranked page as matchBasis=ranked (literalMatches=0).
- period · integer · optionnel
  Lookback window in days: 7, 30, or 180. Default 30.
- country · string · optionnel
  Two-letter ISO country code. Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY (Creative Center used to quietly return an empty leaderboard for them).
- orderBy · string · optionnel
  Sort: for_you, likes, ctr, impressions, or cost. Default for_you.
- adFormat · string · optionnel
  Optional format filter: spark or non_spark. Served only by the extended fetcher — while it is disabled, adFormat returns 503 filter_unavailable (retryable false, not billed). Omit adFormat for the native leaderboard.
- industry · string · optionnel
  Optional industry key or label from Creative Center.
- objective · string · optionnel
  Optional campaign objective (e.g. Traffic, Conversion, Reach).
Exemple d'appel
```
{"name": "tiktok_ad_library_top_ads", "arguments": {"q": "texte", "cache": true, "limit": 1, "match": "texte", "period": 1, "country": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
tiktok_audience_demographics≈ 316 tokens
Audience country + language mix for a TikTok creator — engagement sample, not a follower census. Costs 3 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- url · string · requis
  TikTok profile URL, @handle, or username, e.g. https://tiktok.com/@username. Not a YouTube channel URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- videos · integer · optionnel
  How many recent videos to sample comments from: 12 (default, 3 credits), 30 (5 credits), or 60 (8 credits).
- countriesLimit · integer · optionnel
  Max countries in audienceLocations; remainder folds into other{count,percentage}. Omit for the full list (other is omitted when unused).
Exemple d'appel
```
{"name": "tiktok_audience_demographics", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
tiktok_channel_details≈ 318 tokens
Resolve a TikTok @handle to id + secUid — createTime, ttSeller, bioLink, decoded privacy flags. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- raw · boolean · optionnel
  Set true to include TikTok's upstream user/statsV2 blob under raw, plus createTimeUnix (unix twin of createTime). Default false — curated fields only.
- url · string · requis
  TikTok profile URL, @handle, or username, e.g. https://tiktok.com/@username. Not a YouTube channel URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control.
- cacheMaxAge · string · optionnel
  Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL.
Exemple d'appel
```
{"name": "tiktok_channel_details", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
tiktok_channel_posts≈ 382 tokens
Latest videos from a TikTok profile. May return a labelled 6h-stale snapshot (degraded + staleAgeMs) when the live list is blocked. Failures are 0 credits. Costs 2 credits (fallback: 1 per 20 posts, min 2). Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- url · string · requis
  TikTok profile URL, @handle, or username, e.g. https://tiktok.com/@username. Not a YouTube channel URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  How many of the creator's latest videos to return on this page (default 20, max 200). Newest first. Native serves cost a flat 2 credits; extended serves scale with returned posts — 1 credit per 20, minimum 2 (200 posts = 10 credits).
- cursor · string · optionnel
  Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (TikTok's max_cursor timestamp, e.g. 1783614676000). A null nextCursor means the end of the list.
Exemple d'appel
```
{"name": "tiktok_channel_posts", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
tiktok_comment_replies≈ 342 tokens
Replies under a TikTok comment — same authorId/authorSecUid/commentLanguage shape as comments. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (5)
Paramètres
- url · string · requis
  Public TikTok video URL, e.g. https://www.tiktok.com/@khaby.lame/video/7646812028874673439. Not a YouTube/Instagram/Facebook URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 50, max 500). Flat 2 credits per call.
- cursor · string · optionnel
  Pagination cursor. Leave empty for the first page; then pass the nextCursor value from the previous response.
- commentId · string · requis
  ID of the parent (top-level) comment to fetch replies for — from the comments endpoint. Legacy alias: comment_id.
Exemple d'appel
```
{"name": "tiktok_comment_replies", "arguments": {"url": "texte", "commentId": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
tiktok_comments≈ 333 tokens
TikTok comments — clean schema plus authorName, stable authorId/authorSecUid and commentLanguage for listening loops. Unresolvable videos are 404 at 0 credits. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (4)
Paramètres
- url · string · requis
  Public TikTok video URL, e.g. https://www.tiktok.com/@khaby.lame/video/7646812028874673439. Not a YouTube/Instagram/Facebook URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
- limit · integer · optionnel
  Max items to return (default 50, max 500). Flat 2 credits per call.
- cursor · string · optionnel
  Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (a numeric offset, e.g. 50). A null nextCursor means the end of the comments.
Exemple d'appel
```
{"name": "tiktok_comments", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
tiktok_live≈ 231 tokens
Check whether a TikTok creator is live right now and get the stream URLs (CMAF/DASH + FLV, HLS when TikTok exposes it) — one GET with an @handle, 1 credit. Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  TikTok profile URL, @handle, or username, e.g. https://tiktok.com/@username. Not a YouTube channel URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "tiktok_live", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```
tiktok_live_info≈ 213 tokens
Identical to TikTok Live (isLive, creator.id/secUid, streamQualities hls/cmaf). Costs 1 credit. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Paramètres, retour & exemple (2)
Paramètres
- url · string · requis
  TikTok profile URL, @handle, or username, e.g. https://tiktok.com/@username. Not a YouTube channel URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
- cache · boolean · optionnel
  Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Exemple d'appel
```
{"name": "tiktok_live_info", "arguments": {"url": "texte"}}
```
Exemple de retour
```
{"content": [{"type": "text", "text": "…"}]}
```

+ 58 autres outils (affichage limité à 120).

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://api.captapi.com/mcp