Collaborations

These endpoints return posts or summaries for the collaborations between influencers and brands. These APIs can help you monitor partnerships, analyze campaign performance, track competitor activity, and power influencer discovery or reporting tools at scale.

Operations

Get collaboration posts

Request

This endpoint returns collaborated posts (and stories) where influencers mention brands or vice versa.
A story is identified by a feed_type of story_original or story_reshared, and omits stats and description because stories carry no engagement metrics or caption. title is YouTube-only and is omitted for Instagram and TikTok.
Every successful request costs 0.2 credit.

Security

accessToken

Bodyapplication/jsonrequired

idstringrequired

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"

platformstringrequired

Enum:"instagram""tiktok""youtube"

Example:"instagram"

collaboratorIdstring

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).

postCreationTimestampMsobject(PostCreationTimestampMs)

Filter the posts by creation timestamp in milliseconds

Example:

{
  "gte": 1716835200000
}

cursorstring

Cursor for pagination (only valid for 2 days)

Example:""

limitnumber, [ 1 .. 30 ]

Number of collaboration posts per page

Default:30

Example:10

groupBrandCollaborationsboolean

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.

Default:true

curl -i -X POST \
  https://api.modash.io/v1/collaborations/posts \
  -H 'Authorization: Bearer <YOUR_token_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "cristiano",
    "platform": "instagram",
    "limit": 10
  }'

Responses

Bodyapplication/json

errorboolean

If there is an error

Example:false

cursorstring

Cursor for pagination (only valid for 2 days)

influencerobject(CollaborationsPostsInfluencer)

Only available if the requested profile has influencer collaborations

brandobject(CollaborationsPostsBrand)

Only available if the requested profile has brand collaborations

Response

{
  "error": false,
  "cursor": "string",
  "influencer": {
    "id": "johndoe",
    "platform": "instagram",
    "is_more_available": true,
    "username": "username",
    "user_picture": "https://images.od.modash.io/c5175c827bcd7fb6e89a53729b1a2347f0c6210f",
    "posts": [ … ]
  },
  "brand": {
    "id": "johndoe",
    "platform": "instagram",
    "is_more_available": true,
    "brand_id": "string",
    "brand_name": "string",
    "brand_domain": "string",
    "brand_logo": "string",
    "brand_category": "Travel",
    "posts": [ … ]
  }
}