influship 0.2.0

package/resources/match.js

@@ -0,0 +1,22 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Match = void 0;
+const resource_1 = require("../core/resource.js");
+class Match extends resource_1.APIResource {
+    /**
+     * Evaluate how well creators align with campaign requirements using AI-powered
+     * analysis.
+     *
+     * Provide creator references and campaign description to receive match scores
+     * (0-100), AI decisions (good/neutral/avoid), explanations, and supporting
+     * evidence.
+     *
+     * **Pricing**: 0.1 credits per creator analyzed
+     */
+    analyze(body, options) {
+        return this._client.post('/v1/match', { body, ...options });
+    }
+}
+exports.Match = Match;
+//# sourceMappingURL=match.js.map

package/resources/match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.js","sourceRoot":"","sources":["../src/resources/match.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAK/C,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;;;;OASG;IACH,OAAO,CAAC,IAAwB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF;AAdD,sBAcC"}

package/resources/match.mjs

@@ -0,0 +1,18 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+export class Match extends APIResource {
+    /**
+     * Evaluate how well creators align with campaign requirements using AI-powered
+     * analysis.
+     *
+     * Provide creator references and campaign description to receive match scores
+     * (0-100), AI decisions (good/neutral/avoid), explanations, and supporting
+     * evidence.
+     *
+     * **Pricing**: 0.1 credits per creator analyzed
+     */
+    analyze(body, options) {
+        return this._client.post('/v1/match', { body, ...options });
+    }
+}
+//# sourceMappingURL=match.mjs.map

package/resources/match.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.mjs","sourceRoot":"","sources":["../src/resources/match.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAKtB,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;OASG;IACH,OAAO,CAAC,IAAwB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/resources/posts.d.mts

@@ -0,0 +1,284 @@
+import { APIResource } from "../core/resource.mjs";
+import * as BrandSafetyAPI from "./brand-safety.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare class Posts extends APIResource {
+    /**
+     * Analyze a social media post for engagement metrics, content insights, and brand
+     * safety.
+     *
+     * Provide post via URL or post_id+platform. Optionally include AI analysis and/or
+     * brand safety features.
+     *
+     * **Pricing**:
+     *
+     * - Base: 1.0 credit per post
+     * - AI Analysis feature: +0.5 credits (includes summary and transcript)
+     * - Brand Safety feature: +0.5 credits (includes rating and risk flags)
+     * - **Example**: 1 post with both features = 1.0 + 0.5 + 0.5 = 2.0 credits
+     *
+     * @example
+     * ```ts
+     * const postAnalysis = await client.posts.analyze({
+     *   url: 'https://example.com',
+     * });
+     * ```
+     */
+    analyze(body: PostAnalyzeParams, options?: RequestOptions): APIPromise<PostAnalysis>;
+    /**
+     * Retrieve posts for a specific creator using cursor-based pagination.
+     *
+     * This endpoint allows you to fetch posts from a creator's social media accounts
+     * with optional analysis features and date filtering.
+     *
+     * **Pricing**:
+     *
+     * - Base: 0.01 credits per post returned
+     * - The more posts you request, the more you pay
+     * - Use the `limit` parameter to control costs
+     * - **Example**: 25 posts = 0.25 credits
+     * - **Example**: 100 posts = 1.0 credit
+     *
+     * @example
+     * ```ts
+     * const response = await client.posts.listByCreator();
+     * ```
+     */
+    listByCreator(query?: PostListByCreatorParams | null | undefined, options?: RequestOptions): APIPromise<PostListByCreatorResponse>;
+}
+/**
+ * AI-powered content analysis. Only present when `ai_analysis` feature is
+ * requested.
+ */
+export interface AIAnalysis {
+    /**
+     * AI-generated summary describing key themes, topics, and messaging.
+     */
+    summary: string;
+    /**
+     * Transcription of spoken words in video. null for photo posts or videos without
+     * speech.
+     */
+    transcript?: string | null;
+}
+/**
+ * Cursor-based pagination metadata. Use this to navigate through paginated results
+ * efficiently.
+ */
+export interface CursorPagination {
+    /**
+     * Indicates whether more results are available.
+     *
+     * - `true`: Additional pages exist, use the `cursor` to fetch them
+     * - `false`: This is the last page of results
+     */
+    has_more: boolean;
+    /**
+     * Opaque base64-encoded cursor string for fetching the next page. Pass this value
+     * as the `cursor` query parameter in your next request. null when `has_more` is
+     * false (no more pages available). Do not attempt to decode or construct cursor
+     * values manually.
+     */
+    cursor?: string | null;
+}
+/**
+ * Analysis result for a single social media post
+ */
+export interface PostAnalysis {
+    /**
+     * Internal post ID
+     */
+    id: string;
+    /**
+     * Creator information for a post
+     */
+    creator: PostAnalysis.Creator;
+    /**
+     * Whether this post contains video content. true for video posts and reels, false
+     * for photo posts.
+     */
+    is_video: boolean;
+    /**
+     * URL of the primary media file (image or video). For carousel posts, this is the
+     * first item.
+     */
+    media_url: string;
+    /**
+     * Social media platform
+     */
+    platform: 'instagram' | 'tiktok';
+    /**
+     * Platform-specific unique identifier for this post. Format varies by platform
+     * (Instagram: numeric ID, TikTok: alphanumeric).
+     */
+    platform_post_id: string;
+    /**
+     * ISO 8601 timestamp when the post was originally published.
+     */
+    posted_at: string;
+    /**
+     * Alt text or accessibility caption describing the media. Useful for understanding
+     * image content. null if unavailable.
+     */
+    accessibility_caption?: string | null;
+    /**
+     * AI-powered content analysis. Only present when `ai_analysis` feature is
+     * requested.
+     */
+    ai_analysis?: AIAnalysis;
+    /**
+     * Brand safety analysis results
+     */
+    brand_safety?: BrandSafetyAPI.BrandSafetyAnalysis;
+    /**
+     * Post caption text written by the creator. null if no caption was provided.
+     */
+    caption?: string | null;
+    /**
+     * Total comments on post. null if unavailable.
+     */
+    comments_count?: number | null;
+    /**
+     * Total likes on post. null if platform hides like counts or data unavailable.
+     */
+    likes_count?: number | null;
+    /**
+     * Array of all media URLs in this post. Contains multiple items for carousel
+     * posts, single item for regular posts.
+     */
+    media_urls?: Array<string>;
+    /**
+     * ISO 8601 timestamp when we last scraped/updated this post's data. Metrics are
+     * accurate as of this time.
+     */
+    scraped_at?: string;
+    /**
+     * Instagram shortcode used in post URLs (instagram.com/p/{shortcode}). Only
+     * present for Instagram posts, null for other platforms.
+     */
+    shortcode?: string | null;
+    /**
+     * Thumbnail image URL for video posts. Only present when is_video is true, null
+     * for photo posts.
+     */
+    thumbnail_url?: string | null;
+    /**
+     * Video length in seconds. null for photo posts.
+     */
+    video_duration_seconds?: number | null;
+    /**
+     * Video view count. null for photo posts or if unavailable.
+     */
+    video_view_count?: number | null;
+}
+export declare namespace PostAnalysis {
+    /**
+     * Creator information for a post
+     */
+    interface Creator {
+        /**
+         * Creator UUID
+         */
+        id: string;
+        /**
+         * Social media platform
+         */
+        platform: 'instagram' | 'tiktok';
+        /**
+         * Social media username
+         */
+        username: string;
+    }
+}
+/**
+ * Response for getting posts by creator
+ */
+export interface PostListByCreatorResponse {
+    /**
+     * Cursor-based pagination metadata. Use this to navigate through paginated results
+     * efficiently.
+     */
+    pagination: CursorPagination;
+    /**
+     * Array of posts
+     */
+    posts: Array<PostAnalysis>;
+}
+export type PostAnalyzeParams = PostAnalyzeParams.Variant0 | PostAnalyzeParams.Variant1;
+export declare namespace PostAnalyzeParams {
+    interface Variant0 {
+        /**
+         * Public URL of the post to analyze
+         */
+        url: string;
+        /**
+         * Analysis features to include
+         */
+        features?: Array<'ai_analysis' | 'brand_safety'>;
+        /**
+         * Social media platform (required when using post_id)
+         */
+        platform?: 'instagram' | 'tiktok';
+        /**
+         * Platform-specific post ID
+         */
+        post_id?: string;
+    }
+    interface Variant1 {
+        /**
+         * Social media platform
+         */
+        platform: 'instagram' | 'tiktok';
+        /**
+         * Platform-specific post ID
+         */
+        post_id: string;
+        /**
+         * Analysis features to include
+         */
+        features?: Array<'ai_analysis' | 'brand_safety'>;
+        /**
+         * Public URL of the post to analyze
+         */
+        url?: string;
+    }
+}
+export interface PostListByCreatorParams {
+    /**
+     * Creator UUID
+     */
+    creator_id?: string;
+    /**
+     * Opaque pagination cursor from previous response. Do not construct manually.
+     */
+    cursor?: string;
+    /**
+     * Start date for filtering posts (ISO 8601)
+     */
+    date_from?: string;
+    /**
+     * End date for filtering posts (ISO 8601)
+     */
+    date_to?: string;
+    /**
+     * Optional analysis features. `ai_analysis` adds summary/transcript.
+     * `brand_safety` adds rating/flags. Each feature has additional cost.
+     */
+    features?: Array<'ai_analysis' | 'brand_safety'>;
+    /**
+     * Number of posts per page. Min 1, max 100, default 25.
+     */
+    limit?: number;
+    /**
+     * Social media platform
+     */
+    platform?: 'instagram' | 'tiktok';
+    /**
+     * Social media username
+     */
+    username?: string;
+}
+export declare namespace Posts {
+    export { type AIAnalysis as AIAnalysis, type CursorPagination as CursorPagination, type PostAnalysis as PostAnalysis, type PostListByCreatorResponse as PostListByCreatorResponse, type PostAnalyzeParams as PostAnalyzeParams, type PostListByCreatorParams as PostListByCreatorParams, };
+}
+//# sourceMappingURL=posts.d.mts.map

package/resources/posts.d.mts.map

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

package/resources/posts.d.ts

@@ -0,0 +1,284 @@
+import { APIResource } from "../core/resource.js";
+import * as BrandSafetyAPI from "./brand-safety.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Posts extends APIResource {
+    /**
+     * Analyze a social media post for engagement metrics, content insights, and brand
+     * safety.
+     *
+     * Provide post via URL or post_id+platform. Optionally include AI analysis and/or
+     * brand safety features.
+     *
+     * **Pricing**:
+     *
+     * - Base: 1.0 credit per post
+     * - AI Analysis feature: +0.5 credits (includes summary and transcript)
+     * - Brand Safety feature: +0.5 credits (includes rating and risk flags)
+     * - **Example**: 1 post with both features = 1.0 + 0.5 + 0.5 = 2.0 credits
+     *
+     * @example
+     * ```ts
+     * const postAnalysis = await client.posts.analyze({
+     *   url: 'https://example.com',
+     * });
+     * ```
+     */
+    analyze(body: PostAnalyzeParams, options?: RequestOptions): APIPromise<PostAnalysis>;
+    /**
+     * Retrieve posts for a specific creator using cursor-based pagination.
+     *
+     * This endpoint allows you to fetch posts from a creator's social media accounts
+     * with optional analysis features and date filtering.
+     *
+     * **Pricing**:
+     *
+     * - Base: 0.01 credits per post returned
+     * - The more posts you request, the more you pay
+     * - Use the `limit` parameter to control costs
+     * - **Example**: 25 posts = 0.25 credits
+     * - **Example**: 100 posts = 1.0 credit
+     *
+     * @example
+     * ```ts
+     * const response = await client.posts.listByCreator();
+     * ```
+     */
+    listByCreator(query?: PostListByCreatorParams | null | undefined, options?: RequestOptions): APIPromise<PostListByCreatorResponse>;
+}
+/**
+ * AI-powered content analysis. Only present when `ai_analysis` feature is
+ * requested.
+ */
+export interface AIAnalysis {
+    /**
+     * AI-generated summary describing key themes, topics, and messaging.
+     */
+    summary: string;
+    /**
+     * Transcription of spoken words in video. null for photo posts or videos without
+     * speech.
+     */
+    transcript?: string | null;
+}
+/**
+ * Cursor-based pagination metadata. Use this to navigate through paginated results
+ * efficiently.
+ */
+export interface CursorPagination {
+    /**
+     * Indicates whether more results are available.
+     *
+     * - `true`: Additional pages exist, use the `cursor` to fetch them
+     * - `false`: This is the last page of results
+     */
+    has_more: boolean;
+    /**
+     * Opaque base64-encoded cursor string for fetching the next page. Pass this value
+     * as the `cursor` query parameter in your next request. null when `has_more` is
+     * false (no more pages available). Do not attempt to decode or construct cursor
+     * values manually.
+     */
+    cursor?: string | null;
+}
+/**
+ * Analysis result for a single social media post
+ */
+export interface PostAnalysis {
+    /**
+     * Internal post ID
+     */
+    id: string;
+    /**
+     * Creator information for a post
+     */
+    creator: PostAnalysis.Creator;
+    /**
+     * Whether this post contains video content. true for video posts and reels, false
+     * for photo posts.
+     */
+    is_video: boolean;
+    /**
+     * URL of the primary media file (image or video). For carousel posts, this is the
+     * first item.
+     */
+    media_url: string;
+    /**
+     * Social media platform
+     */
+    platform: 'instagram' | 'tiktok';
+    /**
+     * Platform-specific unique identifier for this post. Format varies by platform
+     * (Instagram: numeric ID, TikTok: alphanumeric).
+     */
+    platform_post_id: string;
+    /**
+     * ISO 8601 timestamp when the post was originally published.
+     */
+    posted_at: string;
+    /**
+     * Alt text or accessibility caption describing the media. Useful for understanding
+     * image content. null if unavailable.
+     */
+    accessibility_caption?: string | null;
+    /**
+     * AI-powered content analysis. Only present when `ai_analysis` feature is
+     * requested.
+     */
+    ai_analysis?: AIAnalysis;
+    /**
+     * Brand safety analysis results
+     */
+    brand_safety?: BrandSafetyAPI.BrandSafetyAnalysis;
+    /**
+     * Post caption text written by the creator. null if no caption was provided.
+     */
+    caption?: string | null;
+    /**
+     * Total comments on post. null if unavailable.
+     */
+    comments_count?: number | null;
+    /**
+     * Total likes on post. null if platform hides like counts or data unavailable.
+     */
+    likes_count?: number | null;
+    /**
+     * Array of all media URLs in this post. Contains multiple items for carousel
+     * posts, single item for regular posts.
+     */
+    media_urls?: Array<string>;
+    /**
+     * ISO 8601 timestamp when we last scraped/updated this post's data. Metrics are
+     * accurate as of this time.
+     */
+    scraped_at?: string;
+    /**
+     * Instagram shortcode used in post URLs (instagram.com/p/{shortcode}). Only
+     * present for Instagram posts, null for other platforms.
+     */
+    shortcode?: string | null;
+    /**
+     * Thumbnail image URL for video posts. Only present when is_video is true, null
+     * for photo posts.
+     */
+    thumbnail_url?: string | null;
+    /**
+     * Video length in seconds. null for photo posts.
+     */
+    video_duration_seconds?: number | null;
+    /**
+     * Video view count. null for photo posts or if unavailable.
+     */
+    video_view_count?: number | null;
+}
+export declare namespace PostAnalysis {
+    /**
+     * Creator information for a post
+     */
+    interface Creator {
+        /**
+         * Creator UUID
+         */
+        id: string;
+        /**
+         * Social media platform
+         */
+        platform: 'instagram' | 'tiktok';
+        /**
+         * Social media username
+         */
+        username: string;
+    }
+}
+/**
+ * Response for getting posts by creator
+ */
+export interface PostListByCreatorResponse {
+    /**
+     * Cursor-based pagination metadata. Use this to navigate through paginated results
+     * efficiently.
+     */
+    pagination: CursorPagination;
+    /**
+     * Array of posts
+     */
+    posts: Array<PostAnalysis>;
+}
+export type PostAnalyzeParams = PostAnalyzeParams.Variant0 | PostAnalyzeParams.Variant1;
+export declare namespace PostAnalyzeParams {
+    interface Variant0 {
+        /**
+         * Public URL of the post to analyze
+         */
+        url: string;
+        /**
+         * Analysis features to include
+         */
+        features?: Array<'ai_analysis' | 'brand_safety'>;
+        /**
+         * Social media platform (required when using post_id)
+         */
+        platform?: 'instagram' | 'tiktok';
+        /**
+         * Platform-specific post ID
+         */
+        post_id?: string;
+    }
+    interface Variant1 {
+        /**
+         * Social media platform
+         */
+        platform: 'instagram' | 'tiktok';
+        /**
+         * Platform-specific post ID
+         */
+        post_id: string;
+        /**
+         * Analysis features to include
+         */
+        features?: Array<'ai_analysis' | 'brand_safety'>;
+        /**
+         * Public URL of the post to analyze
+         */
+        url?: string;
+    }
+}
+export interface PostListByCreatorParams {
+    /**
+     * Creator UUID
+     */
+    creator_id?: string;
+    /**
+     * Opaque pagination cursor from previous response. Do not construct manually.
+     */
+    cursor?: string;
+    /**
+     * Start date for filtering posts (ISO 8601)
+     */
+    date_from?: string;
+    /**
+     * End date for filtering posts (ISO 8601)
+     */
+    date_to?: string;
+    /**
+     * Optional analysis features. `ai_analysis` adds summary/transcript.
+     * `brand_safety` adds rating/flags. Each feature has additional cost.
+     */
+    features?: Array<'ai_analysis' | 'brand_safety'>;
+    /**
+     * Number of posts per page. Min 1, max 100, default 25.
+     */
+    limit?: number;
+    /**
+     * Social media platform
+     */
+    platform?: 'instagram' | 'tiktok';
+    /**
+     * Social media username
+     */
+    username?: string;
+}
+export declare namespace Posts {
+    export { type AIAnalysis as AIAnalysis, type CursorPagination as CursorPagination, type PostAnalysis as PostAnalysis, type PostListByCreatorResponse as PostListByCreatorResponse, type PostAnalyzeParams as PostAnalyzeParams, type PostListByCreatorParams as PostListByCreatorParams, };
+}
+//# sourceMappingURL=posts.d.ts.map

package/resources/posts.d.ts.map

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

package/resources/posts.js

@@ -0,0 +1,55 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Posts = void 0;
+const resource_1 = require("../core/resource.js");
+class Posts extends resource_1.APIResource {
+    /**
+     * Analyze a social media post for engagement metrics, content insights, and brand
+     * safety.
+     *
+     * Provide post via URL or post_id+platform. Optionally include AI analysis and/or
+     * brand safety features.
+     *
+     * **Pricing**:
+     *
+     * - Base: 1.0 credit per post
+     * - AI Analysis feature: +0.5 credits (includes summary and transcript)
+     * - Brand Safety feature: +0.5 credits (includes rating and risk flags)
+     * - **Example**: 1 post with both features = 1.0 + 0.5 + 0.5 = 2.0 credits
+     *
+     * @example
+     * ```ts
+     * const postAnalysis = await client.posts.analyze({
+     *   url: 'https://example.com',
+     * });
+     * ```
+     */
+    analyze(body, options) {
+        return this._client.post('/v1/posts/analyze', { body, ...options });
+    }
+    /**
+     * Retrieve posts for a specific creator using cursor-based pagination.
+     *
+     * This endpoint allows you to fetch posts from a creator's social media accounts
+     * with optional analysis features and date filtering.
+     *
+     * **Pricing**:
+     *
+     * - Base: 0.01 credits per post returned
+     * - The more posts you request, the more you pay
+     * - Use the `limit` parameter to control costs
+     * - **Example**: 25 posts = 0.25 credits
+     * - **Example**: 100 posts = 1.0 credit
+     *
+     * @example
+     * ```ts
+     * const response = await client.posts.listByCreator();
+     * ```
+     */
+    listByCreator(query = {}, options) {
+        return this._client.get('/v1/posts/by-creator', { query, ...options });
+    }
+}
+exports.Posts = Posts;
+//# sourceMappingURL=posts.js.map

package/resources/posts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posts.js","sourceRoot":"","sources":["../src/resources/posts.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAK/C,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,IAAuB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CACX,QAAoD,EAAE,EACtD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;CACF;AAnDD,sBAmDC"}