API | Docs | Influeencer

Getting started

Usage

The REST API provides a set of HTTP methods to access influencer details, including email addresses, both programmatically and in bulk. Follow the tutorial below to get started with the Web API.

Make a POST call to https://app.influeencer.com/api.php URL. Replace XXXXXXXX with your API key. Get it from the settings area. If you are using the PHP on-promise version, replaceapp.influeencer.com with your domain name.

PHP EXAMPLE

$ch = curl_init('YOUR-DOMAIN/supportboard/include/api.php');
$parameters = [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_SSL_VERIFYPEER => false,
        CURLOPT_POST => true,
        CURLOPT_CONNECTTIMEOUT => 5,
        CURLOPT_POSTFIELDS => json_encode({ 
                                            "function": "search", 
                                            "api_key": "XXXXXXXX", 
                                            "keyword": "Sushi", 
                                            "channels": ["yt"],  
                                            "webhook_url": "https://example.com"
                                          }),
];
curl_setopt_array($ch, $parameters); 
$response = curl_exec($ch);
curl_close($ch);
$response = json_decode($response, true);
}

Functions

Search

Start a new influencer search using the provided keyword and filters. The search runs in the background, and the results will be delivered later to the webhook URL you provide. Use the search-progress function to check the status of the search. Use the cancel-search function to cancel an ongoing search. Search queries with high result limits or advanced filters may take several hours to complete. The search will continue running until it reaches the set limit or finds at least one new influencer every 30 minutes.

Arguments

api_key Required	Your API key.
function Required	Enter search.
keyword	The keyword to search for. It can be a single word or a phrase. When you apply a language or country filter, your search terms should be provided in the same language. If not, the API will automatically translate them into the selected language. Example: sushi, fitness coach.
channels Required	Array of channels to search in. Possible values: yt (YouTube), ig (Instagram), tt (TikTok), fb (Facebook). At least one channel is required.
webhook_url Required	The URL where the search results will be sent once the search is complete. The webhook will receive a POST request with the search results in JSON format. Use the next_index argument to paginate through large result sets.
followers_count	Filter influencers by minimum and maximum followers count. If at least one influencer's channel meet the criteria, the influencer is included in the results. Default: [1000, 9999999999].
search_results_limit	Maximum number of influencers to retrieve. Max: 10000. Default: 50.
language_code	Filter influencers by language. Use the two-letter ISO 639-1 code. When you apply a language filter, your keyword terms should be provided in the same language. If not, the API will automatically translate them into the selected language. Example: en (English), it (Italian), es (Spanish).
country_code	Filter influencers by country. Use the two-letter ISO 3166-1 alpha-2 code. When you apply a country filter, your keyword terms should be provided in the same country language. If not, the API will automatically translate them into the selected language. We recommend against using this filter as it may limit the results. Use the language_code filter instead. Example: US (United States), IT (Italy), ES (Spain).
strict_mode	By default, the search includes influencers who have at least some relevant content, such as a YouTube video related to the query, even if their overall niche is broader. When strict mode is enabled, only influencers whose channels are specifically focused on the searched keyword will be shown. This is determined by analyzing the channel descriptions. Default: false.
next_index	Use this parameter to paginate through large result sets. It indicates the starting index for the next batch of results. Each batch contains up to 100 influencers. Default: 0.

Successful Response

{
    "success": true,
    "response": "search-in-progress"
}

Search progress

Check the progress of an ongoing influencer search. The response includes the current status of the search, the number of influencers found so far, and other information.

Arguments

api_key Required	Your API key.
function Required	Enter search-progress.

Successful Response

{
    "success": true,
    "response": {
        "channels": [
            "yt"
        ],
        "followers": [
            1000,
            9999999999999999
        ],
        "language": false,
        "country": false,
        "strict_mode": false,
        "include_no_email": false,
        "webhook_url": "https://exampl.com",
        "search_start_time": "2025-09-08 14:17:14",
        "search_results_limit": 50,
        "keyword": "lord of the rings",
        "search_results": 0,
        "progress": "0%"
    }
}

Cancel search

Cancel the active search.

Arguments

api_key Required	Your API key.
function Required	Enter cancel-search.

Successful Response

{
    "success": true,
    "response": "Search successfully cancelled"
}

Get

Return the list of profiles that have been already found from an active or previous search.

Arguments

api_key Required	Your API key.
function Required	Enter get.
keyword	The keyword to search for. It can be a single word or a phrase. When you apply a language or country filter, your search terms should be provided in the same language. If not, the API will automatically translate them into the selected language. Example: sushi, fitness coach.
channels Required	Array of channels to search in. Possible values: yt (YouTube), ig (Instagram), tt (TikTok), fb (Facebook). At least one channel is required.
followers_count	Filter influencers by minimum and maximum followers count. If at least one influencer's channel meet the criteria, the influencer is included in the results. Default: [1000, 9999999999].
search_results_limit	Maximum number of influencers to retrieve. Max: 10000. Default: 50.
language_code	Filter influencers by language. Use the two-letter ISO 639-1 code. When you apply a language filter, your keyword terms should be provided in the same language. If not, the API will automatically translate them into the selected language. Example: en (English), it (Italian), es (Spanish).
country_code	Filter influencers by country. Use the two-letter ISO 3166-1 alpha-2 code. When you apply a country filter, your keyword terms should be provided in the same country language. If not, the API will automatically translate them into the selected language. We recommend against using this filter as it may limit the results. Use the language_code filter instead. Example: US (United States), IT (Italy), ES (Spain).
strict_mode	By default, the search includes influencers who have at least some relevant content, such as a YouTube video related to the query, even if their overall niche is broader. When strict mode is enabled, only influencers whose channels are specifically focused on the searched keyword will be shown. This is determined by analyzing the channel descriptions. Default: false.
next_index	Use this parameter to paginate through large result sets. It indicates the starting index for the next batch of results. Each batch contains up to 100 results. Default: 0.

Successful Response

{
    "success": true,
    "response": "search-in-progress"
}