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
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 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"
POST
curl -i -X POST \
https://api.modash.io/v1/youtube/search \
-H 'Authorization: Bearer <YOUR_token_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"page": 0,
"calculationMethod": "median",
"sort": {
"field": "followers",
"direction": "desc"
},
"filter": {
"audience": {
"location": [
{
"weight": 0.2,
"id": 148838
}
]
},
"influencer": {
"relevance": [
"#beauty_tips",
"#beauty_hacks",
"#beauty_products",
"#beauty_of_nature",
"#beautytips",
"#beauty_haul",
"#beauty_secrets",
"#beauty_vlogger"
],
"location": [
148838
],
"gender": "FEMALE",
"age": {
"min": 25,
"max": 45
},
"engagementRate": 0.02
}
}
}'Response
{ "error": false, "total": 2, "lookalikes": [ { … } ], "directs": [ { … } ], "isExactMatch": true }