Search Influencers
POST {{baseUrl}}/v1/instagram/search
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 <u>Filtering and adding match data:</u><details><summary>Expand to see additional information<br></summary></br>
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.
</br></br><strong>Example:</strong> If you want to filter by age you would also sort the results by age:
</br><code>
{
</br> "sort": { "direction": "desc", "field": "audience_age", "sortedValue": "18-24", "value": "18-24" },
</br> "page": 0,
</br> "filter": { "audience": { "age": [{"id": "18-24", "weight": 0.3}] } }
</br>}
</code>
</br></br>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: </br>
-<code>code</code>: represents the filtering field that corresponds to the result </br>
-<code>percentage</code>: quantifies the degree of similarity or relevance </details>
</br><u>Audience filters support weights:</u><details><summary>Expand to see additional information<br></summary></br>Weights allow you to set a threshold for the chosen filter. If you remove the weight - we will apply the default weight per filter.
</br>Using multiple filters simultaneously results in a logical <code>AND</code>, while applying multiple objects into an array (works with interests, location and age) are applied as a logical <code>OR</code>
</br></br><strong>Example:</strong> If you want at least <code>30%</code> of the audience to be at the age of <code>18-24</code>, you can use the weight property of <code>0.3</code>. We recommend starting with low weight and gradually increasing the percentage. You can find the default thresholds in the notes of each filter.</details>
</br></br><b>Expand the filter object below to see all available options.</b>
Body
PARAM
Key | Datatype | Required | Description |
HEADERS
Key | Datatype | Required | Description |
Content-Type
|
string | ||
Accept
|
string |
RESPONSES
status
ENDPOINTS