influship 0.2.0 → 0.3.2

package/src/resources/health.ts

@@ -4,18 +4,30 @@ import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 
+/**
+ * API health and status endpoints
+ */
 export class Health extends APIResource {
   /**
-   * Check the health status of the API
+   * Check API health status. No authentication required.
    */
   check(options?: RequestOptions): APIPromise<HealthCheckResponse> {
     return this._client.get('/health', options);
   }
 }
 
+/**
+ * Health check response
+ */
 export interface HealthCheckResponse {
+  /**
+   * Service health status
+   */
   ok: boolean;
 
+  /**
+   * Current server timestamp
+   */
   timestamp: string;
 }
 

package/src/resources/index.ts

@@ -1,62 +1,43 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export {
-  BrandSafety,
-  type BrandSafetyAnalysis,
-  type BrandSafetyFlag,
-  type BrandSafetyResult,
-  type BrandSafetyAnalyzeCreatorsResponse,
-  type BrandSafetyAnalyzePostsResponse,
-  type BrandSafetyAnalyzeProfilesResponse,
-  type BrandSafetyAnalyzeCreatorsParams,
-  type BrandSafetyAnalyzePostsParams,
-  type BrandSafetyAnalyzeProfilesParams,
-} from './brand-safety';
+export * from './shared';
 export {
   Creators,
-  type Creator,
-  type CreatorAutocomplete,
-  type SocialAccountDetailed,
-  type SocialAccountLite,
   type CreatorRetrieveResponse,
   type CreatorAutocompleteResponse,
-  type CreatorListProfilesResponse,
+  type CreatorLookalikeResponse,
+  type CreatorMatchResponse,
   type CreatorRetrieveParams,
   type CreatorAutocompleteParams,
-  type CreatorListProfilesParams,
+  type CreatorLookalikeParams,
+  type CreatorMatchParams,
+  type CreatorLookalikeResponsesBodyCursor,
 } from './creators';
 export { Health, type HealthCheckResponse } from './health';
-export {
-  Lookalike,
-  type LookalikeSeedBase,
-  type LookalikeFindSimilarCreatorsResponse,
-  type LookalikeFindSimilarCreatorsParams,
-} from './lookalike';
-export {
-  Match,
-  type CreatorReferenceByID,
-  type MatchResult,
-  type MatchAnalyzeResponse,
-  type MatchAnalyzeParams,
-} from './match';
 export {
   Posts,
-  type AIAnalysis,
-  type CursorPagination,
-  type PostAnalysis,
-  type PostListByCreatorResponse,
-  type PostAnalyzeParams,
-  type PostListByCreatorParams,
+  type PostListResponse,
+  type PostListParams,
+  type PostListResponsesQueryCursor,
 } from './posts';
 export {
   Profiles,
-  type CreatorReferenceByHandle,
+  type ProfileActivity,
+  type ProfileGrowth,
+  type ProfileMetrics,
+  type ProfileResponseData,
+  type ProfileGetResponse,
   type ProfileLookupResponse,
+  type ProfileGetParams,
   type ProfileLookupParams,
 } from './profiles';
+export { Raw } from './raw/raw';
 export {
   Search,
-  type SearchItem,
-  type SearchFindCreatorsResponse,
-  type SearchFindCreatorsParams,
+  type MatchInfo,
+  type SearchCreateResponse,
+  type SearchRetrieveResponse,
+  type SearchCreateParams,
+  type SearchRetrieveParams,
+  type SearchRetrieveResponsesQueryCursor,
 } from './search';

package/src/resources/posts.ts

@@ -1,347 +1,204 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
-import * as BrandSafetyAPI from './brand-safety';
-import { APIPromise } from '../core/api-promise';
+import { PagePromise, QueryCursor, type QueryCursorParams } from '../core/pagination';
 import { RequestOptions } from '../internal/request-options';
 
+/**
+ * Retrieve and analyze social media posts with engagement metrics, media content, and performance data.
+ */
 export class Posts extends APIResource {
   /**
-   * Analyze a social media post for engagement metrics, content insights, and brand
-   * safety.
+   * Retrieve posts for a creator or profile with engagement metrics and media data.
    *
-   * Provide post via URL or post_id+platform. Optionally include AI analysis and/or
-   * brand safety features.
+   * **Query options:**
    *
-   * **Pricing**:
+   * - By creator: Use `creator_id` to get posts across all their profiles
+   * - By profile: Use `platform` + `username` for a specific profile's posts
    *
-   * - 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
+   * **Sort options:**
    *
-   * @example
-   * ```ts
-   * const postAnalysis = await client.posts.analyze({
-   *   url: 'https://example.com',
-   * });
-   * ```
-   */
-  analyze(body: PostAnalyzeParams, options?: RequestOptions): APIPromise<PostAnalysis> {
-    return this._client.post('/v1/posts/analyze', { body, ...options });
-  }
-
-  /**
-   * Retrieve posts for a specific creator using cursor-based pagination.
+   * - `recent`: Most recent posts first (default)
+   * - `top_engagement`: Highest engagement rate first
+   * - `most_likes`: Most likes first
+   * - `most_views`: Most views first (video content)
+   * - `most_comments`: Most comments first
    *
-   * 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();
-   * ```
+   * **Pricing**: 0.05 credits per post returned ($0.0005)
    */
-  listByCreator(
-    query: PostListByCreatorParams | null | undefined = {},
+  list(
+    query: PostListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<PostListByCreatorResponse> {
-    return this._client.get('/v1/posts/by-creator', { query, ...options });
+  ): PagePromise<PostListResponsesQueryCursor, PostListResponse> {
+    return this._client.getAPIList('/v1/posts', QueryCursor<PostListResponse>, { query, ...options });
   }
 }
 
-/**
- * AI-powered content analysis. Only present when `ai_analysis` feature is
- * requested.
- */
-export interface AIAnalysis {
-  /**
-   * AI-generated summary describing key themes, topics, and messaging.
-   */
-  summary: string;
-
-  /**
-   * Transcription of spoken words in video. null for photo posts or videos without
-   * speech.
-   */
-  transcript?: string | null;
-}
+export type PostListResponsesQueryCursor = QueryCursor<PostListResponse>;
 
 /**
- * Cursor-based pagination metadata. Use this to navigate through paginated results
- * efficiently.
+ * Full post details
  */
-export interface CursorPagination {
-  /**
-   * Indicates whether more results are available.
-   *
-   * - `true`: Additional pages exist, use the `cursor` to fetch them
-   * - `false`: This is the last page of results
-   */
-  has_more: boolean;
-
+export interface PostListResponse {
   /**
-   * Opaque base64-encoded cursor string for fetching the next page. Pass this value
-   * as the `cursor` query parameter in your next request. null when `has_more` is
-   * false (no more pages available). Do not attempt to decode or construct cursor
-   * values manually.
-   */
-  cursor?: string | null;
-}
-
-/**
- * Analysis result for a single social media post
- */
-export interface PostAnalysis {
-  /**
-   * Internal post ID
+   * Post unique identifier
    */
   id: string;
 
   /**
-   * Creator information for a post
-   */
-  creator: PostAnalysis.Creator;
-
-  /**
-   * Whether this post contains video content. true for video posts and reels, false
-   * for photo posts.
-   */
-  is_video: boolean;
-
-  /**
-   * URL of the primary media file (image or video). For carousel posts, this is the
-   * first item.
-   */
-  media_url: string;
-
-  /**
-   * Social media platform
-   */
-  platform: 'instagram' | 'tiktok';
-
-  /**
-   * Platform-specific unique identifier for this post. Format varies by platform
-   * (Instagram: numeric ID, TikTok: alphanumeric).
-   */
-  platform_post_id: string;
-
-  /**
-   * ISO 8601 timestamp when the post was originally published.
-   */
-  posted_at: string;
-
-  /**
-   * Alt text or accessibility caption describing the media. Useful for understanding
-   * image content. null if unavailable.
+   * Post caption
    */
-  accessibility_caption?: string | null;
+  caption: string | null;
 
   /**
-   * AI-powered content analysis. Only present when `ai_analysis` feature is
-   * requested.
+   * Hashtags used in the post
    */
-  ai_analysis?: AIAnalysis;
+  hashtags: Array<string>;
 
   /**
-   * Brand safety analysis results
+   * Post location information
    */
-  brand_safety?: BrandSafetyAPI.BrandSafetyAnalysis;
+  location: PostListResponse.Location | null;
 
   /**
-   * Post caption text written by the creator. null if no caption was provided.
+   * Post media information
    */
-  caption?: string | null;
+  media: PostListResponse.Media;
 
   /**
-   * Total comments on post. null if unavailable.
+   * Usernames mentioned in the post
    */
-  comments_count?: number | null;
+  mentions: Array<string>;
 
   /**
-   * Total likes on post. null if platform hides like counts or data unavailable.
+   * Post engagement metrics
    */
-  likes_count?: number | null;
+  metrics: PostListResponse.Metrics;
 
   /**
-   * Array of all media URLs in this post. Contains multiple items for carousel
-   * posts, single item for regular posts.
+   * Social media platform
    */
-  media_urls?: Array<string>;
+  platform: 'instagram';
 
   /**
-   * ISO 8601 timestamp when we last scraped/updated this post's data. Metrics are
-   * accurate as of this time.
+   * Platform-specific post ID
    */
-  scraped_at?: string;
+  platform_id: string;
 
   /**
-   * Instagram shortcode used in post URLs (instagram.com/p/{shortcode}). Only
-   * present for Instagram posts, null for other platforms.
+   * Post timestamp
    */
-  shortcode?: string | null;
+  posted_at: string;
 
   /**
-   * Thumbnail image URL for video posts. Only present when is_video is true, null
-   * for photo posts.
+   * Profile unique identifier
    */
-  thumbnail_url?: string | null;
+  profile_id: string;
 
   /**
-   * Video length in seconds. null for photo posts.
+   * Type of post
    */
-  video_duration_seconds?: number | null;
+  type: 'image' | 'video' | 'carousel' | 'reel' | 'story';
 
   /**
-   * Video view count. null for photo posts or if unavailable.
+   * Post URL
    */
-  video_view_count?: number | null;
+  url: string;
 }
 
-export namespace PostAnalysis {
+export namespace PostListResponse {
   /**
-   * Creator information for a post
+   * Post location information
    */
-  export interface Creator {
-    /**
-     * Creator UUID
-     */
-    id: string;
-
+  export interface Location {
     /**
-     * Social media platform
+     * Location name
      */
-    platform: 'instagram' | 'tiktok';
-
-    /**
-     * Social media username
-     */
-    username: string;
+    name: string | null;
   }
-}
-
-/**
- * Response for getting posts by creator
- */
-export interface PostListByCreatorResponse {
-  /**
-   * Cursor-based pagination metadata. Use this to navigate through paginated results
-   * efficiently.
-   */
-  pagination: CursorPagination;
 
   /**
-   * Array of posts
+   * Post media information
    */
-  posts: Array<PostAnalysis>;
-}
-
-export type PostAnalyzeParams = PostAnalyzeParams.Variant0 | PostAnalyzeParams.Variant1;
-
-export declare namespace PostAnalyzeParams {
-  export interface Variant0 {
+  export interface Media {
     /**
-     * Public URL of the post to analyze
+     * Video duration in seconds
      */
-    url: string;
+    duration_seconds: number | null;
 
     /**
-     * Analysis features to include
+     * Thumbnail URL
      */
-    features?: Array<'ai_analysis' | 'brand_safety'>;
+    thumbnail_url: string | null;
 
     /**
-     * Social media platform (required when using post_id)
+     * Media URL
      */
-    platform?: 'instagram' | 'tiktok';
+    url: string | null;
 
     /**
-     * Platform-specific post ID
+     * Video URL (for video content)
      */
-    post_id?: string;
+    video_url: string | null;
   }
 
-  export interface Variant1 {
+  /**
+   * Post engagement metrics
+   */
+  export interface Metrics {
+    /**
+     * Comment count
+     */
+    comments: number | null;
+
     /**
-     * Social media platform
+     * Engagement rate for this post as a percentage (e.g. 3.8 means 3.8%)
      */
-    platform: 'instagram' | 'tiktok';
+    engagement_rate: number | null;
 
     /**
-     * Platform-specific post ID
+     * Like count
      */
-    post_id: string;
+    likes: number | null;
 
     /**
-     * Analysis features to include
+     * Share count
      */
-    features?: Array<'ai_analysis' | 'brand_safety'>;
+    shares: number | null;
 
     /**
-     * Public URL of the post to analyze
+     * View count (for video content)
      */
-    url?: string;
+    views: number | null;
   }
 }
 
-export interface PostListByCreatorParams {
+export interface PostListParams extends QueryCursorParams {
   /**
-   * Creator UUID
+   * Creator ID (use this OR platform+username)
    */
   creator_id?: string;
 
   /**
-   * Opaque pagination cursor from previous response. Do not construct manually.
-   */
-  cursor?: string;
-
-  /**
-   * Start date for filtering posts (ISO 8601)
+   * Platform (required with username)
    */
-  date_from?: string;
+  platform?: 'instagram';
 
   /**
-   * End date for filtering posts (ISO 8601)
-   */
-  date_to?: string;
-
-  /**
-   * Optional analysis features. `ai_analysis` adds summary/transcript.
-   * `brand_safety` adds rating/flags. Each feature has additional cost.
-   */
-  features?: Array<'ai_analysis' | 'brand_safety'>;
-
-  /**
-   * Number of posts per page. Min 1, max 100, default 25.
-   */
-  limit?: number;
-
-  /**
-   * Social media platform
+   * Sort order
    */
-  platform?: 'instagram' | 'tiktok';
+  sort?: 'recent' | 'top_engagement' | 'most_likes' | 'most_views' | 'most_comments';
 
   /**
-   * Social media username
+   * Username (required with platform)
    */
   username?: string;
 }
 
 export declare namespace Posts {
   export {
-    type AIAnalysis as AIAnalysis,
-    type CursorPagination as CursorPagination,
-    type PostAnalysis as PostAnalysis,
-    type PostListByCreatorResponse as PostListByCreatorResponse,
-    type PostAnalyzeParams as PostAnalyzeParams,
-    type PostListByCreatorParams as PostListByCreatorParams,
+    type PostListResponse as PostListResponse,
+    type PostListResponsesQueryCursor as PostListResponsesQueryCursor,
+    type PostListParams as PostListParams,
   };
 }