List influencers

GET 
/api/influencer

List influencers

Request

Query Parameters

query string

Name of the influencer or social network handle

min_followers_count integer

Follower count of the influencer

followers_country string

A lowercase ISO 3166-1 alpha-2 code

followers_age_group string

Possible values: [13-17, 18-24, 25-34, 35-44, 45-64]

Age group of the influencer's followers

followers_language string

A lowercase ISO 639 language code

followers_gender string

Possible values: [male, female]

Followers gender

categories string

Comma-separated list of categories

restrictions string

Comma-separated list of restrictions

max_budget string

Maximum budget of the campaign

imgen_available boolean

Whether the influencer has image generation available

page integer

Possible values: >= 1

Page number

per_page integer

Possible values: >= 1 and <= 100

Number of items per page

Responses

200

Successful operation

application/json

Schema

Schema

items object[]required
An array of influencers.
Array [
id uuidrequired
The unique identifier of the influencer.
first_name stringrequired
The first name of the influencer.
last_name stringrequired
The last name of the influencer.
avatar urlrequired
The URL of the influencer avatar.
has_meta_tag booleanrequired
Whether the influencer has a meta tag.
categories CampaignCategory[]required
Possible values: [art_and_design, automobiles, beauty, beverages, books_and_literature, career_and_business, children_toys_and_games, diy, e_commerce, education, events_and_entertainment, fashion, finance_and_insurance, food, gardening_and_outdoor, health_and_fitness, hobbies_and_crafts, home_and_living, home_appliences, legal_services, mobile_games, news, non_profit_and_charity, office_supplies, parenting_and_family_products, personal_development, pets, photography, podcasts, real_estate, social_media_tools, sports_and_outdoor_activities, streaming, subscription_box, technology, travel, video_games, wedding]
The categories of the influencer.
restrictions CampaignRestriction[]required
Possible values: [eco_friendly, no_animal_testing, halal, kosher, vegan, vegetarian, lgbtq, diverse_leadership]
The restrictions of the influencer.
instagram_username stringrequired
The Instagram username of the influencer.
instagram_followers integerrequired
The number of Instagram followers of the influencer.
minimum_budget stringrequired
The minimum budget of the influencer.
masked booleanrequired
Returns true if influencer content is masked according to ToC policy.
]
total integerrequired

The total number of influencers.

Example (from schema)

{
  "items": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "first_name": "string",
      "last_name": "string",
      "avatar": "string",
      "has_meta_tag": true,
      "categories": [
        "art_and_design"
      ],
      "restrictions": [
        "eco_friendly"
      ],
      "instagram_username": "string",
      "instagram_followers": 0,
      "minimum_budget": "string",
      "masked": true
    }
  ],
  "total": 0
}

default

Unexpected error

application/json

Schema

Schema

code int32required

The error code

message stringrequired

A human-readable error message

Example (from schema)

{
  "code": 0,
  "message": "string"
}

Loading...