@captapi/sdk 0.2.0 → 0.3.0

package/dist/generated.js

@@ -13,7 +13,7 @@ export class YoutubeApi {
     audioTranscript(params) {
         return this.core.get("/v1/youtube/audio-transcript", params);
     }
-    /** YouTube Summarizer — GPT summary from YouTube's published captions — same source as /transcript. Flat 3 credits; caption-miss 404 is free. (3 credits) */
+    /** YouTube Summarizer — AI summary from YouTube's published captions — same source as /transcript. Flat 3 credits; caption-miss 404 is free. (3 credits) */
     summarize(params) {
         return this.core.get("/v1/youtube/summarize", params);
     }
@@ -21,7 +21,7 @@ export class YoutubeApi {
     videoDetails(params) {
         return this.core.get("/v1/youtube/video-details", params);
     }
-    /** YouTube Comments — Get comments on any YouTube video — text, author, likes, and truncated publishedTimeApprox from the relative label, with cursor pagination (nextCursor + hasMore). Flat 2 credits per call. (2 credits) */
+    /** YouTube Comments — Get comments on any YouTube video — text, author, likes, and truncated publishedTimeApprox from the relative label, with cursor pagination (nextCursor + hasMore). Flat 2 credits per call; 0 when the video has comments turned off (commentsDisabled: true). (2 credits) */
     comments(params) {
         return this.core.get("/v1/youtube/comments", params);
     }
@@ -29,7 +29,7 @@ export class YoutubeApi {
     channelDetails(params) {
         return this.core.get("/v1/youtube/channel-details", params);
     }
-    /** YouTube Search — YouTube search with cursor pagination — typed hits, ids, canonical URLs, filters (2 credits/page). (2 credits) */
+    /** YouTube Search — YouTube search with cursor pagination — typed hits, ids, canonical URLs, filters (2 credits/page, 0 when a page finds nothing). (2 credits) */
     search(params) {
         return this.core.get("/v1/youtube/search", params);
     }
@@ -73,7 +73,7 @@ export class YoutubeApi {
     channelStreams(params) {
         return this.core.get("/v1/youtube/channel-streams", params);
     }
-    /** YouTube Hashtag Search — Videos from youtube.com/hashtag/{name} — nested channel{}, viewCountIsApproximate. Not keyword search. (~20 credits (1/result)) */
+    /** YouTube Hashtag Search — Videos from youtube.com/hashtag/{name} — nested channel{}, viewCountIsApproximate. Not keyword search. (~10 credits (1/result)) */
     hashtagSearch(params) {
         return this.core.get("/v1/youtube/hashtag-search", params);
     }
@@ -135,7 +135,7 @@ export class TiktokApi {
     searchSuggestions(params) {
         return this.core.get("/v1/tiktok/search-suggestions", params);
     }
-    /** TikTok Channel Posts — 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. (2 credits) */
+    /** TikTok Channel Posts — Latest videos from a TikTok profile, cursor-paginated, with isPinned, caption mention text and brand signals (promoCodes, brandMentions). Flat 2 credits; failures are 0 credits. (2 credits) */
     channelPosts(params) {
         return this.core.get("/v1/tiktok/channel-posts", params);
     }
@@ -159,15 +159,15 @@ export class TiktokApi {
     topSearch(params) {
         return this.core.get("/v1/tiktok/top-search", params);
     }
-    /** TikTok Search by Hashtag — Videos from TikTok's /tag/{name} challenge feed — not keyword or username search. Cursor + hasMore. (~14 credits (0.7/result)) */
+    /** TikTok Search by Hashtag — Videos from TikTok's /tag/{name} challenge feed — not keyword or username search. Cursor + hasMore. (~7 credits (0.7/result)) */
     searchByHashtag(params) {
         return this.core.get("/v1/tiktok/search/hashtag", params);
     }
-    /** TikTok Search Users — Search TikTok users — distinct creators only, id + secUid, per-counter isApproximate flags, cursor pagination. (1 credit) */
+    /** TikTok Search Users — Find TikTok creators by keyword — distinct authors ranking for the query, id + secUid, per-counter isApproximate flags, cursor pagination. (1 credit) */
     searchUsers(params) {
         return this.core.get("/v1/tiktok/search/users", params);
     }
-    /** TikTok Song Details — TikTok sound metadata — usageCount, artists[{id,secUid,handle}], audio{bpm,loudness,beats}, commerce rights (1 credit native). (1 credit) */
+    /** TikTok Song Details — TikTok sound metadata — usageCount, artists[{id,secUid,handle}], audio{bpm,loudness,beats}, commerce rights (1 credit; 2 via the fallback path). (1 credit (2 via fallback path)) */
     songDetails(params) {
         return this.core.get("/v1/tiktok/song-details", params);
     }
@@ -175,19 +175,15 @@ export class TiktokApi {
     trendingFeed(params = {}) {
         return this.core.get("/v1/tiktok/trending-feed", params);
     }
-    /** TikTok Popular Hashtags — TikTok Creative Center hashtag chart — real videoCount/totalPlays, plus rankDiff and trend[] on that path. Flat 2 credits. (2 credits) */
+    /** TikTok Popular Hashtags — Related TikTok hashtags — Creative Center chart when it answers (asOf = the chart's data date, stale when over 3 days old), otherwise a disclosed niche fallback. Flat 2 credits. (2 credits) */
     popularHashtags(params = {}) {
         return this.core.get("/v1/tiktok/popular-hashtags", params);
     }
-    /** TikTok Popular Songs — Creative Center popular/surging sounds — rankDiff, trend[], commercialMusic. 110s deadline, 0 credits on 502. (2 credits) */
-    popularSongs(params = {}) {
-        return this.core.get("/v1/tiktok/popular-songs", params);
-    }
-    /** TikTok Live — Is this TikTok creator live — isLive/status, creator.id/secUid, room, streamQualities with flv/hls/cmaf/dash. (1 credit) */
+    /** TikTok Live — 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. (1 credit) */
     live(params) {
         return this.core.get("/v1/tiktok/live", params);
     }
-    /** TikTok Live Info — Identical to TikTok Live (isLive, creator.id/secUid, streamQualities hls/cmaf). (7 credits) */
+    /** TikTok Live Info — Identical to TikTok Live (isLive, creator.id/secUid, streamQualities hls/cmaf). (1 credit) */
     liveInfo(params) {
         return this.core.get("/v1/tiktok/live-info", params);
     }
@@ -209,11 +205,11 @@ export class InstagramApi {
     summarize(params) {
         return this.core.get("/v1/instagram/summarize", params);
     }
-    /** Instagram Post Details — Get an Instagram post, Reel or carousel — caption, likes, comments, views, media URLs, author, and per-slide children on carousels. (1 credit) */
+    /** Instagram Post & Reel Details — Get an Instagram post, Reel or carousel — caption, publish date, likes, comments, views, media URLs, author, per-slide children, and promo codes / disclosure words from the caption. (1 credit) */
     details(params) {
         return this.core.get("/v1/instagram/details", params);
     }
-    /** Instagram Post Comments — Get the comments on any Instagram post or Reel — text, author, avatar, likes, and timestamp for each comment. (~45 credits (0.9/result)) */
+    /** Instagram Post Comments — Session-paged Instagram comments — a logged-out 2-row preview of a larger thread is 503 SESSION_UNAVAILABLE at 0 credits. (~9 credits (0.9/result)) */
     comments(params) {
         return this.core.get("/v1/instagram/comments", params);
     }
@@ -221,19 +217,19 @@ export class InstagramApi {
     channelDetails(params) {
         return this.core.get("/v1/instagram/channel-details", params);
     }
-    /** Instagram Channel Posts — Latest posts from a public Instagram profile — carousel children[], mediaCount, user{} in one call. (~6 credits (0.3/result)) */
+    /** Instagram Channel Posts — Latest posts from a public Instagram profile — carousel children[], mediaCount, isPinned, caption promo codes, user{} in one call. (~3 credits (0.3/result)) */
     channelPosts(params) {
         return this.core.get("/v1/instagram/channel-posts", params);
     }
-    /** Instagram Channel Reels — Latest Reels from a public Instagram profile — pass userId to skip resolve; ceil(n×0.3) credits; nextCursor + hasMore. (~6 credits (0.3/result)) */
+    /** Instagram Channel Reels — Latest Reels from a public Instagram profile — isPinned, optional since date filter, pass userId to skip resolve; ceil(n×0.3) credits; nextCursor + hasMore. (~3 credits (0.3/result)) */
     channelReels(params = {}) {
         return this.core.get("/v1/instagram/channel-reels", params);
     }
-    /** Instagram Reels Search — Native Instagram Reels hashtag search — engagement.views + viewsSource, location, commercial flags. Flat 2 credits. (2 credits) */
+    /** Instagram Reels Search — Native tag feed first, slower fallback paths on a miss. Max 50. Flat 2 credits. (2 credits) */
     reelsSearch(params) {
         return this.core.get("/v1/instagram/reels-search", params);
     }
-    /** Instagram Trending Reels — Cache-first trending Reels — flat 2 credits every call (4h TTL). (2 credits) */
+    /** Instagram Trending Reels — Cache-first trending Reels. Feed outage → labelled country hashtag-clips stand-in (listing field), never a silent swap. Max 50. Flat 2 credits. (2 credits) */
     trendingReels(params = {}) {
         return this.core.get("/v1/instagram/trending-reels", params);
     }
@@ -241,15 +237,15 @@ export class InstagramApi {
     taggedPosts(params) {
         return this.core.get("/v1/instagram/tagged-posts", params);
     }
-    /** Instagram Reels By Audio ID — Is this Instagram sound trending? Reels that use it + isTrendingInClips / trendRank / rich music{}. (~28 credits (1.4/result)) */
+    /** Instagram Reels By Audio ID — Is this Instagram sound trending? Reels that use it + isTrendingInClips / trendRank / rich music{}. (~14 credits (1.4/result)) */
     reelsByAudioId(params) {
         return this.core.get("/v1/instagram/reels-by-audio-id", params);
     }
-    /** Instagram Hashtag Search — Native Instagram hashtag Explore — Reels-heavy top surface with real likes, views, captions, and paid flags. Flat 2 credits. (2 credits) */
+    /** Instagram Hashtag Search — Hashtag Explore: native grid first, fallback path only on miss. Max 50. Flat 2 credits. (2 credits) */
     hashtagSearch(params) {
         return this.core.get("/v1/instagram/hashtag-search", params);
     }
-    /** Instagram Profile Search — Resolve a brand or @handle to one public Instagram profile — stable id, bio, links, and stats (not niche discovery). (1 credit) */
+    /** Instagram Profile Search — Resolve a brand or @handle to one public Instagram profile — or search accounts by free text (mode=search). (1 credit) */
     profileSearch(params) {
         return this.core.get("/v1/instagram/profile-search", params);
     }
@@ -275,7 +271,7 @@ export class FacebookApi {
     constructor(core) {
         this.core = core;
     }
-    /** Facebook Details — Facebook post or Reel — caption, engagement, author id, video{} playback, and music when Facebook exposes them. (2 credits) */
+    /** Facebook Post & Reel Details — Facebook post or Reel — caption, engagement, author id, video{} playback, and music when Facebook exposes them. (2 credits) */
     details(params) {
         return this.core.get("/v1/facebook/details", params);
     }
@@ -299,7 +295,7 @@ export class FacebookApi {
     profileReels(params) {
         return this.core.get("/v1/facebook/profile-reels", params);
     }
-    /** Facebook Group Posts — Public Facebook group posts — listingHits / hydrateFailures / hydrateSkipped, sortBy, and per-count *IsApproximate. (2 credits) */
+    /** Facebook Group Posts — Newest posts from a public Facebook group — caption, author, engagement, sortBy; 1 credit per post. (~10 credits (1/result)) */
     groupPosts(params) {
         return this.core.get("/v1/facebook/group-posts", params);
     }
@@ -321,7 +317,7 @@ export class TwitterApi {
     tweetDetails(params) {
         return this.core.get("/v1/twitter/tweet-details", params);
     }
-    /** Twitter/X Transcript — Tweet text as a transcript — timingSource none (not Whisper). Flat 1 credit. (1 credit) */
+    /** Twitter/X Transcript — Tweet text as a transcript — timingSource none (not speech-to-text). Flat 1 credit. (1 credit) */
     transcript(params) {
         return this.core.get("/v1/twitter/transcript", params);
     }
@@ -355,7 +351,7 @@ export class RedditApi {
     postDetails(params) {
         return this.core.get("/v1/reddit/post-details", params);
     }
-    /** Reddit Post Comments — Flat Reddit comment threads with depth/parentId, cursor pagination, and the parent post in one call. (2 credits) */
+    /** Reddit Post Comments — Flat Reddit comment threads with depth/parentId and the parent post in one call. (2 credits) */
     postComments(params) {
         return this.core.get("/v1/reddit/post-comments", params);
     }
@@ -367,7 +363,7 @@ export class RedditApi {
     search(params) {
         return this.core.get("/v1/reddit/search", params);
     }
-    /** Reddit Subreddit Details — Subreddit card — id (t5_…), members, activeUsers, rules[], ISO createdAt, nsfw/type. Flat 1 credit. (1 credit) */
+    /** Reddit Subreddit Details — Subreddit card — id (t5_…), weekly visitors and contributions, rules[], ISO createdAt. Flat 1 credit. (1 credit) */
     subredditDetails(params) {
         return this.core.get("/v1/reddit/subreddit-details", params);
     }
@@ -381,19 +377,19 @@ export class ThreadsApi {
     constructor(core) {
         this.core = core;
     }
-    /** Threads Profile — Threads profile — displayName, private/isPrivate, bioLinks (Meta verified), isThreadsOnlyUser, transparencyLabel, bioFragments, HD avatars (1 credit). (1 credit) */
+    /** Threads Profile — Threads profile — displayName, isPrivate, bioLinks (Meta verified), isThreadsOnlyUser, transparencyLabel, bioFragments, HD avatars (1 credit). (1 credit) */
     profile(params) {
         return this.core.get("/v1/threads/profile", params);
     }
-    /** Threads User Posts — Recent Threads posts — engagement{views,likes,replies,reposts,quotes}, threadId/isReply. Flat 2 credits. (2 credits) */
+    /** Threads User Posts — Recent Threads posts — engagement{views,likes,replies,reposts,quotes}, threadId/isReply. Flat 2 credits. source + timings. (2 credits) */
     userPosts(params) {
         return this.core.get("/v1/threads/user-posts", params);
     }
-    /** Threads Post Details — Threads post — engagement (views when exposed), comments[], relatedPosts[], threadId/isReply. Flat 1 credit. (1 credit) */
+    /** Threads Post Details — Threads post — engagement (views when exposed), comments[], suggestedPosts[], threadId/isReply. Flat 1 credit. (1 credit) */
     postDetails(params) {
         return this.core.get("/v1/threads/post-details", params);
     }
-    /** Threads Post Search — Threads keyword search — posts with engagement + media. Flat 2 credits. (2 credits) */
+    /** Threads Post Search — Threads keyword search — posts with engagement + media. orderBy relevant | post_dated | engagement. Flat 2 credits. (2 credits) */
     search(params) {
         return this.core.get("/v1/threads/search", params);
     }
@@ -411,7 +407,7 @@ export class BlueskyApi {
     profile(params) {
         return this.core.get("/v1/bluesky/profile", params);
     }
-    /** Bluesky User Posts — Author feed — posts and reposts (isRepost marked), quote/external/images embeds, opaque cursor. (~3 credits (0.1/result)) */
+    /** Bluesky User Posts — Author feed — posts and reposts (isRepost marked), quote/external/images embeds, opaque cursor. (~1 credits (0.1/result)) */
     userPosts(params) {
         return this.core.get("/v1/bluesky/user-posts", params);
     }
@@ -429,19 +425,19 @@ export class PinterestApi {
     pinDetails(params) {
         return this.core.get("/v1/pinterest/pin-details", params);
     }
-    /** Pinterest User Pins — Pins from a Pinterest profile — offset cursor, pidgets window ~100. (~13 credits (0.5/result)) */
+    /** Pinterest User Pins — Pins from a Pinterest profile — offset cursor, pidgets window ~100. (~5 credits (0.5/result)) */
     userPins(params) {
         return this.core.get("/v1/pinterest/user-pins", params);
     }
-    /** Pinterest Search — Keyword pin search — offset cursor, SERP window 40. (~13 credits (0.5/result)) */
+    /** Pinterest Search — Keyword pin search — offset cursor, search window 40, flat 2 credits. (2 credits) */
     search(params) {
         return this.core.get("/v1/pinterest/search", params);
     }
-    /** Pinterest Board — Pins on a Pinterest board — saves, imageOriginal, destinationUrl, top-level author. ~0.5 credits/pin. (~13 credits (0.5/result)) */
+    /** Pinterest Board — Pins on a Pinterest board — saves, imageOriginal, destinationUrl, top-level author. ~0.5 credits/pin. (~5 credits (0.5/result)) */
     board(params) {
         return this.core.get("/v1/pinterest/board", params);
     }
-    /** Pinterest User Boards — Boards on a Pinterest profile — pinCount, coverImage (474x), privacy, sections. Board followers when scoped. (~13 credits (0.5/result)) */
+    /** Pinterest User Boards — Boards on a Pinterest profile — pinCount, coverImage (474x), privacy, sections. Board followers when scoped. (~5 credits (0.5/result)) */
     userBoards(params) {
         return this.core.get("/v1/pinterest/user-boards", params);
     }
@@ -451,15 +447,15 @@ export class LinkedinApi {
     constructor(core) {
         this.core = core;
     }
-    /** LinkedIn Profile — LinkedIn person profile with experience[], education[], similarProfiles[] — masked guest text becomes restricted:true. (2 credits) */
+    /** LinkedIn Profile — Public LinkedIn person profile — what a logged-out visitor sees: name, headline, location, about. Flat 1 credit. (1 credit) */
     profile(params) {
         return this.core.get("/v1/linkedin/profile", params);
     }
-    /** LinkedIn Company — Company page for B2B intel — specialties, similarPages, employeeCount, founded, slogan, cover. Native 1 / enrich 2. (2 credits) */
+    /** LinkedIn Company — Company page for B2B intel — specialties, similarPages, employeeCount, founded, slogan, cover. Flat 2 credits. (2 credits) */
     company(params) {
         return this.core.get("/v1/linkedin/company", params);
     }
-    /** LinkedIn Post Details — Get a LinkedIn post — text, author, reactions, and comments count as structured JSON. (1 credit) */
+    /** LinkedIn Post Details — Get a LinkedIn post — text, author, reactions, and comments count as structured JSON. When LinkedIn hides the post behind its sign-in prompt the call fails with 502 at 0 credits. (1 credit) */
     postDetails(params) {
         return this.core.get("/v1/linkedin/post-details", params);
     }
@@ -467,11 +463,11 @@ export class LinkedinApi {
     postTranscript(params) {
         return this.core.get("/v1/linkedin/post-transcript", params);
     }
-    /** LinkedIn Company Posts — Company posts with engagement{likes,comments} — cursor pages up to 100. Flat 1 credit on the native path. (1 credit) */
+    /** LinkedIn Company Posts — The recent posts a company page shows logged-out visitors (about 10), with engagement{likes,comments}. Flat 1 credit. (1 credit) */
     companyPosts(params) {
         return this.core.get("/v1/linkedin/company-posts", params);
     }
-    /** LinkedIn Search Posts — Keyword search of public LinkedIn posts — offset cursor, ceiling 50. (~16 credits (0.8/result)) */
+    /** LinkedIn Search Posts — Keyword search of public LinkedIn posts — offset cursor, ceiling 50. (~8 credits (0.8/result)) */
     searchPosts(params) {
         return this.core.get("/v1/linkedin/search-posts", params);
     }
@@ -489,11 +485,11 @@ export class RumbleApi {
     videoTranscript(params) {
         return this.core.get("/v1/rumble/video/transcript", params);
     }
-    /** Rumble Channel Videos — Rumble channel uploads — lean streams[{url,type}]; call video-details for rendition meta. (~12 credits (0.6/result)) */
+    /** Rumble Channel Videos — Rumble channel uploads — lean streams[{url,type}]; call video-details for rendition meta. (~6 credits (0.6/result)) */
     channelVideos(params) {
         return this.core.get("/v1/rumble/channel-videos", params);
     }
-    /** Rumble Search — Rumble keyword search — same video card shape as channel-videos (type, durationSeconds + durationText, UTC publishedAt). (~12 credits (0.6/result)) */
+    /** Rumble Search — Rumble keyword search — same video card shape as channel-videos (type, durationSeconds + durationText, UTC publishedAt). (~6 credits (0.6/result)) */
     search(params) {
         return this.core.get("/v1/rumble/search", params);
     }
@@ -507,15 +503,15 @@ export class TiktokShopApi {
     constructor(core) {
         this.core = core;
     }
-    /** TikTok Shop Search — TikTok Shop keyword search — priced products with sold, rating/reviews, typed discount, seller id. (2 credits) */
+    /** TikTok Shop Search — TikTok Shop keyword search — priced products with rating/reviews, typed discount, seller id. (2 credits) */
     search(params) {
         return this.core.get("/v1/tiktok-shop/shop-search", params);
     }
-    /** TikTok Shop Products — Store catalog with shopInfo (sold/followers/rating) + products priced with sold, rating, typed discount. (2 credits) */
+    /** TikTok Shop Products — Store catalog with shopInfo (sold/followers/rating) + products priced with sold, rating, typed discount. (2 credits (fallback: 2.8/product, min 2)) */
     products(params) {
         return this.core.get("/v1/tiktok-shop/shop-products", params);
     }
-    /** TikTok Shop Product Details — PDP — price/originalPrice/typed discount, images[], skus[] with per-variant stock + saleProps, seller id/url, categories (2 credits). (2 credits) */
+    /** TikTok Shop Product Details — PDP — price (sku_min when guest min is *), sold vs stock, seller id/url, images[]. Unresolved URL is 404 at 0 credits. (2 credits) */
     productDetails(params) {
         return this.core.get("/v1/tiktok-shop/product-details", params);
     }
@@ -523,7 +519,7 @@ export class TiktokShopApi {
     productReviews(params) {
         return this.core.get("/v1/tiktok-shop/product-reviews", params);
     }
-    /** TikTok Shop User Showcase — Creator Shop showcase — affiliate shelf products with per-product sold, rating, typed discount, and seller name/url. (~45 credits (2.25/result)) */
+    /** TikTok Shop User Showcase — Creator Shop showcase — affiliate shelf products with per-product sold, rating, typed discount, and seller name/url. (~23 credits (2.25/result)) */
     userShowcase(params) {
         return this.core.get("/v1/tiktok-shop/user-showcase", params);
     }
@@ -573,7 +569,7 @@ export class FacebookAdLibraryApi {
     search(params) {
         return this.core.get("/v1/ad-library/facebook/search", params);
     }
-    /** Facebook Company Ads — Company Ads (2 credits) */
+    /** Facebook Company Ads — Ads for one Meta page — active by default, Meta's top-by-impressions order, sort_by and date window, same envelope as /facebook/search. (2 credits) */
     companyAds(params) {
         return this.core.get("/v1/ad-library/facebook/company-ads", params);
     }
@@ -581,11 +577,11 @@ export class FacebookAdLibraryApi {
     searchCompanies(params) {
         return this.core.get("/v1/ad-library/facebook/search-companies", params);
     }
-    /** Facebook Ad Details — One Meta ad by ID — same creative as search, plus delivery breakdowns when Meta publishes them. Flat 2 credits. (2 credits) */
+    /** Facebook Ad Details — One Meta ad by ID — same creative as search, plus EU transparency data for EU-delivered ads. Flat 2 credits. (2 credits) */
     adDetails(params) {
         return this.core.get("/v1/ad-library/facebook/ad-details", params);
     }
-    /** Facebook Ad Copy — Written creative copy from a Meta ad — headline, body, CTA, landing URL. Not a speech transcript. (2 credits) */
+    /** Facebook Ad Transcript — Spoken transcript of a Meta video ad with timed segments — written copy as fallback. (2 credits) */
     adTranscript(params) {
         return this.core.get("/v1/ad-library/facebook/ad-transcript", params);
     }
@@ -595,11 +591,11 @@ export class TiktokAdLibraryApi {
     constructor(core) {
         this.core = core;
     }
-    /** TikTok Ad Library Search — Search TikTok Commercial Content Library — relevance-filtered, uniform null schema (2 credits). (2 credits) */
+    /** TikTok Ad Library Search — Search TikTok Commercial Content Library — relevance-filtered, uniform null schema (2 credits native, 5 via fallback). (2 credits (5 via fallback path)) */
     search(params) {
         return this.core.get("/v1/ad-library/tiktok/search", params);
     }
-    /** TikTok Creative Center Top Ads — TikTok Creative Center Top Ads — one ~20-row leaderboard page, not a library search (flat 2 / ~1 Apify). (2 credits) */
+    /** TikTok Creative Center Top Ads — TikTok Creative Center Top Ads — one ~20-row leaderboard page, not a library search (flat 2; ~1/ad on the fallback path). (2 credits) */
     topAds(params = {}) {
         return this.core.get("/v1/ad-library/tiktok/top-ads", params);
     }
@@ -631,7 +627,7 @@ export class LinkedinAdLibraryApi {
     constructor(core) {
         this.core = core;
     }
-    /** LinkedIn Ad Library Search — LinkedIn publishes run dates, impressions and targeting only on a subset of creatives. Search is the SERP card; source is native|extended. (2 credits) */
+    /** LinkedIn Ad Library Search — LinkedIn publishes run dates, impressions and targeting only on a subset of creatives. Search is the SERP card; source is native. (2 credits) */
     searchAds(params = {}) {
         return this.core.get("/v1/ad-library/linkedin/search-ads", params);
     }
@@ -645,7 +641,7 @@ export class AmazonShopApi {
     constructor(core) {
         this.core = core;
     }
-    /** Amazon Seller Storefront — Third-party seller storefronts (/sp?seller= / /s?me=) — ASIN + canonical /dp URLs, price, badges. Not influencer /shop/{handle}. (1 credit) */
+    /** Amazon Seller Storefront — Third-party seller storefronts (/sp?seller= / /s?me=) — ASIN + canonical /dp URLs, price, badges. Not influencer /shop/{handle}. (1 credit per 16 products (default limit 20 = 2)) */
     page(params) {
         return this.core.get("/v1/amazon-shop/page", params);
     }
@@ -659,15 +655,15 @@ export class GithubApi {
     user(params) {
         return this.core.get("/v1/github/user", params);
     }
-    /** GitHub Repositories — List a user's repos with sort/direction/type — opaque Link cursor (~0.4/repo). (~12 credits (0.4/result)) */
+    /** GitHub Repositories — List a user's repos with sort/direction/type — opaque Link cursor (~0.4/repo). (~4 credits (0.4/result)) */
     repositories(params) {
         return this.core.get("/v1/github/repositories", params);
     }
-    /** GitHub Pull Requests — List repo PRs — draft, labels, author{}, head/base, opaque Link cursor (state echoed). (~12 credits (0.4/result)) */
+    /** GitHub Pull Requests — List repo PRs — draft, labels, author{}, head/base, opaque Link cursor (state echoed). (~4 credits (0.4/result)) */
     pullRequests(params) {
         return this.core.get("/v1/github/pull-requests", params);
     }
-    /** GitHub Activity — Public events with typed payload (Push commits/ref, PR/issue action) — 90-event ceiling. (~12 credits (0.4/result)) */
+    /** GitHub Activity — Public events with typed payload (Push commits/ref, PR/issue action) — 90-event ceiling. (~4 credits (0.4/result)) */
     activity(params) {
         return this.core.get("/v1/github/activity", params);
     }
@@ -781,7 +777,7 @@ export class SnapchatApi {
     constructor(core) {
         this.core = core;
     }
-    /** Snapchat User Profile — Snapchat profile — unwrapped highlight ids, mediaType image/video, category labels, Spotlight boosts (1 credit). (1 credit) */
+    /** Snapchat User Profile — Snapchat profile — stable identity card, millisecond timestamps, mediaType image/video (1 credit). (1 credit) */
     userProfile(params) {
         return this.core.get("/v1/snapchat/user-profile", params);
     }
@@ -791,7 +787,7 @@ export class TruthSocialApi {
     constructor(core) {
         this.core = core;
     }
-    /** Truth Social Profile — Prominent public Truth Social profiles — isPrivate/bot/group, fields[], avatar/banner. Flat 1 credit. (1 credit) */
+    /** Truth Social Profile — Prominent public Truth Social profiles — isPrivate/bot/group, CP-F counts, avatar/banner. Flat 1 credit. (1 credit) */
     profile(params) {
         return this.core.get("/v1/truth-social/profile", params);
     }
@@ -809,7 +805,7 @@ export class KickApi {
     constructor(core) {
         this.core = core;
     }
-    /** Kick Clip — Get a Kick clip — creator vs channel, HLS playback, VOD deep-link, views, and duration as structured JSON. (1 credit) */
+    /** Kick Clip — Get a Kick clip, or a channel's recent clips — 7d clip cache. Flat 1 credit. (1 credit) */
     clip(params) {
         return this.core.get("/v1/kick/clip", params);
     }
@@ -849,11 +845,11 @@ export class UtilitiesApi {
     analyticsCompare(params) {
         return this.core.get("/v1/analytics/compare", params);
     }
-    /** Video File Transcript — Whisper transcription of an uploaded file — 1 credit/min; noSpeech=true and 0 credits when there is no speech. (1 credit/min) */
+    /** Video File Transcript — AI transcription of an uploaded file — 1 credit/min; noSpeech=true and 0 credits when there is no speech. (1 credit/min) */
     videoTranscript(params) {
         return this.core.postMultipart("/v1/video/transcript", params);
     }
-    /** Video File Summarizer — Whisper + AI summary of an uploaded file — transcript included; 1 credit/min + 1. (1 credit/min +1) */
+    /** Video File Summarizer — AI transcription + summary of an uploaded file — transcript included; 1 credit/min + 1. (1 credit/min +1) */
     videoSummarize(params) {
         return this.core.postMultipart("/v1/video/summarize", params);
     }
@@ -867,7 +863,7 @@ export class KwaiApi {
     profile(params) {
         return this.core.get("/v1/kwai/profile", params);
     }
-    /** Kwai User Posts — Kwai profile posts — caption ("" when none), engagement, mp4 + transcript (~1 credit/post). (~20 credits (1/result)) */
+    /** Kwai User Posts — Kwai profile posts — caption ("" when none), engagement, mp4 + transcript (~1 credit/post). (~10 credits (1/result)) */
     userPosts(params) {
         return this.core.get("/v1/kwai/user-posts", params);
     }
@@ -916,6 +912,26 @@ export class LinkmeApi {
         return this.core.get("/v1/linkme/profile", params);
     }
 }
+export class GoogleMapsApi {
+    core;
+    constructor(core) {
+        this.core = core;
+    }
+    /** Google Maps Business Search — Local businesses from a Maps search — name, address, phone, website, rating, hours, place id. Flat 2 credits. No emails. (2 credits) */
+    businessSearch(params) {
+        return this.core.get("/v1/google/business-search", params);
+    }
+}
+export class WebsiteApi {
+    core;
+    constructor(core) {
+        this.core = core;
+    }
+    /** Website Contacts — Business website → role emails, E.164 phones, social profiles. 1 credit when something is found, 0 when not. (1 credit) */
+    contacts(params) {
+        return this.core.get("/v1/website/contacts", params);
+    }
+}
 /** Captapi API client. Get your key at https://captapi.com/dashboard/api-keys */
 export class Captapi {
     youtube;
@@ -952,6 +968,8 @@ export class Captapi {
     pillar;
     linkbio;
     linkme;
+    googleMaps;
+    website;
     constructor(options = {}) {
         const core = new HttpCore(options);
         this.youtube = new YoutubeApi(core);
@@ -988,5 +1006,7 @@ export class Captapi {
         this.pillar = new PillarApi(core);
         this.linkbio = new LinkbioApi(core);
         this.linkme = new LinkmeApi(core);
+        this.googleMaps = new GoogleMapsApi(core);
+        this.website = new WebsiteApi(core);
     }
 }

package/package.json

@@ -1,51 +1,51 @@
-{
-  "name": "@captapi/sdk",
-  "version": "0.2.0",
-  "description": "Official typed TypeScript SDK for the Captapi social media API — 178 endpoints across 32 platforms (YouTube, TikTok, Instagram, Facebook, X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Twitch, Spotify, and more). Zero dependencies, built on fetch.",
-  "license": "MIT",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "sideEffects": false,
-  "keywords": [
-    "captapi",
-    "sdk",
-    "typescript",
-    "social-media",
-    "scraping",
-    "api-client",
-    "youtube",
-    "tiktok",
-    "instagram",
-    "reddit",
-    "twitter",
-    "transcript"
-  ],
-  "homepage": "https://captapi.com",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/CDCStream/captapi.git",
-    "directory": "packages/captapi-sdk"
-  },
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "typescript": "^5.6.0"
-  }
-}
+{
+  "name": "@captapi/sdk",
+  "version": "0.3.0",
+  "description": "Official typed TypeScript SDK for the Captapi social media API — 178 endpoints across 32 platforms (YouTube, TikTok, Instagram, Facebook, X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Twitch, Spotify, and more). Zero dependencies, built on fetch.",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "sideEffects": false,
+  "keywords": [
+    "captapi",
+    "sdk",
+    "typescript",
+    "social-media",
+    "scraping",
+    "api-client",
+    "youtube",
+    "tiktok",
+    "instagram",
+    "reddit",
+    "twitter",
+    "transcript"
+  ],
+  "homepage": "https://captapi.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/CDCStream/captapi.git",
+    "directory": "packages/captapi-sdk"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  }
+}