influship 0.3.3 → 0.10.1

package/src/resources/creators.ts

@@ -23,19 +23,21 @@ export class Creators extends APIResource {
    *
    * - `profiles`: Include all linked social profiles with metrics
    *
+   * Also callable as the `get_creator` MCP tool — see
+   * [the MCP server guide](/guides/mcp-server) for setup.
+   *
    * **Pricing**: 0.1 credits per request ($0.001)
    *
    * @example
    * ```ts
    * const creator = await client.creators.retrieve(
    *   '123e4567-e89b-12d3-a456-426614174000',
-   *   { include: ['profiles'] },
    * );
    * ```
    */
   retrieve(
     id: string,
-    query: CreatorRetrieveParams,
+    query: CreatorRetrieveParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<CreatorRetrieveResponse> {
     return this._client.get(path`/v1/creators/${id}`, { query, ...options });
@@ -57,6 +59,9 @@ export class Creators extends APIResource {
    * - `matched_platforms`: Return only profiles that matched the query
    * - `all_platforms`: Return all linked profiles (default)
    *
+   * Also callable as the `autocomplete_creators` MCP tool — see
+   * [the MCP server guide](/guides/mcp-server) for setup.
+   *
    * **Pricing**: 0.05 credits per request ($0.0005)
    *
    * @example
@@ -90,6 +95,9 @@ export class Creators extends APIResource {
    * 2. Optionally weight seeds to prioritize certain creators
    * 3. Get ranked results with similarity scores and shared traits
    *
+   * Also callable as the `find_lookalike_creators` MCP tool — see
+   * [the MCP server guide](/guides/mcp-server) for setup.
+   *
    * **Pricing**: 1.5 credits per creator returned ($0.015)
    *
    * @example
@@ -130,15 +138,17 @@ export class Creators extends APIResource {
    * 2. Provide up to 100 creators to evaluate
    * 3. Get detailed scores with explanations and evidence
    *
+   * Also callable as the `match_creators` MCP tool — see
+   * [the MCP server guide](/guides/mcp-server) for setup.
+   *
    * **Pricing**: 1 credit per creator scored ($0.01)
    *
    * @example
    * ```ts
    * const response = await client.creators.match({
-   *   creators: [{}],
+   *   creators: [{}, {}],
    *   intent: {
-   *     query:
-   *       'Looking for fitness influencers to promote our new protein bar',
+   *     query: 'Promote our new plant-based protein powder',
    *   },
    * });
    * ```
@@ -178,6 +188,11 @@ export namespace CreatorRetrieveResponse {
      */
     ai_summary: string | null;
 
+    /**
+     * Synthesized audience demographic summary
+     */
+    audience_demographics: string | null;
+
     /**
      * Avatar URL
      */
@@ -188,16 +203,31 @@ export namespace CreatorRetrieveResponse {
      */
     bio: string | null;
 
+    /**
+     * Brand categories this creator is likely to align with
+     */
+    brand_alignment: Array<string>;
+
     /**
      * Content themes/topics
      */
     content_themes: Array<string>;
 
+    /**
+     * Synthesized facts and notable context about the creator
+     */
+    key_facts: Array<string>;
+
     /**
      * Creator display name
      */
     name: string;
 
+    /**
+     * Synthesized description of visual style and tone
+     */
+    vibe_and_aesthetics: string | null;
+
     /**
      * Social profiles (only included when include=profiles)
      */
@@ -368,7 +398,7 @@ export interface CreatorRetrieveParams {
   /**
    * Additional data to include in response
    */
-  include: Array<'profiles'>;
+  include?: Array<'profiles'>;
 }
 
 export interface CreatorAutocompleteParams {

package/src/resources/posts.ts

@@ -24,6 +24,9 @@ export class Posts extends APIResource {
    * - `most_views`: Most views first (video content)
    * - `most_comments`: Most comments first
    *
+   * Also callable as the `get_posts` MCP tool — see
+   * [the MCP server guide](/guides/mcp-server) for setup.
+   *
    * **Pricing**: 0.05 credits per post returned ($0.0005)
    */
   list(

package/src/resources/profiles.ts

@@ -20,6 +20,9 @@ export class Profiles extends APIResource {
    * - Growth data (30-day follower growth, monthly rate)
    * - Activity data (last post date, posting frequency)
    *
+   * Also callable as the `get_profile` MCP tool — see
+   * [the MCP server guide](/guides/mcp-server) for setup.
+   *
    * **Pricing**: 0.1 credits per request ($0.001)
    *
    * @example
@@ -45,6 +48,9 @@ export class Profiles extends APIResource {
    * - `not_found`: Array of profiles that weren't found (consider live scraping
    *   these)
    *
+   * Also callable as the `lookup_profiles` MCP tool — see
+   * [the MCP server guide](/guides/mcp-server) for setup.
+   *
    * **Pricing**: 0.1 credits per profile ($0.001)
    *
    * @example
@@ -55,6 +61,11 @@ export class Profiles extends APIResource {
    *       platform: 'instagram',
    *       username: 'fitness_coach_jane',
    *     },
+   *     { platform: 'instagram', username: 'wellness_guru' },
+   *     {
+   *       platform: 'instagram',
+   *       username: 'healthy_eating_tips',
+   *     },
    *   ],
    * });
    * ```

package/src/resources/raw/index.ts

@@ -1,6 +1,19 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Instagram, type InstagramGetProfileResponse, type InstagramGetProfileParams } from './instagram';
+export {
+  Instagram,
+  type InstagramSinglePostResponse,
+  type InstagramTranscriptResponse,
+  type InstagramGetPostResponse,
+  type InstagramGetPostsResponse,
+  type InstagramGetProfileResponse,
+  type InstagramGetTranscriptResponse,
+  type InstagramGetTranscriptsResponse,
+  type InstagramGetPostsParams,
+  type InstagramGetProfileParams,
+  type InstagramGetTranscriptParams,
+  type InstagramGetTranscriptsParams,
+} from './instagram';
 export { Raw } from './raw';
 export {
   Youtube,