influship 0.2.0 → 0.3.2

package/resources/profiles.d.mts

@@ -1,99 +1,249 @@
 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";
+/**
+ * Access individual social media profiles with detailed metrics, growth data, and activity information. Profiles are platform-specific accounts linked to creators.
+ */
 export declare class Profiles extends APIResource {
     /**
-     * **DISCOVERY ENDPOINT**: Look up social account data when you know a username and
-     * platform.
+     * Retrieve detailed profile data including metrics, growth statistics, and
+     * activity information from our database.
      *
-     * **🎯 When to use this endpoint:**
+     * **Response includes:**
      *
-     * - ✅ 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
+     * - Basic info (bio, avatar, verification status)
+     * - Performance metrics (followers, engagement rate, avg likes/comments)
+     * - Growth data (30-day follower growth, monthly rate)
+     * - Activity data (last post date, posting frequency)
      *
-     * **❌ When NOT to use this endpoint:**
+     * **Pricing**: 0.1 credits per request ($0.001)
      *
-     * - ❌ 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:**
+     * @example
+     * ```ts
+     * const profile = await client.profiles.get(
+     *   'fitness_coach_jane',
+     *   { platform: 'instagram' },
+     * );
+     * ```
+     */
+    get(username: string, params: ProfileGetParams, options?: RequestOptions): APIPromise<ProfileGetResponse>;
+    /**
+     * Look up multiple profiles in a single request. Efficiently retrieve data for up
+     * to 100 profiles at once.
      *
-     * 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
+     * **Response includes:**
      *
-     * **⚙️ Parameters:**
+     * - `found`: Array of profiles that exist in our database
+     * - `not_found`: Array of profiles that weren't found (consider live scraping
+     *   these)
      *
-     * - `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)
+     * **Pricing**: 0.1 credits per profile ($0.001)
      *
      * @example
      * ```ts
      * const response = await client.profiles.lookup({
      *   profiles: [
-     *     { platform: 'instagram', username: 'fitness_guru' },
-     *     { platform: 'tiktok', username: 'fitness_guru' },
+     *     {
+     *       platform: 'instagram',
+     *       username: 'fitness_coach_jane',
+     *     },
      *   ],
      * });
      * ```
      */
     lookup(body: ProfileLookupParams, options?: RequestOptions): APIPromise<ProfileLookupResponse>;
 }
-export interface CreatorReferenceByHandle {
+/**
+ * Profile activity information
+ */
+export interface ProfileActivity {
+    /**
+     * Timestamp of last post
+     */
+    last_post_at: string | null;
+}
+/**
+ * Profile growth statistics
+ */
+export interface ProfileGrowth {
+    /**
+     * Follower growth percentage over 30 days (e.g. 2.5 means +2.5%)
+     */
+    followers_30d_pct: number;
+}
+/**
+ * Profile performance metrics
+ */
+export interface ProfileMetrics {
+    /**
+     * Average comments on recent posts
+     */
+    avg_comments_recent: number;
+    /**
+     * Average likes on recent posts
+     */
+    avg_likes_recent: number;
+    /**
+     * Average views on recent posts (for video content)
+     */
+    avg_views_recent: number | null;
+    /**
+     * Engagement rate as a percentage (e.g. 3.5 means 3.5%)
+     */
+    engagement_rate: number;
+    /**
+     * Follower count
+     */
+    followers: number;
+    /**
+     * Following count
+     */
+    following: number;
+    /**
+     * Total post count
+     */
+    posts: number;
+    /**
+     * Posts in the last 30 days
+     */
+    posts_last_30d: number;
+    /**
+     * Average posts per week
+     */
+    posts_per_week: number;
+}
+/**
+ * Full profile details
+ */
+export interface ProfileResponseData {
+    /**
+     * Profile unique identifier
+     */
+    id: string;
+    /**
+     * Profile activity information
+     */
+    activity: ProfileActivity;
+    /**
+     * Avatar URL
+     */
+    avatar_url: string | null;
     /**
-     * Social platform where the creator exists
+     * Profile bio
      */
-    platform: 'instagram' | 'tiktok';
+    bio: string | null;
     /**
-     * Username on the platform
+     * Account category
+     */
+    category: string | null;
+    /**
+     * Creator unique identifier
+     */
+    creator_id: string;
+    /**
+     * Last data refresh timestamp
+     */
+    data_updated_at: string | null;
+    /**
+     * Display name
+     */
+    display_name: string | null;
+    /**
+     * External website URL from bio
+     */
+    external_url: string | null;
+    /**
+     * Profile growth statistics
+     */
+    growth: ProfileGrowth;
+    /**
+     * Whether this is a business account
+     */
+    is_business: boolean;
+    /**
+     * Whether the account is private
+     */
+    is_private: boolean;
+    /**
+     * Whether the account is verified
+     */
+    is_verified: boolean;
+    /**
+     * Profile performance metrics
+     */
+    metrics: ProfileMetrics;
+    /**
+     * Social media platform
+     */
+    platform: 'instagram';
+    /**
+     * Listed pronouns
+     */
+    pronouns: Array<string> | null;
+    /**
+     * Profile URL
+     */
+    url: string;
+    /**
+     * Profile username
      */
     username: string;
 }
+export interface ProfileGetResponse {
+    /**
+     * Full profile details
+     */
+    data: ProfileResponseData;
+    /**
+     * Present when partial results were returned because profile metrics/data were
+     * skipped due to integrity issues.
+     */
+    warning?: 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 that were found
      */
-    profiles?: Array<CreatorsAPI.SocialAccountLite | CreatorsAPI.SocialAccountDetailed>;
+    data: Array<ProfileResponseData>;
+    /**
+     * Profiles that were not found
+     */
+    not_found: Array<ProfileLookupResponse.NotFound>;
 }
-export interface ProfileLookupParams {
-    profiles: Array<CreatorReferenceByHandle>;
+export declare namespace ProfileLookupResponse {
+    interface NotFound {
+        /**
+         * Social media platform
+         */
+        platform: 'instagram';
+        username: string;
+    }
+}
+export interface ProfileGetParams {
     /**
-     * Response detail level - lite for basic fields, detailed for additional metrics
+     * Platform name
      */
-    mode?: 'lite' | 'detailed';
+    platform: string;
+}
+export interface ProfileLookupParams {
     /**
-     * Filter results to only include these platforms
+     * Profiles to lookup
      */
-    platforms?: Array<'instagram' | 'tiktok'>;
+    profiles: Array<ProfileLookupParams.Profile>;
+}
+export declare namespace ProfileLookupParams {
+    interface Profile {
+        /**
+         * Social media platform
+         */
+        platform: 'instagram';
+        /**
+         * Username to lookup
+         */
+        username: string;
+    }
 }
 export declare namespace Profiles {
-    export { type CreatorReferenceByHandle as CreatorReferenceByHandle, type ProfileLookupResponse as ProfileLookupResponse, type ProfileLookupParams as ProfileLookupParams, };
+    export { type ProfileActivity as ProfileActivity, type ProfileGrowth as ProfileGrowth, type ProfileMetrics as ProfileMetrics, type ProfileResponseData as ProfileResponseData, type ProfileGetResponse as ProfileGetResponse, type ProfileLookupResponse as ProfileLookupResponse, type ProfileGetParams as ProfileGetParams, type ProfileLookupParams as ProfileLookupParams, };
 }
 //# sourceMappingURL=profiles.d.mts.map

package/resources/profiles.d.mts.map

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

package/resources/profiles.d.ts

@@ -1,99 +1,249 @@
 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";
+/**
+ * Access individual social media profiles with detailed metrics, growth data, and activity information. Profiles are platform-specific accounts linked to creators.
+ */
 export declare class Profiles extends APIResource {
     /**
-     * **DISCOVERY ENDPOINT**: Look up social account data when you know a username and
-     * platform.
+     * Retrieve detailed profile data including metrics, growth statistics, and
+     * activity information from our database.
      *
-     * **🎯 When to use this endpoint:**
+     * **Response includes:**
      *
-     * - ✅ 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
+     * - Basic info (bio, avatar, verification status)
+     * - Performance metrics (followers, engagement rate, avg likes/comments)
+     * - Growth data (30-day follower growth, monthly rate)
+     * - Activity data (last post date, posting frequency)
      *
-     * **❌ When NOT to use this endpoint:**
+     * **Pricing**: 0.1 credits per request ($0.001)
      *
-     * - ❌ 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:**
+     * @example
+     * ```ts
+     * const profile = await client.profiles.get(
+     *   'fitness_coach_jane',
+     *   { platform: 'instagram' },
+     * );
+     * ```
+     */
+    get(username: string, params: ProfileGetParams, options?: RequestOptions): APIPromise<ProfileGetResponse>;
+    /**
+     * Look up multiple profiles in a single request. Efficiently retrieve data for up
+     * to 100 profiles at once.
      *
-     * 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
+     * **Response includes:**
      *
-     * **⚙️ Parameters:**
+     * - `found`: Array of profiles that exist in our database
+     * - `not_found`: Array of profiles that weren't found (consider live scraping
+     *   these)
      *
-     * - `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)
+     * **Pricing**: 0.1 credits per profile ($0.001)
      *
      * @example
      * ```ts
      * const response = await client.profiles.lookup({
      *   profiles: [
-     *     { platform: 'instagram', username: 'fitness_guru' },
-     *     { platform: 'tiktok', username: 'fitness_guru' },
+     *     {
+     *       platform: 'instagram',
+     *       username: 'fitness_coach_jane',
+     *     },
      *   ],
      * });
      * ```
      */
     lookup(body: ProfileLookupParams, options?: RequestOptions): APIPromise<ProfileLookupResponse>;
 }
-export interface CreatorReferenceByHandle {
+/**
+ * Profile activity information
+ */
+export interface ProfileActivity {
+    /**
+     * Timestamp of last post
+     */
+    last_post_at: string | null;
+}
+/**
+ * Profile growth statistics
+ */
+export interface ProfileGrowth {
+    /**
+     * Follower growth percentage over 30 days (e.g. 2.5 means +2.5%)
+     */
+    followers_30d_pct: number;
+}
+/**
+ * Profile performance metrics
+ */
+export interface ProfileMetrics {
+    /**
+     * Average comments on recent posts
+     */
+    avg_comments_recent: number;
+    /**
+     * Average likes on recent posts
+     */
+    avg_likes_recent: number;
+    /**
+     * Average views on recent posts (for video content)
+     */
+    avg_views_recent: number | null;
+    /**
+     * Engagement rate as a percentage (e.g. 3.5 means 3.5%)
+     */
+    engagement_rate: number;
+    /**
+     * Follower count
+     */
+    followers: number;
+    /**
+     * Following count
+     */
+    following: number;
+    /**
+     * Total post count
+     */
+    posts: number;
+    /**
+     * Posts in the last 30 days
+     */
+    posts_last_30d: number;
+    /**
+     * Average posts per week
+     */
+    posts_per_week: number;
+}
+/**
+ * Full profile details
+ */
+export interface ProfileResponseData {
+    /**
+     * Profile unique identifier
+     */
+    id: string;
+    /**
+     * Profile activity information
+     */
+    activity: ProfileActivity;
+    /**
+     * Avatar URL
+     */
+    avatar_url: string | null;
     /**
-     * Social platform where the creator exists
+     * Profile bio
      */
-    platform: 'instagram' | 'tiktok';
+    bio: string | null;
     /**
-     * Username on the platform
+     * Account category
+     */
+    category: string | null;
+    /**
+     * Creator unique identifier
+     */
+    creator_id: string;
+    /**
+     * Last data refresh timestamp
+     */
+    data_updated_at: string | null;
+    /**
+     * Display name
+     */
+    display_name: string | null;
+    /**
+     * External website URL from bio
+     */
+    external_url: string | null;
+    /**
+     * Profile growth statistics
+     */
+    growth: ProfileGrowth;
+    /**
+     * Whether this is a business account
+     */
+    is_business: boolean;
+    /**
+     * Whether the account is private
+     */
+    is_private: boolean;
+    /**
+     * Whether the account is verified
+     */
+    is_verified: boolean;
+    /**
+     * Profile performance metrics
+     */
+    metrics: ProfileMetrics;
+    /**
+     * Social media platform
+     */
+    platform: 'instagram';
+    /**
+     * Listed pronouns
+     */
+    pronouns: Array<string> | null;
+    /**
+     * Profile URL
+     */
+    url: string;
+    /**
+     * Profile username
      */
     username: string;
 }
+export interface ProfileGetResponse {
+    /**
+     * Full profile details
+     */
+    data: ProfileResponseData;
+    /**
+     * Present when partial results were returned because profile metrics/data were
+     * skipped due to integrity issues.
+     */
+    warning?: 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 that were found
      */
-    profiles?: Array<CreatorsAPI.SocialAccountLite | CreatorsAPI.SocialAccountDetailed>;
+    data: Array<ProfileResponseData>;
+    /**
+     * Profiles that were not found
+     */
+    not_found: Array<ProfileLookupResponse.NotFound>;
 }
-export interface ProfileLookupParams {
-    profiles: Array<CreatorReferenceByHandle>;
+export declare namespace ProfileLookupResponse {
+    interface NotFound {
+        /**
+         * Social media platform
+         */
+        platform: 'instagram';
+        username: string;
+    }
+}
+export interface ProfileGetParams {
     /**
-     * Response detail level - lite for basic fields, detailed for additional metrics
+     * Platform name
      */
-    mode?: 'lite' | 'detailed';
+    platform: string;
+}
+export interface ProfileLookupParams {
     /**
-     * Filter results to only include these platforms
+     * Profiles to lookup
      */
-    platforms?: Array<'instagram' | 'tiktok'>;
+    profiles: Array<ProfileLookupParams.Profile>;
+}
+export declare namespace ProfileLookupParams {
+    interface Profile {
+        /**
+         * Social media platform
+         */
+        platform: 'instagram';
+        /**
+         * Username to lookup
+         */
+        username: string;
+    }
 }
 export declare namespace Profiles {
-    export { type CreatorReferenceByHandle as CreatorReferenceByHandle, type ProfileLookupResponse as ProfileLookupResponse, type ProfileLookupParams as ProfileLookupParams, };
+    export { type ProfileActivity as ProfileActivity, type ProfileGrowth as ProfileGrowth, type ProfileMetrics as ProfileMetrics, type ProfileResponseData as ProfileResponseData, type ProfileGetResponse as ProfileGetResponse, type ProfileLookupResponse as ProfileLookupResponse, type ProfileGetParams as ProfileGetParams, type ProfileLookupParams as ProfileLookupParams, };
 }
 //# sourceMappingURL=profiles.d.ts.map

package/resources/profiles.d.ts.map

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