Approved creators on sale now, by name, with price per format and format advice

Scope: creators:read.

get/creators

Request

  • Base URL: https://app.distribution.tech/api/v1
  • URL: https://app.distribution.tech/api/v1/creators
  • Auth: HTTP bearer

Query parameters

qstring

Part of a name, handle or bio.

segmentstring

An audience segment id, e.g. ai or saas_b2b.

reach_band'nano' | 'micro' | 'mid' | 'macro' | 'mega'

The creator's size by followers.

goal'launch' | 'funding' | 'feature' | 'program'

The campaign's goal: launch, funding or feature (an announcement with a post of yours to quote) or program (steady reach). Shapes the format advice.

matchstring

Your audience segments, comma separated (from /audience): adds match_score (over 70 strong, over 50 good) and ranks by it.

limitinteger

Page size: default 24, at most 50.

offsetinteger

Where the page starts; page through every approved creator with total.

fitboolean

true: only creators reaching at least one of the match segments (the 'fit your audience' set); total then counts only those.

countrystring

The creator's country as X reports it, exact and case-insensitive, e.g. United States.

languagestring

The language the creator posts in, exact and case-insensitive, e.g. English.

followers_mininteger

At least this many X followers.

followers_maxinteger

At most this many X followers.

er_minnumber

At least this engagement rate over the last 30 days, in percent (0 to 100, two decimals).

match_mininteger

At least this match score (0 to 100; over 70 strong, over 50 good). Needs match.

format'post' | 'quote' | 'thread'

Only creators selling this format; price and price filters then read that format's price.

price_mininteger

The cheapest all-in price (of the format, when one is given) is at least this many US dollars.

price_maxinteger

The cheapest all-in price (of the format, when one is given) is at most this many US dollars.

sort'match' | 'followers' | 'engagement' | 'views' | 'price'

Order: match (default, best fit first), followers, engagement, views (median views a post) or price (cheapest all-in price).

dir'desc' | 'asc'

desc (default) or asc.

budgetinteger

The campaign budget in US dollars. It sizes the shortlist (three times the posts it buys at the good fits' median price, 10 to 50); without it the list is 25. It never filters.

Response

OK

totalinteger

How many creators this answer lists: the shortlist, never a count of the network.

pricedinteger

How many of total are bookable now by the one rule in the API description (What bookable means); the rest carry price_estimate, never a price.

capinteger

How many creators the selection holds (the same as total).

limitinteger

This page's size: default 24, at most 50.

offsetinteger

Where this page starts, at most total (an offset past the end is answered as total); the next page starts at offset + limit while it is below total.

Changes

No recorded changes to this operation across all 1 revision of this API.