# Get collaboration posts

This endpoint returns collaborated posts where influencers mention brands or vice versa.</br> 			Every successful request costs <b>0.2 credit</b>.

Endpoint: POST /collaborations/posts
Security: accessToken

## Request fields (application/json):

  - `id` (string, required)
    User ID / Username / Profile URL, User ID is preferred. For brand collaborations, you can also use the brand ID from Brand Dictionary endpoint, in which case we will return collaborations for all accounts associated with the brand.
    Example: cristiano

  - `platform` (string, required)
    Enum: "instagram", "tiktok", "youtube"

  - `collaboratorId` (string)
    If provided, only returns the collaboration posts between the specified influencer and brand. You can also use the brand ID from Brand Dictionary endpoint, if you want to get collaborations between influencer X (filtered by `id`) and all accounts associated with the brand Y (filtered by `collaboratorId`).

  - `postCreationTimestampMs` (object)
    Filter the posts by creation timestamp in milliseconds
    Example: {"gte":1716835200000}

  - `postCreationTimestampMs.gte` (number)
    Filter posts by creation timestamp in milliseconds greater than or equal to this value

  - `postCreationTimestampMs.lte` (number)
    Filter posts by creation timestamp in milliseconds less than or equal to this value

  - `cursor` (string)
    Cursor for pagination (only valid for 2 days)

  - `limit` (number)
    Number of collaboration posts per page
    Example: 10

  - `groupBrandCollaborations` (boolean)
    If true, brand collaborations will be grouped across all platforms. This provides insights about the brand across all its social accounts.
For example: if you request brand collaborations for @cocacola on Instagram, you will get posts sponsored by Coca Cola on all three platforms (Instagram, Tiktok and Youtube).
In some cases, this may group regional or variant accounts (e.g., @cocacola_uk, @cocacola_us) when they represent the same brand identity. Set this flag to false if social media account-specific insights are needed.
For better grouping, retrieve the brand ID from Brand Dictionary endpoint and use it instead of user ID of a specific social media account.

## Response 200 fields (application/json):

  - `error` (boolean)
    If there is an error
    Example: false

  - `cursor` (string)
    Cursor for pagination (only valid for 2 days)

  - `influencer` (object)
    Only available if the requested profile has influencer collaborations

  - `influencer.id` (string, required)
    User ID / Username / Profile URL
    Example: johndoe

  - `influencer.platform` (string, required)
    Enum: "instagram", "tiktok", "youtube"

  - `influencer.is_more_available` (boolean)
    True if there are more collaboration posts available

  - `influencer.username` (string)
    Username
    Example: username

  - `influencer.user_picture` (string)
    Influencer user picture
    Example: https://images.od.modash.io/c5175c827bcd7fb6e89a53729b1a2347f0c6210f

  - `influencer.posts` (array)
    List of collaboration posts

  - `influencer.posts.post_id` (string, required)
    Post id
    Example: 4333460164

  - `influencer.posts.post_thumbnail` (string)
    Post thumbnail
    Example: https://images.od.modash.io/c5175c827bcd7fb6e89a53729b1a2347f0c6210f

  - `influencer.posts.post_timestamp` (number)
    Post timestamp
    Example: 1729502216000

  - `influencer.posts.title` (string)
    Title
    Example: Title

  - `influencer.posts.description` (string)
    Description
    Example: Description

  - `influencer.posts.label` (string, required)
    Sponsorship category followed by the evidence. Possible categories: 			(1) Properly Disclosed Sponsorship - uses #ad, paid partnership flag, or explicitly indicates a partnership in text (e.g., "I teamed up with X to..."). 			(2) Likely Hidden Sponsorship - no clear disclosures, but other signals indicate a sponsorship (e.g., "Use [CODE] for X% off" or "thanks @brand"). 			(3) Unclear or Vague Sponsorship Hint - a mention/tag of a known sponsor, but without proper disclosures.
    Example: Properly Disclosed Sponsorship: is paid partnership flag

  - `influencer.posts.collaboration_type` (string, required)
    Type of collaboration (if multiple types are relevant, we return the most relevant one)
    Enum: "Paid", "Gifted", "Ambassador", "Affiliate", "Unspecified"

  - `influencer.posts.stats` (object)
    Stats

  - `influencer.posts.stats.likes` (number)
    Likes
    Example: 123

  - `influencer.posts.stats.comments` (number)
    Comments
    Example: 12

  - `influencer.posts.stats.likes_and_views_counts_enabled` (boolean)
    Likes and views counts enabled
    Example: true

  - `influencer.posts.stats.likes_count_enabled` (boolean)
    Likes count enabled
    Example: true

  - `influencer.posts.stats.plays` (number)
    Plays
    Example: 123

  - `influencer.posts.stats.views` (number)
    Views
    Example: 123

  - `influencer.posts.stats.shares` (number)
    Shares
    Example: 123

  - `influencer.posts.stats.views_count_enabled` (boolean)
    Views count enabled
    Example: true

  - `influencer.posts.sponsors` (array)
    Sponsors

  - `influencer.posts.sponsors.name` (string)
    Brand name
    Example: Honda

  - `influencer.posts.sponsors.username` (string)
    Brand username
    Example: honda

  - `influencer.posts.sponsors.domain` (string)
    Brand domain
    Example: honda.com

  - `influencer.posts.sponsors.logo_url` (string)
    Brand logo
    Example: https://images.od.modash.io/739b39affeb633d30a8a4280668605b091af0083

  - `influencer.posts.sponsors.user_id` (string)
    User ID or domain of the influencer
    Example: 1234567890

  - `influencer.posts.sponsors.brand_id` (string)
    User ID or domain of the sponsor

  - `influencer.posts.sponsors.category` (string, required)
    Brand category (if multiple categories are relevant, we return the most relevant one)
    Enum: "Consumer Packaged Goods (CPG)", "Retail", "B2B/Enterprise/Industrial", "Classifieds & Local", "Food Beverage Restaurants", "Healthcare", "Media & Entertainment", "Technology", "Education", "Finance", "Automotive", "Travel", "Others", "Unknown"

  - `brand` (object)
    Only available if the requested profile has brand collaborations

  - `brand.id` (string, required)
    User ID / Username / Profile URL
    Example: johndoe

  - `brand.platform` (string, required)
    Enum: "instagram", "tiktok", "youtube"

  - `brand.is_more_available` (boolean)
    True if there are more collaboration posts available

  - `brand.brand_id` (string)
    Brand identity hash. Multiple sponsor accounts that belong to the same brand share the same brand_id. Use the Brand Dictionary endpoint with this value to retrieve all associated accounts.

  - `brand.brand_name` (string)
    Brand name

  - `brand.brand_domain` (string)
    Brand domain

  - `brand.brand_logo` (string)
    Brand logo

  - `brand.brand_category` (string, required)
    Brand category (if multiple categories are relevant, we return the most relevant one)
    Enum: "Consumer Packaged Goods (CPG)", "Retail", "B2B/Enterprise/Industrial", "Classifieds & Local", "Food Beverage Restaurants", "Healthcare", "Media & Entertainment", "Technology", "Education", "Finance", "Automotive", "Travel", "Others", "Unknown"

  - `brand.posts` (array)
    Posts

  - `brand.posts.post_id` (string, required)
    Post id
    Example: 4333460164

  - `brand.posts.post_thumbnail` (string)
    Post thumbnail
    Example: https://images.od.modash.io/c5175c827bcd7fb6e89a53729b1a2347f0c6210f

  - `brand.posts.post_timestamp` (number)
    Post timestamp
    Example: 1729502216000

  - `brand.posts.title` (string)
    Title
    Example: Title

  - `brand.posts.description` (string)
    Description
    Example: Description

  - `brand.posts.label` (string, required)
    Sponsorship category followed by the evidence. Possible categories: 			(1) Properly Disclosed Sponsorship - uses #ad, paid partnership flag, or explicitly indicates a partnership in text (e.g., "I teamed up with X to..."). 			(2) Likely Hidden Sponsorship - no clear disclosures, but other signals indicate a sponsorship (e.g., "Use [CODE] for X% off" or "thanks @brand"). 			(3) Unclear or Vague Sponsorship Hint - a mention/tag of a known sponsor, but without proper disclosures.
    Example: Properly Disclosed Sponsorship: is paid partnership flag

  - `brand.posts.collaboration_type` (string, required)
    Type of collaboration (if multiple types are relevant, we return the most relevant one)
    Enum: "Paid", "Gifted", "Ambassador", "Affiliate", "Unspecified"

  - `brand.posts.stats` (object)
    Stats

  - `brand.posts.sponsors` (array)
    Sponsors

  - `brand.posts.user_id` (string)
    User id
    Example: 173560420

  - `brand.posts.username` (string)
    Username
    Example: username

  - `brand.posts.platform` (string)
    Platform
    Example: instagram

## Response 404 fields (application/json):

  - `error` (boolean)
    If there is an error
    Example: false