influship 0.2.0

package/resources/posts.mjs

@@ -0,0 +1,51 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+export 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, 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 });
+    }
+}
+//# sourceMappingURL=posts.mjs.map

package/resources/posts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"posts.mjs","sourceRoot":"","sources":["../src/resources/posts.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAKtB,MAAM,OAAO,KAAM,SAAQ,WAAW;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"}

package/resources/profiles.d.mts

@@ -0,0 +1,99 @@
+import { APIResource } from "../core/resource.mjs";
+import * as CreatorsAPI from "./creators.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare class Profiles extends APIResource {
+    /**
+     * **DISCOVERY ENDPOINT**: Look up social account data when you know a username and
+     * platform.
+     *
+     * **🎯 When to use this endpoint:**
+     *
+     * - ✅ You have a username and platform (e.g., @fitness_guru on Instagram)
+     * - ✅ You want to discover who a social account belongs to
+     * - ✅ You need to look up specific social accounts by username
+     * - ✅ You want to get social account metrics for known usernames
+     *
+     * **❌ When NOT to use this endpoint:**
+     *
+     * - ❌ You already have a creator UUID (use `/v1/creators/{id}/profiles` instead)
+     * - ❌ You want to get all accounts for a creator (use
+     *   `/v1/creators/{id}/profiles` instead)
+     *
+     * **📊 Response Format:** Returns `SocialAccountLite` or `SocialAccountDetailed`
+     * objects with identical structure to `/v1/creators/{id}/profiles`. Both endpoints
+     * return the same data structure for consistency.
+     *
+     * **🔗 Data Relationships:**
+     *
+     * - Use the `creator_profile_id` field to fetch creator-level data via
+     *   `/v1/creators`
+     * - Use the `creator_profile_id` to get all social accounts via
+     *   `/v1/creators/{id}/profiles`
+     * - Creator-level data includes: name, bio, avatar, ai_one_line_bio
+     * - Social account data includes: follower_count, engagement_rate, verified,
+     *   platform-specific metrics
+     *
+     * **🔄 Typical Workflow:**
+     *
+     * 1. **Discovery**: Call `/v1/profiles` with username+platform → get social
+     *    account data + creator_profile_id
+     * 2. **Creator Data**: Call `/v1/creators` with creator_profile_id → get
+     *    creator-level data
+     * 3. **All Accounts**: Call `/v1/creators/{id}/profiles` with creator_profile_id →
+     *    get all social accounts for that creator
+     *
+     * **⚙️ Parameters:**
+     *
+     * - `mode`: `lite` (default) or `detailed` - controls response detail level
+     * - `platforms`: Array of platform names to filter results (e.g.,
+     *   `["instagram", "tiktok"]`) **Pricing**: 0.01-0.05 credits per profile
+     *   (lite/detailed mode)
+     *
+     * @example
+     * ```ts
+     * const response = await client.profiles.lookup({
+     *   profiles: [
+     *     { platform: 'instagram', username: 'fitness_guru' },
+     *     { platform: 'tiktok', username: 'fitness_guru' },
+     *   ],
+     * });
+     * ```
+     */
+    lookup(body: ProfileLookupParams, options?: RequestOptions): APIPromise<ProfileLookupResponse>;
+}
+export interface CreatorReferenceByHandle {
+    /**
+     * Social platform where the creator exists
+     */
+    platform: 'instagram' | 'tiktok';
+    /**
+     * Username on the platform
+     */
+    username: string;
+}
+export interface ProfileLookupResponse {
+    /**
+     * Array of social account objects. The structure depends on the `mode` parameter:
+     *
+     * - If `mode: "lite"`: Returns SocialAccountLite objects
+     * - If `mode: "detailed"`: Returns SocialAccountDetailed objects with additional
+     *   fields
+     */
+    profiles?: Array<CreatorsAPI.SocialAccountLite | CreatorsAPI.SocialAccountDetailed>;
+}
+export interface ProfileLookupParams {
+    profiles: Array<CreatorReferenceByHandle>;
+    /**
+     * Response detail level - lite for basic fields, detailed for additional metrics
+     */
+    mode?: 'lite' | 'detailed';
+    /**
+     * Filter results to only include these platforms
+     */
+    platforms?: Array<'instagram' | 'tiktok'>;
+}
+export declare namespace Profiles {
+    export { type CreatorReferenceByHandle as CreatorReferenceByHandle, type ProfileLookupResponse as ProfileLookupResponse, type ProfileLookupParams as ProfileLookupParams, };
+}
+//# sourceMappingURL=profiles.d.mts.map

package/resources/profiles.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.mts","sourceRoot":"","sources":["../src/resources/profiles.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,WAAW;OAChB,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDG;IACH,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;CAG/F;AAED,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;IAEjC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,iBAAiB,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;CACrF;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAE1C;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAE3B;;OAEG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,QAAQ,CAAC,CAAC;CAC3C;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}

package/resources/profiles.d.ts

@@ -0,0 +1,99 @@
+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 Profiles extends APIResource {
+    /**
+     * **DISCOVERY ENDPOINT**: Look up social account data when you know a username and
+     * platform.
+     *
+     * **🎯 When to use this endpoint:**
+     *
+     * - ✅ You have a username and platform (e.g., @fitness_guru on Instagram)
+     * - ✅ You want to discover who a social account belongs to
+     * - ✅ You need to look up specific social accounts by username
+     * - ✅ You want to get social account metrics for known usernames
+     *
+     * **❌ When NOT to use this endpoint:**
+     *
+     * - ❌ You already have a creator UUID (use `/v1/creators/{id}/profiles` instead)
+     * - ❌ You want to get all accounts for a creator (use
+     *   `/v1/creators/{id}/profiles` instead)
+     *
+     * **📊 Response Format:** Returns `SocialAccountLite` or `SocialAccountDetailed`
+     * objects with identical structure to `/v1/creators/{id}/profiles`. Both endpoints
+     * return the same data structure for consistency.
+     *
+     * **🔗 Data Relationships:**
+     *
+     * - Use the `creator_profile_id` field to fetch creator-level data via
+     *   `/v1/creators`
+     * - Use the `creator_profile_id` to get all social accounts via
+     *   `/v1/creators/{id}/profiles`
+     * - Creator-level data includes: name, bio, avatar, ai_one_line_bio
+     * - Social account data includes: follower_count, engagement_rate, verified,
+     *   platform-specific metrics
+     *
+     * **🔄 Typical Workflow:**
+     *
+     * 1. **Discovery**: Call `/v1/profiles` with username+platform → get social
+     *    account data + creator_profile_id
+     * 2. **Creator Data**: Call `/v1/creators` with creator_profile_id → get
+     *    creator-level data
+     * 3. **All Accounts**: Call `/v1/creators/{id}/profiles` with creator_profile_id →
+     *    get all social accounts for that creator
+     *
+     * **⚙️ Parameters:**
+     *
+     * - `mode`: `lite` (default) or `detailed` - controls response detail level
+     * - `platforms`: Array of platform names to filter results (e.g.,
+     *   `["instagram", "tiktok"]`) **Pricing**: 0.01-0.05 credits per profile
+     *   (lite/detailed mode)
+     *
+     * @example
+     * ```ts
+     * const response = await client.profiles.lookup({
+     *   profiles: [
+     *     { platform: 'instagram', username: 'fitness_guru' },
+     *     { platform: 'tiktok', username: 'fitness_guru' },
+     *   ],
+     * });
+     * ```
+     */
+    lookup(body: ProfileLookupParams, options?: RequestOptions): APIPromise<ProfileLookupResponse>;
+}
+export interface CreatorReferenceByHandle {
+    /**
+     * Social platform where the creator exists
+     */
+    platform: 'instagram' | 'tiktok';
+    /**
+     * Username on the platform
+     */
+    username: string;
+}
+export interface ProfileLookupResponse {
+    /**
+     * Array of social account objects. The structure depends on the `mode` parameter:
+     *
+     * - If `mode: "lite"`: Returns SocialAccountLite objects
+     * - If `mode: "detailed"`: Returns SocialAccountDetailed objects with additional
+     *   fields
+     */
+    profiles?: Array<CreatorsAPI.SocialAccountLite | CreatorsAPI.SocialAccountDetailed>;
+}
+export interface ProfileLookupParams {
+    profiles: Array<CreatorReferenceByHandle>;
+    /**
+     * Response detail level - lite for basic fields, detailed for additional metrics
+     */
+    mode?: 'lite' | 'detailed';
+    /**
+     * Filter results to only include these platforms
+     */
+    platforms?: Array<'instagram' | 'tiktok'>;
+}
+export declare namespace Profiles {
+    export { type CreatorReferenceByHandle as CreatorReferenceByHandle, type ProfileLookupResponse as ProfileLookupResponse, type ProfileLookupParams as ProfileLookupParams, };
+}
+//# sourceMappingURL=profiles.d.ts.map

package/resources/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../src/resources/profiles.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,WAAW;OAChB,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDG;IACH,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;CAG/F;AAED,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;IAEjC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,iBAAiB,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;CACrF;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAE1C;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAE3B;;OAEG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,QAAQ,CAAC,CAAC;CAC3C;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}

package/resources/profiles.js

@@ -0,0 +1,69 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Profiles = void 0;
+const resource_1 = require("../core/resource.js");
+class Profiles extends resource_1.APIResource {
+    /**
+     * **DISCOVERY ENDPOINT**: Look up social account data when you know a username and
+     * platform.
+     *
+     * **🎯 When to use this endpoint:**
+     *
+     * - ✅ You have a username and platform (e.g., @fitness_guru on Instagram)
+     * - ✅ You want to discover who a social account belongs to
+     * - ✅ You need to look up specific social accounts by username
+     * - ✅ You want to get social account metrics for known usernames
+     *
+     * **❌ When NOT to use this endpoint:**
+     *
+     * - ❌ You already have a creator UUID (use `/v1/creators/{id}/profiles` instead)
+     * - ❌ You want to get all accounts for a creator (use
+     *   `/v1/creators/{id}/profiles` instead)
+     *
+     * **📊 Response Format:** Returns `SocialAccountLite` or `SocialAccountDetailed`
+     * objects with identical structure to `/v1/creators/{id}/profiles`. Both endpoints
+     * return the same data structure for consistency.
+     *
+     * **🔗 Data Relationships:**
+     *
+     * - Use the `creator_profile_id` field to fetch creator-level data via
+     *   `/v1/creators`
+     * - Use the `creator_profile_id` to get all social accounts via
+     *   `/v1/creators/{id}/profiles`
+     * - Creator-level data includes: name, bio, avatar, ai_one_line_bio
+     * - Social account data includes: follower_count, engagement_rate, verified,
+     *   platform-specific metrics
+     *
+     * **🔄 Typical Workflow:**
+     *
+     * 1. **Discovery**: Call `/v1/profiles` with username+platform → get social
+     *    account data + creator_profile_id
+     * 2. **Creator Data**: Call `/v1/creators` with creator_profile_id → get
+     *    creator-level data
+     * 3. **All Accounts**: Call `/v1/creators/{id}/profiles` with creator_profile_id →
+     *    get all social accounts for that creator
+     *
+     * **⚙️ Parameters:**
+     *
+     * - `mode`: `lite` (default) or `detailed` - controls response detail level
+     * - `platforms`: Array of platform names to filter results (e.g.,
+     *   `["instagram", "tiktok"]`) **Pricing**: 0.01-0.05 credits per profile
+     *   (lite/detailed mode)
+     *
+     * @example
+     * ```ts
+     * const response = await client.profiles.lookup({
+     *   profiles: [
+     *     { platform: 'instagram', username: 'fitness_guru' },
+     *     { platform: 'tiktok', username: 'fitness_guru' },
+     *   ],
+     * });
+     * ```
+     */
+    lookup(body, options) {
+        return this._client.post('/v1/profiles', { body, ...options });
+    }
+}
+exports.Profiles = Profiles;
+//# sourceMappingURL=profiles.js.map

package/resources/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../src/resources/profiles.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAK/C,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;CACF;AA7DD,4BA6DC"}

package/resources/profiles.mjs

@@ -0,0 +1,65 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+export class Profiles extends APIResource {
+    /**
+     * **DISCOVERY ENDPOINT**: Look up social account data when you know a username and
+     * platform.
+     *
+     * **🎯 When to use this endpoint:**
+     *
+     * - ✅ You have a username and platform (e.g., @fitness_guru on Instagram)
+     * - ✅ You want to discover who a social account belongs to
+     * - ✅ You need to look up specific social accounts by username
+     * - ✅ You want to get social account metrics for known usernames
+     *
+     * **❌ When NOT to use this endpoint:**
+     *
+     * - ❌ You already have a creator UUID (use `/v1/creators/{id}/profiles` instead)
+     * - ❌ You want to get all accounts for a creator (use
+     *   `/v1/creators/{id}/profiles` instead)
+     *
+     * **📊 Response Format:** Returns `SocialAccountLite` or `SocialAccountDetailed`
+     * objects with identical structure to `/v1/creators/{id}/profiles`. Both endpoints
+     * return the same data structure for consistency.
+     *
+     * **🔗 Data Relationships:**
+     *
+     * - Use the `creator_profile_id` field to fetch creator-level data via
+     *   `/v1/creators`
+     * - Use the `creator_profile_id` to get all social accounts via
+     *   `/v1/creators/{id}/profiles`
+     * - Creator-level data includes: name, bio, avatar, ai_one_line_bio
+     * - Social account data includes: follower_count, engagement_rate, verified,
+     *   platform-specific metrics
+     *
+     * **🔄 Typical Workflow:**
+     *
+     * 1. **Discovery**: Call `/v1/profiles` with username+platform → get social
+     *    account data + creator_profile_id
+     * 2. **Creator Data**: Call `/v1/creators` with creator_profile_id → get
+     *    creator-level data
+     * 3. **All Accounts**: Call `/v1/creators/{id}/profiles` with creator_profile_id →
+     *    get all social accounts for that creator
+     *
+     * **⚙️ Parameters:**
+     *
+     * - `mode`: `lite` (default) or `detailed` - controls response detail level
+     * - `platforms`: Array of platform names to filter results (e.g.,
+     *   `["instagram", "tiktok"]`) **Pricing**: 0.01-0.05 credits per profile
+     *   (lite/detailed mode)
+     *
+     * @example
+     * ```ts
+     * const response = await client.profiles.lookup({
+     *   profiles: [
+     *     { platform: 'instagram', username: 'fitness_guru' },
+     *     { platform: 'tiktok', username: 'fitness_guru' },
+     *   ],
+     * });
+     * ```
+     */
+    lookup(body, options) {
+        return this._client.post('/v1/profiles', { body, ...options });
+    }
+}
+//# sourceMappingURL=profiles.mjs.map

package/resources/profiles.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.mjs","sourceRoot":"","sources":["../src/resources/profiles.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAKtB,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;CACF"}

package/resources/search.d.mts

@@ -0,0 +1,189 @@
+import { APIResource } from "../core/resource.mjs";
+import * as CreatorsAPI from "./creators.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+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.mts.map

package/resources/search.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.mts","sourceRoot":"","sources":["../src/resources/search.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,WAAW;OAChB,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,YAAY,CACV,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,0BAA0B,CAAC;CAI1C;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,iBAAiB,EAAE,UAAU,CAAC,gBAAgB,CAAC;IAE/C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,iBAAiB,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAEnF;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,yBAAiB,UAAU,CAAC;IAC1B;;;OAGG;IACH,UAAiB,gBAAgB;QAC/B;;;WAGG;QACH,WAAW,EAAE,MAAM,CAAC;QAEpB;;;WAGG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;;WAGG;QACH,QAAQ,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;KAC7C;IAED,UAAiB,gBAAgB,CAAC;QAChC;;;;WAIG;QACH,UAAiB,QAAQ;YACvB;;eAEG;YACH,IAAI,EAAE,MAAM,CAAC;YAEb;;eAEG;YACH,MAAM,EAAE,MAAM,CAAC;YAEf;;;eAGG;YACH,KAAK,EAAE,MAAM,CAAC;YAEd;;eAEG;YACH,UAAU,CAAC,EAAE,MAAM,CAAC;YAEpB;;;eAGG;YACH,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;SAChC;KACF;CACF;AAED,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,KAAK,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAE1B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,wBAAwB,CAAC,OAAO,CAAC;IAE3C;;;OAGG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,QAAQ,CAAC,CAAC;IAElD;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;CAC5B;AAED,yBAAiB,wBAAwB,CAAC;IACxC,UAAiB,OAAO;QACtB;;WAEG;QACH,gBAAgB,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAEjD;;;WAGG;QACH,cAAc,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;KAC/B;IAED,UAAiB,OAAO,CAAC;QACvB,UAAiB,cAAc;YAC7B,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC;YAEjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;YAE7B,aAAa,CAAC,EAAE,MAAM,CAAC;YAEvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;YAE7B,aAAa,CAAC,EAAE,MAAM,CAAC;YAEvB,aAAa,CAAC,EAAE,OAAO,CAAC;SACzB;KACF;CACF;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,UAAU,IAAI,UAAU,EAC7B,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,wBAAwB,IAAI,wBAAwB,GAC1D,CAAC;CACH"}