Logo
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