Skip to content
/Collaborations

Overview

Discovery API provides powerful products for different use cases. Let us provide a brief overview:

Search allows you to build comprehensive search experience to find creators. Use filters, lookalikes and our dictionaries and lists to create stunning user interfaces.

Reports provide in depth analytics that include audience demographics, performance metrics, sponsored posts and much more.

Our collaborations products enable you to create overviews of past brand partnerships between creators and brands.

There is more: Search by Email allows you to lookup which creator accounts are associated with an emails and audience overlap identifies the uniqueness of an audience with ease.

Testing the API

Search

You can test out the Instagram Search API for free by leaving the filter object empty. Your request body should look similar to this.

> POST https://api.modash.io/v1/instagram/search
{
	"sort": {
		"field": "followers",
		"direction": "desc"
	},
	"filter": {
	}
}

Reports

To test out the Instagram Reports API for free you can set the userId as instagram. Your request should look like this.

> GET https://api.modash.io/v1/instagram/profile/instagram/report

We recommend always using the report route and caching the result if necessary. Everything that is included in the overview is also in a report.

Pagination

When using the Search API, each response has in total 15 influencers. If you wish to query more influencers for the same query you need to increment the page parameter in the request body.

By default the page parameter is set to 0.

Dictionaries

Interests, Locations and brands

When finding influencers by interests, locations or brands you need to search by their respective ID. To list all interests, locations or brands you need to call the https://api.modash.io/v1/instagram/interests, https://api.modash.io/v1/instagram/locations, https://api.modash.io/v1/instagram/brands route.

You can specify the list of interests, locations or brands returned by using the query parameter and limit the amount of list items returned by using the limit parameter.

By default the limit parameter is set to 20. You can query all list items by setting the limit parameter to 1000000.

Languages

Similar to interests, locations and brands, you first need to find the correct language code to search by. This can be done by calling the https://api.modash.io/v1/instagram/languages route.

Download OpenAPI description
discovery.json
discovery.yaml
Overview
URL

https://www.modash.io

API Support

hello@modash.io

Terms of Service

Languages
Servers

https://api.modash.io/v1/

Search by Email

Request

For each email provided, identify one or more social media accounts on Instagram, YouTube, or TikTok that have listed this email in their bio or as their contact information.
A successful request costs 0.02 credits per matched email. To execute this request, the account must have a minimum of 0.02 credits multiplied by the number of provided emails, otherwise a not_enough_credits error will be returned.
We do not store the email addresses that you send us.

Security
accessToken
Bodyapplication/jsonrequired
emailsArray of strings[ 1 .. 1000 ] itemsrequired

List of emails to search

curl -i -X POST \
  https://api.modash.io/v1/email-search \
  -H 'Authorization: Bearer <YOUR_token_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "emails": [
      "string"
    ]
  }'

Responses

Bodyapplication/json
errorboolean

If there is an error

Example: false
matchedEmailsArray of objects(MatchedEmail)

Matches by email

notMatchedEmailsArray of strings

Emails that were not matched

totalMatchesnumberrequired

Number of matched emails

Example: 1
Response
application/json
{
  "error": false,
  "matchedEmails": [
    { … }
  ],
  "notMatchedEmails": [
    "string"
  ],
  "totalMatches": 1
}

YouTube

API for receiving data about YouTube influencers

Operations

TikTok

API for receiving data about TikTok influencers

Operations

Instagram

API for receiving data about Instagram influencers

Operations

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 where influencers mention brands or vice versa. Note: Brand collaborations are not supported yet for Youtube.
Every successful request costs 0.2 credit.

Security
accessToken
Bodyapplication/jsonrequired
idstringrequired

User ID / Username / Profile URL, User ID is preferred

Example: "johndoe"
platformstringrequired
Enum"instagram""tiktok""youtube"
Example: "instagram"
collaboratorIdstring

If provided, only returns the collaboration posts between the specified influencer and brand

cursorstring

Cursor for pagination (only valid for 2 days)

limitnumber[ 1 .. 30 ]

Number of collaboration posts per page

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

Note: 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.

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": "johndoe",
    "platform": "instagram",
    "collaboratorId": "string",
    "cursor": "string",
    "limit": 30,
    "groupBrandCollaborations": true
  }'

Responses

Bodyapplication/json
errorboolean

If there is an error

Example: false
cursorstring

Cursor for pagination (only valid for 2 days)

influencerobject
brandobject
Response
application/json
{
  "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_name": "string",
    "brand_domain": "string",
    "brand_logo": "string",
    "posts": [ … ]
  }
}

Get collaboration summary

Request

This endpoint aggregates performance data (total as well as per_brand/per_influencer) across the collaborated posts, including total_likes, total_shares, total_views, total_collects, and total_plays. Note: Brand collaborations are not supported yet for Youtube.
Every successful request costs 0.2 credit.

Security
accessToken
Bodyapplication/jsonrequired
idstringrequired

User ID / Username / Profile URL, User ID is preferred

Example: "johndoe"
platformstringrequired
Enum"instagram""tiktok""youtube"
Example: "instagram"
collaboratorIdstring

If provided, only returns the collaboration summary between the specified influencer and brand

cursorstring

Cursor for pagination (only valid for 2 days)

limitnumber[ 1 .. 10 ]

Number of collaboration summaries per page

Default 10
groupBrandCollaborationsboolean

If true, brand collaborations summaries will be grouped across all platforms. This provides insights about the brand across all its social accounts.

For example: if you request brand collaborations summary for @cocacola on Instagram, you will get collaboration summary for posts sponsored by Coca Cola on all three platforms (Instagram, Tiktok and Youtube).

Note: 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.

Default true
curl -i -X POST \
  https://api.modash.io/v1/collaborations/summary \
  -H 'Authorization: Bearer <YOUR_token_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "johndoe",
    "platform": "instagram",
    "collaboratorId": "string",
    "cursor": "string",
    "limit": 10,
    "groupBrandCollaborations": true
  }'

Responses

Bodyapplication/json
errorboolean

If there is an error

Example: false
cursorstring

Cursor for pagination (only valid for 2 days)

influencerobject
brandobject
Response
application/json
{
  "error": false,
  "cursor": "string",
  "influencer": {
    "id": "johndoe",
    "platform": "instagram",
    "is_more_available": true,
    "summary": { … },
    "per_brand_summary": [ … ]
  },
  "brand": {
    "id": "johndoe",
    "platform": "instagram",
    "is_more_available": true,
    "summary": { … },
    "per_influencer_summary": [ … ]
  }
}

User Account

API for Modash user account management

Operations

System

System endpoints for service health and monitoring

Operations