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 }
AI Search
AI Search allows you to find influencers based on the type of content they create, specifically by analyzing the images and videos that they post. It is a beta feature and is available to all Discovery API users.
P.S. it currently only supports Instagram influencers who have greater than 10000 followers.
Operations
https://api.modash.io/v1/ai/text-search
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://api.modash.io/v1/ai/text-search \
-H 'Authorization: Bearer <YOUR_token_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"page": 0,
"filters": {
"followersCount": {
"min": 0,
"max": 0
},
"locations": [
0
],
"gender": "MALE",
"lastPostedInDays": 90,
"accountType": "creator",
"language": "string",
"age": {
"min": "13",
"max": "18"
},
"engagementRate": {
"min": 0.01
},
"hasEmail": true,
"brands": [
"string"
]
},
"query": "woman with curly hair lifting weights"
}'Bodyapplication/json
List of influencer profiles matching the search query and filters
Profile Picture
Example: "https://imgigp.modash.io/22159423_1794482210565499_9190891265074397184_n.jpg"
Account category
Example: "Sportsperson / Digital creator etc."
Posts ordered by relevance to the search query
Recent posts (not necessarily relevant to the search query). P.S. we update profiles every 4 weeks and this lag should be considered when using this field.
Response
application/json
{ "error": false, "total": 0, "profiles": [ { … } ] }
https://api.modash.io/v1/ai/image-search
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://api.modash.io/v1/ai/image-search \
-H 'Authorization: Bearer <YOUR_token_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"page": 0,
"filters": {
"followersCount": {
"min": 0,
"max": 0
},
"locations": [
0
],
"gender": "MALE",
"lastPostedInDays": 90,
"accountType": "creator",
"language": "string",
"age": {
"min": "13",
"max": "18"
},
"engagementRate": {
"min": 0.01
},
"hasEmail": true,
"brands": [
"string"
]
},
"imageType": "image/jpeg",
"base64Image": "string"
}'Bodyapplication/json
List of influencer profiles matching the search query and filters
Profile Picture
Example: "https://imgigp.modash.io/22159423_1794482210565499_9190891265074397184_n.jpg"
Account category
Example: "Sportsperson / Digital creator etc."
Posts ordered by relevance to the search query
Recent posts (not necessarily relevant to the search query). P.S. we update profiles every 4 weeks and this lag should be considered when using this field.
Response
application/json
{ "error": false, "total": 0, "profiles": [ { … } ] }
https://api.modash.io/v1/ai/brands
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://api.modash.io/v1/ai/brands?query=string' \
-H 'Authorization: Bearer <YOUR_token_HERE>'Response
application/json
{ "error": false, "result": [ { … } ] }