influship 0.2.0 → 0.3.2

package/resources/raw/youtube.d.mts

@@ -0,0 +1,455 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as YoutubeAPI from "./youtube.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+/**
+ * Fetch fresh data directly from social platforms in real-time. Use when you need the most current information or data for profiles not yet in our database.
+ */
+export declare class Youtube extends APIResource {
+    /**
+     * Fetch fresh YouTube channel data including subscriber count, video count, and
+     * total views.
+     *
+     * **Pricing**: 0.5 credits per channel scraped ($0.005)
+     */
+    getChannel(handle: string, query?: YoutubeGetChannelParams | null | undefined, options?: RequestOptions): APIPromise<YoutubeGetChannelResponse>;
+    /**
+     * Fetch transcripts for multiple videos from a YouTube channel. Videos can be
+     * sorted by popularity, newest, or oldest before selection.
+     *
+     * **Features:**
+     *
+     * - Fetches up to 20 video transcripts per request
+     * - Sort by popular (most views), newest, or oldest
+     * - Partial success — individual video failures don't block the response
+     * - Optional timestamped segments for each transcript
+     *
+     * **Pricing**: 0.5 credits per transcript fetched ($0.005)
+     */
+    getChannelTranscripts(handle: string, query?: YoutubeGetChannelTranscriptsParams | null | undefined, options?: RequestOptions): APIPromise<YoutubeGetChannelTranscriptsResponse>;
+    /**
+     * Fetch YouTube video transcript/captions. Returns timestamped segments and full
+     * text. Useful for content analysis.
+     *
+     * **Supported sources:**
+     *
+     * - Manual captions (highest quality)
+     * - Auto-generated captions
+     * - Multiple language tracks
+     *
+     * **Pricing**: 0.5 credits per transcript ($0.005)
+     */
+    getTranscript(videoID: string, query?: YoutubeGetTranscriptParams | null | undefined, options?: RequestOptions): APIPromise<YoutubeGetTranscriptResponse>;
+    /**
+     * Search YouTube videos and channels.
+     *
+     * **Pricing**: 0.5 credits per result returned ($0.005)
+     */
+    search(query: YoutubeSearchParams, options?: RequestOptions): APIPromise<YoutubeSearchResponse>;
+}
+export interface TranscriptSegment {
+    /**
+     * Duration in seconds
+     */
+    duration: number;
+    /**
+     * Start time in seconds
+     */
+    start: number;
+    /**
+     * Segment text
+     */
+    text: string;
+}
+export interface YoutubeGetChannelResponse {
+    data: YoutubeGetChannelResponse.Data;
+}
+export declare namespace YoutubeGetChannelResponse {
+    interface Data {
+        /**
+         * Channel avatar URL
+         */
+        avatar_url: string | null;
+        /**
+         * Channel description
+         */
+        description: string | null;
+        /**
+         * Channel handle
+         */
+        handle: string;
+        /**
+         * Channel name
+         */
+        name: string;
+        /**
+         * When this data was scraped
+         */
+        scraped_at: string;
+        /**
+         * Subscriber count
+         */
+        subscribers: number;
+        /**
+         * Total video count
+         */
+        videos_count: number;
+        /**
+         * Total view count
+         */
+        views_total: number;
+        /**
+         * Recent videos (only included when include_videos=true)
+         */
+        videos?: Array<Data.Video>;
+    }
+    namespace Data {
+        interface Video {
+            /**
+             * Video ID
+             */
+            id: string;
+            /**
+             * Comment count
+             */
+            comments: number | null;
+            /**
+             * Video duration in seconds
+             */
+            duration_seconds: number | null;
+            /**
+             * Like count
+             */
+            likes: number | null;
+            /**
+             * Publish timestamp
+             */
+            published_at: string;
+            /**
+             * Thumbnail URL
+             */
+            thumbnail_url: string | null;
+            /**
+             * Video title
+             */
+            title: string;
+            /**
+             * Video URL
+             */
+            url: string;
+            /**
+             * View count
+             */
+            views: number | null;
+        }
+    }
+}
+export interface YoutubeGetChannelTranscriptsResponse {
+    data: YoutubeGetChannelTranscriptsResponse.Data;
+}
+export declare namespace YoutubeGetChannelTranscriptsResponse {
+    interface Data {
+        /**
+         * YouTube channel ID
+         */
+        channel_id: string;
+        /**
+         * Channel name
+         */
+        channel_name: string;
+        /**
+         * Channel handle
+         */
+        handle: string;
+        /**
+         * Per-video transcript results
+         */
+        items: Array<Data.Item>;
+        /**
+         * When this data was scraped
+         */
+        scraped_at: string;
+        /**
+         * Number of transcripts that failed to fetch
+         */
+        transcripts_failed: number;
+        /**
+         * Number of transcripts successfully fetched
+         */
+        transcripts_fetched: number;
+        /**
+         * Total videos found on channel
+         */
+        videos_found: number;
+    }
+    namespace Data {
+        interface Item {
+            /**
+             * Error message if transcript fetch failed for this video
+             */
+            error: string | null;
+            /**
+             * Full transcript as plain text
+             */
+            full_text: string | null;
+            /**
+             * Transcript language code
+             */
+            language: string | null;
+            /**
+             * Relative publish time
+             */
+            published_text: string | null;
+            /**
+             * Caption source type
+             */
+            source: 'manual' | 'auto_generated' | null;
+            /**
+             * Video title
+             */
+            title: string;
+            /**
+             * Timestamped segments (only if include_segments=true)
+             */
+            transcript: Array<YoutubeAPI.TranscriptSegment> | null;
+            /**
+             * Video URL
+             */
+            url: string;
+            /**
+             * YouTube video ID
+             */
+            video_id: string;
+            /**
+             * View count
+             */
+            view_count: number | null;
+            /**
+             * Word count of transcript
+             */
+            word_count: number | null;
+        }
+    }
+}
+export interface YoutubeGetTranscriptResponse {
+    data: YoutubeGetTranscriptResponse.Data;
+}
+export declare namespace YoutubeGetTranscriptResponse {
+    interface Data {
+        /**
+         * Available transcript languages
+         */
+        available_languages: Array<string>;
+        /**
+         * Full transcript as plain text
+         */
+        full_text: string;
+        /**
+         * Transcript language code
+         */
+        language: string;
+        /**
+         * Video title
+         */
+        title: string;
+        /**
+         * Transcript segments
+         */
+        transcript: Array<YoutubeAPI.TranscriptSegment>;
+        /**
+         * Video URL
+         */
+        url: string;
+        /**
+         * Video ID
+         */
+        video_id: string;
+        /**
+         * Total word count
+         */
+        word_count: number;
+    }
+}
+export interface YoutubeSearchResponse {
+    data: YoutubeSearchResponse.Data;
+}
+export declare namespace YoutubeSearchResponse {
+    interface Data {
+        /**
+         * Estimated total results count
+         */
+        estimated_results: number | null;
+        /**
+         * The search query
+         */
+        query: string;
+        /**
+         * Search results (videos and channels)
+         */
+        results: Array<Data.YouTubeSearchVideoResult | Data.YouTubeSearchChannelResult>;
+        /**
+         * When this search was performed
+         */
+        scraped_at: string;
+    }
+    namespace Data {
+        interface YouTubeSearchVideoResult {
+            /**
+             * Channel handle (e.g., @username)
+             */
+            channel_handle: string | null;
+            /**
+             * Channel ID
+             */
+            channel_id: string;
+            /**
+             * Channel name
+             */
+            channel_name: string;
+            /**
+             * Whether channel is verified
+             */
+            channel_verified: boolean;
+            /**
+             * Video description snippet
+             */
+            description: string | null;
+            /**
+             * Video duration in seconds
+             */
+            duration_seconds: number | null;
+            /**
+             * Video duration text (e.g., "12:34")
+             */
+            duration_text: string | null;
+            /**
+             * Approximate publish timestamp
+             */
+            published_at: string | null;
+            /**
+             * Relative publish time (e.g., "2 days ago")
+             */
+            published_text: string | null;
+            /**
+             * Video thumbnail URL
+             */
+            thumbnail_url: string | null;
+            /**
+             * Video title
+             */
+            title: string;
+            type: 'video';
+            /**
+             * Full YouTube video URL
+             */
+            url: string;
+            /**
+             * YouTube video ID
+             */
+            video_id: string;
+            /**
+             * Number of views
+             */
+            view_count: number | null;
+            /**
+             * View count text (e.g., "1.2M views")
+             */
+            view_count_text: string | null;
+        }
+        interface YouTubeSearchChannelResult {
+            /**
+             * Channel handle (e.g., @username)
+             */
+            channel_handle: string | null;
+            /**
+             * Channel ID
+             */
+            channel_id: string;
+            /**
+             * Channel name
+             */
+            channel_name: string;
+            /**
+             * Whether channel is verified
+             */
+            channel_verified: boolean;
+            /**
+             * Channel description snippet
+             */
+            description: string | null;
+            /**
+             * Subscriber count
+             */
+            subscriber_count: number | null;
+            /**
+             * Channel avatar URL
+             */
+            thumbnail_url: string | null;
+            type: 'channel';
+            /**
+             * Full YouTube channel URL
+             */
+            url: string;
+            /**
+             * Number of videos on the channel
+             */
+            video_count: number | null;
+        }
+    }
+}
+export interface YoutubeGetChannelParams {
+    /**
+     * Include recent videos in response
+     */
+    include_videos?: boolean;
+    /**
+     * Number of videos to include
+     */
+    video_limit?: number;
+}
+export interface YoutubeGetChannelTranscriptsParams {
+    /**
+     * Include timestamped transcript segments in response
+     */
+    include_segments?: boolean;
+    /**
+     * Language code for transcripts
+     */
+    language?: string;
+    /**
+     * How to sort channel videos before selecting
+     */
+    sort_by?: 'popular' | 'newest' | 'oldest';
+    /**
+     * Number of videos to fetch transcripts for (max 20)
+     */
+    video_limit?: number;
+}
+export interface YoutubeGetTranscriptParams {
+    /**
+     * Language code or "auto" for automatic detection
+     */
+    language?: string;
+}
+export interface YoutubeSearchParams {
+    /**
+     * Search query
+     */
+    q: string;
+    /**
+     * Country code for localized results (ISO 3166-1 alpha-2)
+     */
+    country_code?: string;
+    /**
+     * Language code for results
+     */
+    language_code?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+}
+export declare namespace Youtube {
+    export { type TranscriptSegment as TranscriptSegment, type YoutubeGetChannelResponse as YoutubeGetChannelResponse, type YoutubeGetChannelTranscriptsResponse as YoutubeGetChannelTranscriptsResponse, type YoutubeGetTranscriptResponse as YoutubeGetTranscriptResponse, type YoutubeSearchResponse as YoutubeSearchResponse, type YoutubeGetChannelParams as YoutubeGetChannelParams, type YoutubeGetChannelTranscriptsParams as YoutubeGetChannelTranscriptsParams, type YoutubeGetTranscriptParams as YoutubeGetTranscriptParams, type YoutubeSearchParams as YoutubeSearchParams, };
+}
+//# sourceMappingURL=youtube.d.mts.map

package/resources/raw/youtube.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube.d.mts","sourceRoot":"","sources":["../../src/resources/raw/youtube.ts"],"names":[],"mappings":"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"}