Modash API Documentation
Search Influencers
POST {{baseUrl}}/v1/instagram/search
Get a list of influencers that match your filters.
Body
PARAM
| Key | Datatype | Required | Description |
HEADERS
| Key | Datatype | Required | Description |
Content-Type
|
string | ||
Accept
|
string |
RESPONSES
status OK
| {
"total": 2,
"lookalikes": [
{
"userId": "1110101",
"profile": {
"username": "instagram",
"url": "https://www.instagram.com/instagram/",
"picture": "https://imgigp.modash.io/?https://scontent-arn2-1.cdninstagram.com/t51.2885-19/s320x320/22159423_1794482210565499_9190891265074397184_n.jpg",
"followers": 313560626,
"engagements": 857994,
"engagementRate": 0.0027362938100525414,
"userId": "4333460164",
"fullname": "Instagram"
}
},
{
"userId": "1110101",
"profile": {
"username": "instagram",
"url": "https://www.instagram.com/instagram/",
"picture": "https://imgigp.modash.io/?https://scontent-arn2-1.cdninstagram.com/t51.2885-19/s320x320/22159423_1794482210565499_9190891265074397184_n.jpg",
"followers": 313560626,
"engagements": 857994,
"engagementRate": 0.0027362938100525414,
"userId": "4333460164",
"fullname": "Instagram"
}
}
],
"directs": [
{
"userId": "1110101",
"profile": {
"username": "instagram",
"url": "https://www.instagram.com/instagram/",
"picture": "https://imgigp.modash.io/?https://scontent-arn2-1.cdninstagram.com/t51.2885-19/s320x320/22159423_1794482210565499_9190891265074397184_n.jpg",
"followers": 313560626,
"engagements": 857994,
"engagementRate": 0.0027362938100525414,
"userId": "4333460164",
"fullname": "Instagram"
}
},
{
"userId": "1110101",
"profile": {
"username": "instagram",
"url": "https://www.instagram.com/instagram/",
"picture": "https://imgigp.modash.io/?https://scontent-arn2-1.cdninstagram.com/t51.2885-19/s320x320/22159423_1794482210565499_9190891265074397184_n.jpg",
"followers": 313560626,
"engagements": 857994,
"engagementRate": 0.0027362938100525414,
"userId": "4333460164",
"fullname": "Instagram"
}
}
],
"isExactMatch": true,
"error": false
} |
Curl
curl -X POST 'https://api.modash.io/v1/instagram/search' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"sort":{"field":"followers","id":123,"direction":"desc"},"page":0,"filter":{"influencer":{"followers":{"min":20000,"max":70000},"engagementRate":0.02,"location":[148838,307573,79510],"language":"en","lastposted":90,"relevance":["#cars","@topgear"],"gender":"FEMALE","followersGrowthRate":{"interval":"i1month","operator":"gt","value":0.4},"hasYouTube":false,"hasContactDetails":[{"contactType":"email","filterAction":"must"},{"contactType":"email","filterAction":"must"}],"accountTypes":[2],"interests":[1708,13],"keywords":"cats","bio":"cars","textTags":[{"type":"hashtag","value":"food"},{"type":"mention","value":"world_record_egg"}],"reelsPlays":{"min":20000,"max":50000000}},"audience":{"location":[148838,307573,79510],"language":"en","gender":"FEMALE","age":["18-24","65-"],"interests":[1708,13],"credibility":0.75}}}'
ENDPOINTS