influship 0.2.0 → 0.3.2

package/resources/search.d.mts

@@ -1,189 +1,198 @@
 import { APIResource } from "../core/resource.mjs";
-import * as CreatorsAPI from "./creators.mjs";
+import * as SearchAPI from "./search.mjs";
+import * as Shared from "./shared.mjs";
 import { APIPromise } from "../core/api-promise.mjs";
+import { PagePromise, QueryCursor, type QueryCursorParams } from "../core/pagination.mjs";
 import { RequestOptions } from "../internal/request-options.mjs";
+/**
+ * AI-powered semantic search to find creators using natural language queries. Understands intent and context to match creators based on content themes, audience, and style.
+ */
 export declare class Search extends APIResource {
     /**
-     * Find influencers using AI-powered search with natural language queries and
-     * optional filters.
+     * Search for creators using natural language queries. The AI understands intent
+     * and context to match creators based on content themes, audience demographics,
+     * and style.
+     *
+     * The response includes a `search_id` that can be used with `GET /v1/search/{id}`
+     * to paginate through results for free.
+     *
+     * **Use cases:**
      *
-     * **Pricing**:
+     * - Find creators in a specific niche ("vegan food bloggers in LA")
+     * - Discover creators with specific audience characteristics ("fitness influencers
+     *   with millennial audience")
+     * - Search by content style ("creators who post cinematic travel videos")
      *
-     * - 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
+     * **Pricing**: 25 credits base + 2 credits per creator returned
      *
      * @example
      * ```ts
-     * const response = await client.search.findCreators({
+     * const search = await client.search.create({
      *   query:
-     *     'fitness influencers with 100k+ followers who post workout content',
+     *     'fitness influencers with 100k+ followers who post workout videos',
      * });
      * ```
      */
-    findCreators(params: SearchFindCreatorsParams, options?: RequestOptions): APIPromise<SearchFindCreatorsResponse>;
+    create(body: SearchCreateParams, options?: RequestOptions): APIPromise<SearchCreateResponse>;
+    /**
+     * Paginate through results from a previous search. Use the `search_id` returned by
+     * `POST /v1/search` to fetch additional pages.
+     *
+     * Search sessions expire after 1 hour. After expiry, a new search must be run.
+     *
+     * **Pricing**: 0 credits (included with initial search)
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const searchRetrieveResponse of client.search.retrieve(
+     *   '123e4567-e89b-12d3-a456-426614174000',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    retrieve(id: string, query?: SearchRetrieveParams | null | undefined, options?: RequestOptions): PagePromise<SearchRetrieveResponsesQueryCursor, SearchRetrieveResponse>;
 }
+export type SearchRetrieveResponsesQueryCursor = QueryCursor<SearchRetrieveResponse>;
 /**
- * Search result item containing creator information and all social media profiles
+ * Search match information
  */
-export interface SearchItem {
+export interface MatchInfo {
     /**
-     * Unique creator identifier (UUID v4)
+     * Human-readable match reasons
      */
-    id: string;
+    reasons: Array<string>;
     /**
-     * AI-powered recommendation analysis explaining why this creator matches your
-     * query
+     * Match relevance score (0-1)
      */
-    ai_recommendation: SearchItem.AIRecommendation;
+    score: number;
+}
+export interface SearchCreateResponse {
+    data: Array<SearchCreateResponse.Data>;
     /**
-     * Creator's display name or full name
+     * Whether more results are available
      */
-    name: string;
+    has_more: boolean;
     /**
-     * Array of ALL social media profiles for this creator
+     * Cursor for the next page
      */
-    profiles: Array<CreatorsAPI.SocialAccountLite | CreatorsAPI.SocialAccountDetailed>;
+    next_cursor: string | null;
     /**
-     * Profile picture URL. null if no avatar is available. URLs are typically valid
-     * for 24 hours.
+     * Search ID. Use with GET /v1/search/{id} for free pagination.
      */
-    avatar_url?: string | null;
+    search_id: string;
     /**
-     * Creator's biography or description text. May be aggregated from multiple
-     * platforms. null if unavailable.
+     * Total number of results across all pages
      */
-    bio?: string | null;
+    total: number;
 }
-export declare namespace SearchItem {
-    /**
-     * AI-powered recommendation analysis explaining why this creator matches your
-     * query
-     */
-    interface AIRecommendation {
+export declare namespace SearchCreateResponse {
+    interface Data {
         /**
-         * Human-readable explanation of why this creator was recommended. Highlights key
-         * matching factors from the query.
+         * Basic creator information
          */
-        explanation: string;
+        creator: Shared.CreatorBasic;
         /**
-         * Relevance score from 0 to 1, where 1 is a perfect match. Scores above 0.7
-         * indicate strong relevance.
+         * Search match information
          */
-        score: number;
+        match: SearchAPI.MatchInfo;
         /**
-         * Fact-level evidence from hybrid search explaining why this creator matched. Each
-         * fact represents specific, verifiable information about the creator.
+         * Abbreviated profile information
          */
-        evidence?: Array<AIRecommendation.Evidence>;
-    }
-    namespace AIRecommendation {
+        primary_profile: Shared.ProfileSummary | null;
         /**
-         * Individual fact from hybrid search providing evidence for why a creator matched.
-         * Facts are specific, verifiable pieces of information extracted from creator
-         * data.
+         * Abbreviated profile information
          */
-        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>;
-        }
+        relevant_profile: Shared.ProfileSummary | null;
     }
 }
-export interface SearchFindCreatorsResponse {
+export interface SearchRetrieveResponse {
+    /**
+     * Basic creator information
+     */
+    creator: Shared.CreatorBasic;
     /**
-     * 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.
+     * Search match information
      */
-    filtered_total?: number;
+    match: MatchInfo;
     /**
-     * Whether there are more results available for pagination. If true, use the
-     * `next_cursor` value in your next request.
+     * Abbreviated profile information
      */
-    has_more?: boolean;
-    items?: Array<SearchItem>;
+    primary_profile: Shared.ProfileSummary | null;
     /**
-     * Opaque cursor for fetching the next page of results. Pass this value as the
-     * `cursor` query parameter. Only present when `has_more` is true.
+     * Abbreviated profile information
      */
-    next_cursor?: string;
+    relevant_profile: Shared.ProfileSummary | null;
 }
-export interface SearchFindCreatorsParams {
+export interface SearchCreateParams {
     /**
-     * Body param: Natural language search query
+     * Natural language search query
      */
     query: string;
     /**
-     * Query param: Opaque pagination cursor from previous response's `next_cursor`. Do
-     * not construct manually.
+     * Additional filters
      */
-    cursor?: string;
+    filters?: SearchCreateParams.Filters;
     /**
-     * Query param: Maximum number of results to return
+     * Maximum 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.
+     * Filter results to specific platforms
      */
-    include_platforms?: Array<'instagram' | 'tiktok'>;
+    platforms?: Array<'instagram'>;
+}
+export declare namespace SearchCreateParams {
     /**
-     * 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).
+     * Additional filters
      */
-    mode?: 'lite' | 'detailed';
-}
-export declare namespace SearchFindCreatorsParams {
     interface Filters {
         /**
-         * Per-platform filter definitions
+         * Filter by engagement rate
+         */
+        engagement_rate?: Filters.EngagementRate;
+        /**
+         * Filter by follower count
          */
-        platform_filters?: Array<Filters.PlatformFilter>;
+        followers?: Filters.Followers;
         /**
-         * How to combine platform_filters. `OR` = creator matches ANY platform filter.
-         * `AND` = creator must match ALL platform filters. Default: OR.
+         * Filter by verified status
          */
-        platform_logic?: 'AND' | 'OR';
+        verified?: boolean;
     }
     namespace Filters {
-        interface PlatformFilter {
-            platform: 'instagram' | 'tiktok';
-            max_engagement_rate?: number;
-            max_followers?: number;
-            min_engagement_rate?: number;
-            min_followers?: number;
-            verified_only?: boolean;
+        /**
+         * Filter by engagement rate
+         */
+        interface EngagementRate {
+            /**
+             * Maximum engagement rate (%)
+             */
+            max?: number;
+            /**
+             * Minimum engagement rate (%)
+             */
+            min?: number;
+        }
+        /**
+         * Filter by follower count
+         */
+        interface Followers {
+            /**
+             * Maximum follower count
+             */
+            max?: number;
+            /**
+             * Minimum follower count
+             */
+            min?: number;
         }
     }
 }
+export interface SearchRetrieveParams extends QueryCursorParams {
+}
 export declare namespace Search {
-    export { type SearchItem as SearchItem, type SearchFindCreatorsResponse as SearchFindCreatorsResponse, type SearchFindCreatorsParams as SearchFindCreatorsParams, };
+    export { type MatchInfo as MatchInfo, type SearchCreateResponse as SearchCreateResponse, type SearchRetrieveResponse as SearchRetrieveResponse, type SearchRetrieveResponsesQueryCursor as SearchRetrieveResponsesQueryCursor, type SearchCreateParams as SearchCreateParams, type SearchRetrieveParams as SearchRetrieveParams, };
 }
 //# sourceMappingURL=search.d.mts.map

package/resources/search.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.mts","sourceRoot":"","sources":["../src/resources/search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"search.d.mts","sourceRoot":"","sources":["../src/resources/search.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,SAAS;OACd,KAAK,MAAM;OACX,EAAE,UAAU,EAAE;OACd,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE;OACpD,EAAE,cAAc,EAAE;AAGzB;;GAEG;AACH,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;IAI5F;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,KAAK,GAAE,oBAAoB,GAAG,IAAI,GAAG,SAAc,EACnD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,kCAAkC,EAAE,sBAAsB,CAAC;CAM3E;AAED,MAAM,MAAM,kCAAkC,GAAG,WAAW,CAAC,sBAAsB,CAAC,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEvB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAEvC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yBAAiB,oBAAoB,CAAC;IACpC,UAAiB,IAAI;QACnB;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC;QAE7B;;WAEG;QACH,KAAK,EAAE,SAAS,CAAC,SAAS,CAAC;QAE3B;;WAEG;QACH,eAAe,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;QAE9C;;WAEG;QACH,gBAAgB,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;KAChD;CACF;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC;IAE7B;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAE9C;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC;IAErC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;CAChC;AAED,yBAAiB,kBAAkB,CAAC;IAClC;;OAEG;IACH,UAAiB,OAAO;QACtB;;WAEG;QACH,eAAe,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;QAEzC;;WAEG;QACH,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC;QAE9B;;WAEG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB;IAED,UAAiB,OAAO,CAAC;QACvB;;WAEG;QACH,UAAiB,cAAc;YAC7B;;eAEG;YACH,GAAG,CAAC,EAAE,MAAM,CAAC;YAEb;;eAEG;YACH,GAAG,CAAC,EAAE,MAAM,CAAC;SACd;QAED;;WAEG;QACH,UAAiB,SAAS;YACxB;;eAEG;YACH,GAAG,CAAC,EAAE,MAAM,CAAC;YAEb;;eAEG;YACH,GAAG,CAAC,EAAE,MAAM,CAAC;SACd;KACF;CACF;AAED,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;CAAG;AAElE,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,KAAK,SAAS,IAAI,SAAS,EAC3B,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,kCAAkC,IAAI,kCAAkC,EAC7E,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH"}

package/resources/search.d.ts

@@ -1,189 +1,198 @@
 import { APIResource } from "../core/resource.js";
-import * as CreatorsAPI from "./creators.js";
+import * as SearchAPI from "./search.js";
+import * as Shared from "./shared.js";
 import { APIPromise } from "../core/api-promise.js";
+import { PagePromise, QueryCursor, type QueryCursorParams } from "../core/pagination.js";
 import { RequestOptions } from "../internal/request-options.js";
+/**
+ * AI-powered semantic search to find creators using natural language queries. Understands intent and context to match creators based on content themes, audience, and style.
+ */
 export declare class Search extends APIResource {
     /**
-     * Find influencers using AI-powered search with natural language queries and
-     * optional filters.
+     * Search for creators using natural language queries. The AI understands intent
+     * and context to match creators based on content themes, audience demographics,
+     * and style.
+     *
+     * The response includes a `search_id` that can be used with `GET /v1/search/{id}`
+     * to paginate through results for free.
+     *
+     * **Use cases:**
      *
-     * **Pricing**:
+     * - Find creators in a specific niche ("vegan food bloggers in LA")
+     * - Discover creators with specific audience characteristics ("fitness influencers
+     *   with millennial audience")
+     * - Search by content style ("creators who post cinematic travel videos")
      *
-     * - 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
+     * **Pricing**: 25 credits base + 2 credits per creator returned
      *
      * @example
      * ```ts
-     * const response = await client.search.findCreators({
+     * const search = await client.search.create({
      *   query:
-     *     'fitness influencers with 100k+ followers who post workout content',
+     *     'fitness influencers with 100k+ followers who post workout videos',
      * });
      * ```
      */
-    findCreators(params: SearchFindCreatorsParams, options?: RequestOptions): APIPromise<SearchFindCreatorsResponse>;
+    create(body: SearchCreateParams, options?: RequestOptions): APIPromise<SearchCreateResponse>;
+    /**
+     * Paginate through results from a previous search. Use the `search_id` returned by
+     * `POST /v1/search` to fetch additional pages.
+     *
+     * Search sessions expire after 1 hour. After expiry, a new search must be run.
+     *
+     * **Pricing**: 0 credits (included with initial search)
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const searchRetrieveResponse of client.search.retrieve(
+     *   '123e4567-e89b-12d3-a456-426614174000',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    retrieve(id: string, query?: SearchRetrieveParams | null | undefined, options?: RequestOptions): PagePromise<SearchRetrieveResponsesQueryCursor, SearchRetrieveResponse>;
 }
+export type SearchRetrieveResponsesQueryCursor = QueryCursor<SearchRetrieveResponse>;
 /**
- * Search result item containing creator information and all social media profiles
+ * Search match information
  */
-export interface SearchItem {
+export interface MatchInfo {
     /**
-     * Unique creator identifier (UUID v4)
+     * Human-readable match reasons
      */
-    id: string;
+    reasons: Array<string>;
     /**
-     * AI-powered recommendation analysis explaining why this creator matches your
-     * query
+     * Match relevance score (0-1)
      */
-    ai_recommendation: SearchItem.AIRecommendation;
+    score: number;
+}
+export interface SearchCreateResponse {
+    data: Array<SearchCreateResponse.Data>;
     /**
-     * Creator's display name or full name
+     * Whether more results are available
      */
-    name: string;
+    has_more: boolean;
     /**
-     * Array of ALL social media profiles for this creator
+     * Cursor for the next page
      */
-    profiles: Array<CreatorsAPI.SocialAccountLite | CreatorsAPI.SocialAccountDetailed>;
+    next_cursor: string | null;
     /**
-     * Profile picture URL. null if no avatar is available. URLs are typically valid
-     * for 24 hours.
+     * Search ID. Use with GET /v1/search/{id} for free pagination.
      */
-    avatar_url?: string | null;
+    search_id: string;
     /**
-     * Creator's biography or description text. May be aggregated from multiple
-     * platforms. null if unavailable.
+     * Total number of results across all pages
      */
-    bio?: string | null;
+    total: number;
 }
-export declare namespace SearchItem {
-    /**
-     * AI-powered recommendation analysis explaining why this creator matches your
-     * query
-     */
-    interface AIRecommendation {
+export declare namespace SearchCreateResponse {
+    interface Data {
         /**
-         * Human-readable explanation of why this creator was recommended. Highlights key
-         * matching factors from the query.
+         * Basic creator information
          */
-        explanation: string;
+        creator: Shared.CreatorBasic;
         /**
-         * Relevance score from 0 to 1, where 1 is a perfect match. Scores above 0.7
-         * indicate strong relevance.
+         * Search match information
          */
-        score: number;
+        match: SearchAPI.MatchInfo;
         /**
-         * Fact-level evidence from hybrid search explaining why this creator matched. Each
-         * fact represents specific, verifiable information about the creator.
+         * Abbreviated profile information
          */
-        evidence?: Array<AIRecommendation.Evidence>;
-    }
-    namespace AIRecommendation {
+        primary_profile: Shared.ProfileSummary | null;
         /**
-         * Individual fact from hybrid search providing evidence for why a creator matched.
-         * Facts are specific, verifiable pieces of information extracted from creator
-         * data.
+         * Abbreviated profile information
          */
-        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>;
-        }
+        relevant_profile: Shared.ProfileSummary | null;
     }
 }
-export interface SearchFindCreatorsResponse {
+export interface SearchRetrieveResponse {
+    /**
+     * Basic creator information
+     */
+    creator: Shared.CreatorBasic;
     /**
-     * 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.
+     * Search match information
      */
-    filtered_total?: number;
+    match: MatchInfo;
     /**
-     * Whether there are more results available for pagination. If true, use the
-     * `next_cursor` value in your next request.
+     * Abbreviated profile information
      */
-    has_more?: boolean;
-    items?: Array<SearchItem>;
+    primary_profile: Shared.ProfileSummary | null;
     /**
-     * Opaque cursor for fetching the next page of results. Pass this value as the
-     * `cursor` query parameter. Only present when `has_more` is true.
+     * Abbreviated profile information
      */
-    next_cursor?: string;
+    relevant_profile: Shared.ProfileSummary | null;
 }
-export interface SearchFindCreatorsParams {
+export interface SearchCreateParams {
     /**
-     * Body param: Natural language search query
+     * Natural language search query
      */
     query: string;
     /**
-     * Query param: Opaque pagination cursor from previous response's `next_cursor`. Do
-     * not construct manually.
+     * Additional filters
      */
-    cursor?: string;
+    filters?: SearchCreateParams.Filters;
     /**
-     * Query param: Maximum number of results to return
+     * Maximum 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.
+     * Filter results to specific platforms
      */
-    include_platforms?: Array<'instagram' | 'tiktok'>;
+    platforms?: Array<'instagram'>;
+}
+export declare namespace SearchCreateParams {
     /**
-     * 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).
+     * Additional filters
      */
-    mode?: 'lite' | 'detailed';
-}
-export declare namespace SearchFindCreatorsParams {
     interface Filters {
         /**
-         * Per-platform filter definitions
+         * Filter by engagement rate
+         */
+        engagement_rate?: Filters.EngagementRate;
+        /**
+         * Filter by follower count
          */
-        platform_filters?: Array<Filters.PlatformFilter>;
+        followers?: Filters.Followers;
         /**
-         * How to combine platform_filters. `OR` = creator matches ANY platform filter.
-         * `AND` = creator must match ALL platform filters. Default: OR.
+         * Filter by verified status
          */
-        platform_logic?: 'AND' | 'OR';
+        verified?: boolean;
     }
     namespace Filters {
-        interface PlatformFilter {
-            platform: 'instagram' | 'tiktok';
-            max_engagement_rate?: number;
-            max_followers?: number;
-            min_engagement_rate?: number;
-            min_followers?: number;
-            verified_only?: boolean;
+        /**
+         * Filter by engagement rate
+         */
+        interface EngagementRate {
+            /**
+             * Maximum engagement rate (%)
+             */
+            max?: number;
+            /**
+             * Minimum engagement rate (%)
+             */
+            min?: number;
+        }
+        /**
+         * Filter by follower count
+         */
+        interface Followers {
+            /**
+             * Maximum follower count
+             */
+            max?: number;
+            /**
+             * Minimum follower count
+             */
+            min?: number;
         }
     }
 }
+export interface SearchRetrieveParams extends QueryCursorParams {
+}
 export declare namespace Search {
-    export { type SearchItem as SearchItem, type SearchFindCreatorsResponse as SearchFindCreatorsResponse, type SearchFindCreatorsParams as SearchFindCreatorsParams, };
+    export { type MatchInfo as MatchInfo, type SearchCreateResponse as SearchCreateResponse, type SearchRetrieveResponse as SearchRetrieveResponse, type SearchRetrieveResponsesQueryCursor as SearchRetrieveResponsesQueryCursor, type SearchCreateParams as SearchCreateParams, type SearchRetrieveParams as SearchRetrieveParams, };
 }
 //# sourceMappingURL=search.d.ts.map