influship 0.2.0

package/resources/search.d.ts

@@ -0,0 +1,189 @@
+import { APIResource } from "../core/resource.js";
+import * as CreatorsAPI from "./creators.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Search extends APIResource {
+    /**
+     * Find influencers using AI-powered search with natural language queries and
+     * optional filters.
+     *
+     * **Pricing**:
+     *
+     * - Base: 2.0 credits per creator returned
+     * - Detailed mode: Additional 0.05 credits per social account profile
+     * - **Example**: 10 creators in lite mode = 20 credits
+     * - **Example**: 10 creators with avg 2 profiles each in detailed mode = 20 + (10
+     *   × 2 × 0.05) = 21 credits
+     *
+     * @example
+     * ```ts
+     * const response = await client.search.findCreators({
+     *   query:
+     *     'fitness influencers with 100k+ followers who post workout content',
+     * });
+     * ```
+     */
+    findCreators(params: SearchFindCreatorsParams, options?: RequestOptions): APIPromise<SearchFindCreatorsResponse>;
+}
+/**
+ * Search result item containing creator information and all social media profiles
+ */
+export interface SearchItem {
+    /**
+     * Unique creator identifier (UUID v4)
+     */
+    id: string;
+    /**
+     * AI-powered recommendation analysis explaining why this creator matches your
+     * query
+     */
+    ai_recommendation: SearchItem.AIRecommendation;
+    /**
+     * Creator's display name or full name
+     */
+    name: string;
+    /**
+     * Array of ALL social media profiles for this creator
+     */
+    profiles: Array<CreatorsAPI.SocialAccountLite | CreatorsAPI.SocialAccountDetailed>;
+    /**
+     * Profile picture URL. null if no avatar is available. URLs are typically valid
+     * for 24 hours.
+     */
+    avatar_url?: string | null;
+    /**
+     * Creator's biography or description text. May be aggregated from multiple
+     * platforms. null if unavailable.
+     */
+    bio?: string | null;
+}
+export declare namespace SearchItem {
+    /**
+     * AI-powered recommendation analysis explaining why this creator matches your
+     * query
+     */
+    interface AIRecommendation {
+        /**
+         * Human-readable explanation of why this creator was recommended. Highlights key
+         * matching factors from the query.
+         */
+        explanation: string;
+        /**
+         * Relevance score from 0 to 1, where 1 is a perfect match. Scores above 0.7
+         * indicate strong relevance.
+         */
+        score: number;
+        /**
+         * Fact-level evidence from hybrid search explaining why this creator matched. Each
+         * fact represents specific, verifiable information about the creator.
+         */
+        evidence?: Array<AIRecommendation.Evidence>;
+    }
+    namespace AIRecommendation {
+        /**
+         * Individual fact from hybrid search providing evidence for why a creator matched.
+         * Facts are specific, verifiable pieces of information extracted from creator
+         * data.
+         */
+        interface Evidence {
+            /**
+             * The actual fact text describing specific information about the creator
+             */
+            fact: string;
+            /**
+             * Unique identifier for this fact
+             */
+            factId: string;
+            /**
+             * Combined relevance score (similarity × confidence × temporal decay). Higher
+             * scores indicate stronger evidence for the match.
+             */
+            score: number;
+            /**
+             * When this fact was created or observed (ISO 8601 format)
+             */
+            created_at?: string;
+            /**
+             * Array of source post IDs where this fact originated. A single fact may come from
+             * multiple posts.
+             */
+            source_post_id?: Array<string>;
+        }
+    }
+}
+export interface SearchFindCreatorsResponse {
+    /**
+     * Total number of matching results in the database before pagination. Use this
+     * with `has_more` to display "Showing 25 of 1,247 results" in your UI.
+     */
+    filtered_total?: number;
+    /**
+     * Whether there are more results available for pagination. If true, use the
+     * `next_cursor` value in your next request.
+     */
+    has_more?: boolean;
+    items?: Array<SearchItem>;
+    /**
+     * Opaque cursor for fetching the next page of results. Pass this value as the
+     * `cursor` query parameter. Only present when `has_more` is true.
+     */
+    next_cursor?: string;
+}
+export interface SearchFindCreatorsParams {
+    /**
+     * Body param: Natural language search query
+     */
+    query: string;
+    /**
+     * Query param: Opaque pagination cursor from previous response's `next_cursor`. Do
+     * not construct manually.
+     */
+    cursor?: string;
+    /**
+     * Query param: Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Body param:
+     */
+    filters?: SearchFindCreatorsParams.Filters;
+    /**
+     * Body param: Filter social accounts to only these platforms. Reduces payload
+     * size. Does not affect search results or costs.
+     */
+    include_platforms?: Array<'instagram' | 'tiktok'>;
+    /**
+     * Body param: Response detail level. `lite` returns basic fields (username,
+     * follower_count, engagement_rate). `detailed` adds avg_comments_recent,
+     * avg_video_views_recent, follower_change_rate, etc. Detailed mode costs 5x more
+     * (0.05 vs 0.01 credits per profile).
+     */
+    mode?: 'lite' | 'detailed';
+}
+export declare namespace SearchFindCreatorsParams {
+    interface Filters {
+        /**
+         * Per-platform filter definitions
+         */
+        platform_filters?: Array<Filters.PlatformFilter>;
+        /**
+         * How to combine platform_filters. `OR` = creator matches ANY platform filter.
+         * `AND` = creator must match ALL platform filters. Default: OR.
+         */
+        platform_logic?: 'AND' | 'OR';
+    }
+    namespace Filters {
+        interface PlatformFilter {
+            platform: 'instagram' | 'tiktok';
+            max_engagement_rate?: number;
+            max_followers?: number;
+            min_engagement_rate?: number;
+            min_followers?: number;
+            verified_only?: boolean;
+        }
+    }
+}
+export declare namespace Search {
+    export { type SearchItem as SearchItem, type SearchFindCreatorsResponse as SearchFindCreatorsResponse, type SearchFindCreatorsParams as SearchFindCreatorsParams, };
+}
+//# sourceMappingURL=search.d.ts.map

package/resources/search.d.ts.map

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

package/resources/search.js

@@ -0,0 +1,33 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Search = void 0;
+const resource_1 = require("../core/resource.js");
+class Search extends resource_1.APIResource {
+    /**
+     * Find influencers using AI-powered search with natural language queries and
+     * optional filters.
+     *
+     * **Pricing**:
+     *
+     * - Base: 2.0 credits per creator returned
+     * - Detailed mode: Additional 0.05 credits per social account profile
+     * - **Example**: 10 creators in lite mode = 20 credits
+     * - **Example**: 10 creators with avg 2 profiles each in detailed mode = 20 + (10
+     *   × 2 × 0.05) = 21 credits
+     *
+     * @example
+     * ```ts
+     * const response = await client.search.findCreators({
+     *   query:
+     *     'fitness influencers with 100k+ followers who post workout content',
+     * });
+     * ```
+     */
+    findCreators(params, options) {
+        const { cursor, limit, ...body } = params;
+        return this._client.post('/v1/search', { query: { cursor, limit }, body, ...options });
+    }
+}
+exports.Search = Search;
+//# sourceMappingURL=search.js.map

package/resources/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/resources/search.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAK/C,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,YAAY,CACV,MAAgC,EAChC,OAAwB;QAExB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;CACF;AA5BD,wBA4BC"}

package/resources/search.mjs

@@ -0,0 +1,29 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+export class Search extends APIResource {
+    /**
+     * Find influencers using AI-powered search with natural language queries and
+     * optional filters.
+     *
+     * **Pricing**:
+     *
+     * - Base: 2.0 credits per creator returned
+     * - Detailed mode: Additional 0.05 credits per social account profile
+     * - **Example**: 10 creators in lite mode = 20 credits
+     * - **Example**: 10 creators with avg 2 profiles each in detailed mode = 20 + (10
+     *   × 2 × 0.05) = 21 credits
+     *
+     * @example
+     * ```ts
+     * const response = await client.search.findCreators({
+     *   query:
+     *     'fitness influencers with 100k+ followers who post workout content',
+     * });
+     * ```
+     */
+    findCreators(params, options) {
+        const { cursor, limit, ...body } = params;
+        return this._client.post('/v1/search', { query: { cursor, limit }, body, ...options });
+    }
+}
+//# sourceMappingURL=search.mjs.map

package/resources/search.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.mjs","sourceRoot":"","sources":["../src/resources/search.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAKtB,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,YAAY,CACV,MAAgC,EAChC,OAAwB;QAExB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;CACF"}

package/resources.d.mts

@@ -0,0 +1,2 @@
+export * from "./resources/index.mjs";
+//# sourceMappingURL=resources.d.mts.map

package/resources.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.mts","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":""}

package/resources.d.ts

@@ -0,0 +1,2 @@
+export * from "./resources/index.js";
+//# sourceMappingURL=resources.d.ts.map

package/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":""}

package/resources.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("./internal/tslib.js");
+tslib_1.__exportStar(require("./resources/index.js"), exports);
+//# sourceMappingURL=resources.js.map

package/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":";;;AAAA,+DAAkC"}

package/resources.mjs

@@ -0,0 +1,2 @@
+export * from "./resources/index.mjs";
+//# sourceMappingURL=resources.mjs.map

package/resources.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.mjs","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":""}

package/src/api-promise.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/api-promise instead */
+export * from './core/api-promise';