List of emails to search
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.
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": {
}
}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/reportWe recommend always using the report route and caching the result if necessary. Everything that is included in the overview is also in a report.
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.
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.
Download OpenAPI description
Overview
Languages
Servers
https://api.modash.io/v1/
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
https://api.modash.io/v1/email-search
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
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"
]
}'Response
application/json
{ "error": false, "matchedEmails": [ { … } ], "notMatchedEmails": [ "string" ], "totalMatches": 1 }
Request
Get a list of influencers that match your filters.
A successful request costs 0.01 credits per search result, with a typical request totaling 0.15 credits for up to 15 results per page
Expand to see additional information
When filtering by one or more fields, it is advisable to include these same fields in the sorting process. This ensures that you can retrieve the match information associated with each result. By adding the filtering fields to the sorting criteria, you gain access to detailed match info for every result obtained.
Example: If you want to filter by age you would also sort the results by age:
{
"sort": { "direction": "desc", "field": "audience_age", "sortedValue": "18-24", "value": "18-24" },
"page": 0,
"filter": { "audience": { "age": [{"id": "18-24", "weight": 0.3}] } }
}
You will retrieve match info that will provide details on how well each result matches the filtering criteria. The match info should include two fields:
-
code: represents the filtering field that corresponds to the result -
percentage: quantifies the degree of similarity or relevance Audience filters support weights:
Expand to see additional information
Weights allow you to set a threshold for the chosen filter. If you remove the weight - we will apply the default weight per filter.
Using multiple filters simultaneously results in a logical
AND, while applying multiple objects into an array (works with interests, location and age) are applied as a logical ORExample: If you want at least
30% of the audience to be at the age of 18-24, you can use the weight property of 0.3. We recommend starting with low weight and gradually increasing the percentage. You can find the default thresholds in the notes of each filter.Expand the filter object below to see all available options.
Security
accessToken
If specified, this indicates the method used to compute average-based metrics, such as average number of likes, comments, shares, etc.
Default "median"
Enum"median""average"
Example: "median"
https://api.modash.io/v1/instagram/search
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://api.modash.io/v1/instagram/search \
-H 'Authorization: Bearer <YOUR_token_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"page": 0,
"calculationMethod": "median",
"sort": {
"field": "followers",
"value": 123,
"direction": "desc"
},
"filter": {
"influencer": {
"followers": {
"min": 20000,
"max": 70000
},
"engagementRate": 0.02,
"location": [
148838,
62149,
80500,
1428125,
304716
],
"language": "en",
"lastposted": 90,
"relevance": [
"#cars",
"@topgear"
],
"audienceRelevance": [
"@topgear"
],
"gender": "MALE",
"age": {
"min": 18,
"max": 25
},
"followersGrowthRate": {
"interval": "i6months",
"value": 0.01,
"operator": "gt"
},
"bio": "photos videos",
"hasYouTube": false,
"hasContactDetails": [
{
"contactType": "email",
"filterAction": "must"
}
],
"accountTypes": [
2
],
"brands": [
1708,
13
],
"interests": [
3,
21,
1,
13,
11,
1708,
7,
1826
],
"keywords": "supercars",
"textTags": [
{
"type": "hashtag",
"value": "carsofinstagram"
},
{
"type": "mention",
"value": "topgear"
}
],
"reelsPlays": {
"min": 20000,
"max": 50000000
},
"isVerified": true,
"hasSponsoredPosts": true,
"engagements": {
"min": 5000,
"max": 10000
},
"filterOperations": [
{
"operator": "and",
"filter": "followers"
}
]
},
"audience": {
"location": [
{
"id": 148838,
"weight": 0.2
},
{
"id": 62149,
"weight": 0.2
},
{
"id": 80500,
"weight": 0.2
},
{
"id": 1428125,
"weight": 0.2
},
{
"id": 304716,
"weight": 0.2
}
],
"language": {
"id": "en",
"weight": 0.2
},
"gender": {
"id": "MALE",
"weight": 0.5
},
"age": [
{
"id": "18-24",
"weight": 0.3
},
{
"id": "65-",
"weight": 0.3
}
],
"ageRange": {
"min": "18",
"max": "24",
"weight": 0.3
},
"interests": [
{
"id": 1708,
"weight": 0.2
},
{
"id": 13,
"weight": 0.2
},
{
"id": 3,
"weight": 0.2
},
{
"id": 21,
"weight": 0.2
},
{
"id": 1,
"weight": 0.2
},
{
"id": 11,
"weight": 0.2
},
{
"id": 7,
"weight": 0.2
},
{
"id": 1826,
"weight": 0.2
}
],
"credibility": 0.75
}
}
}'Bodyapplication/json
Lookalikes
Profile info of influencer
Profile Picture
Example: "https://imgigp.modash.io/?https://scontent-arn2-1.cdninstagram.com/t51.2885-19/s320x320/22159423_1794482210565499_9190891265074397184_n.jpg"
Directs
Profile info of influencer
Profile Picture
Example: "https://imgigp.modash.io/?https://scontent-arn2-1.cdninstagram.com/t51.2885-19/s320x320/22159423_1794482210565499_9190891265074397184_n.jpg"
Response
application/json
{ "error": false, "total": 2, "lookalikes": [ { … } ], "directs": [ { … } ], "isExactMatch": true }
Request
To protect our enterprise customers, influencer contact details are not enabled by default. Contact us to unlock them for free.
Every successful request costs 1 credit.
Security
accessToken
https://api.modash.io/v1/instagram/profile/{userId}/report
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://api.modash.io/v1/instagram/profile/{userId}/report?calculationMethod=median' \
-H 'Authorization: Bearer <YOUR_token_HERE>'Bodyapplication/json
Recent Posts
Example: [{"id":"string","text":"string","url":"string","created":"string","likes":0,"comments":0,"mentions":["string"],"hashtags":["string"]}]
Profile Picture
Example: "https://imgigp.modash.io/?https://scontent-arn2-1.cdninstagram.com/t51.2885-19/s320x320/22159423_1794482210565499_9190891265074397184_n.jpg"
Response
application/json
{ "error": false, "profile": { "userId": "173560420", "profile": { … }, "hashtags": [ … ], "mentions": [ … ], "statsByContentType": { … }, "audience": { … }, "stats": { … }, "recentPosts": [ … ], "popularPosts": [ … ], "city": "New york", "state": "California", "gender": "FEMALE", "language": { … }, "contacts": [ … ], "country": "US", "ageGroup": "18-24", "isPrivate": true, "accountType": "Regular", "isVerified": true, "postsCounts": 37, "avgLikes": 18211, "avgComments": 12321, "bio": "CEO of #RockTok", "interests": [ … ], "brandAffinity": [ … ], "sponsoredPosts": [ … ], "statHistory": [ … ], "lookalikes": [ … ], "postsCount": 37, "avgViews": 48, "avgReelsPlays": 5727, "audienceExtra": { … }, "paidPostPerformance": 0.5, "paidPostPerformanceViews": 37, "sponsoredPostsMedianViews": 3127, "sponsoredPostsMedianLikes": 3743, "nonSponsoredPostsMedianViews": 267, "nonSponsoredPostsMedianLikes": 367 } }
https://api.modash.io/v1/instagram/reports/audience/overlap
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://api.modash.io/v1/instagram/reports/audience/overlap \
-H 'Authorization: Bearer <YOUR_token_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"influencers": [
"string"
]
}'Response
application/json
{ "error": false, "reportInfo": { "totalFollowers": 0, "totalUniqueFollowers": 0 }, "data": [ { … } ] }
https://api.modash.io/v1/instagram/brands
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://api.modash.io/v1/instagram/brands?limit=0&query=string' \
-H 'Authorization: Bearer <YOUR_token_HERE>'Response
application/json
{ "error": false, "brands": [ { … } ], "total": 28 }
https://api.modash.io/v1/instagram/interests
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://api.modash.io/v1/instagram/interests?limit=0&query=string' \
-H 'Authorization: Bearer <YOUR_token_HERE>'Response
application/json
{ "error": false, "interests": [ { … } ], "total": 28 }
https://api.modash.io/v1/instagram/topics
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://api.modash.io/v1/instagram/topics?limit=0&query=string' \
-H 'Authorization: Bearer <YOUR_token_HERE>'Response
application/json
{ "error": false, "tags": [ "string" ] }
https://api.modash.io/v1/instagram/languages
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://api.modash.io/v1/instagram/languages?limit=0&query=string' \
-H 'Authorization: Bearer <YOUR_token_HERE>'https://api.modash.io/v1/instagram/locations
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://api.modash.io/v1/instagram/locations?limit=0&query=string' \
-H 'Authorization: Bearer <YOUR_token_HERE>'Response
application/json
{ "error": false, "locations": [ { … } ], "total": 8477 }
https://api.modash.io/v1/instagram/users
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://api.modash.io/v1/instagram/users?limit=0&query=string' \
-H 'Authorization: Bearer <YOUR_token_HERE>'Response
application/json
{ "error": false, "users": [ { … } ] }
Request
Returns the performance data of an Instagram account for the last 6, 12 and 30 posts & reels.
The data is computed on demand, so if it is not available from the first request, a second call should be performed after ~5 minute.
Every successful request costs 0.25 credits. If the response code is retry_later or there is an error on our side you will not be charged.
Security
accessToken
https://api.modash.io/v1/instagram/performance-data
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://api.modash.io/v1/instagram/performance-data?url=string' \
-H 'Authorization: Bearer <YOUR_token_HERE>'Response
application/json
{ "posts": { "total": 0, "posts_with_hidden_likes": 0, "likes": { … }, "comments": { … }, "views": { … }, "engagement_rate": [ … ], "posting_statistics": { … } }, "reels": { "total": 0, "reels_with_hidden_likes": 0, "likes": { … }, "comments": { … }, "views": { … }, "engagement_rate": [ … ], "posting_statistics": { … } } }
Request
Get Brand collaborations for Influencer. This will provide posts for any platform.
A successful request costs 1 credit, for up to 30 results per page
We're currently rebuilding the Collaborations functionality based on user feedback. An improved version is already in development and will soon replace the current implementation. If you're considering using the collaboration endpoints, please contact us for more information.
Security
accessToken
https://api.modash.io/v1/instagram/collaborations/influencer
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://api.modash.io/v1/instagram/collaborations/influencer \
-H 'Authorization: Bearer <YOUR_token_HERE>'Response
application/json
{ "error": false, "collaborations": [ { … } ], "more_available": true, "end_cursor": "string" }
Request
Get Brand collaborations for Brand. This will provide posts for any platform.
A successful request costs 1 credit, for up to 30 results per page
We're currently rebuilding the Collaborations functionality based on user feedback. An improved version is already in development and will soon replace the current implementation. If you're considering using the collaboration endpoints, please contact us for more information.
Security
accessToken
https://api.modash.io/v1/instagram/collaborations/brand
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://api.modash.io/v1/instagram/collaborations/brand \
-H 'Authorization: Bearer <YOUR_token_HERE>'Response
application/json
{ "error": false, "collaborations": [ { … } ], "more_available": true, "end_cursor": "string" }
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.
Each successful request (with results) consumes 0.2 credits.
Operations