One creator's full profile

Scope: creators:read. One creator by the id a GET /creators row carries (a UUID), at /api/v1/creators/{id}. There is no lookup by X handle: no creator read carries a handle or an x.com link (the handle shows on a paid plan's quote), and this profile is opened by id only. MCP tool: creator_get.

get/creators/{id}

Request

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

Path parameters

idstring uuid required

The creator's id from a GET /creators row (a UUID).

Query parameters

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.

Response

OK

idstring uuid
handlestring nullable

Null in every creator read: a creator is named before payment, and its X handle shows once the brand's order for a plan with that creator is paid, on that plan's quote (plan_quote).

namestring nullable
urlstring nullable

Null in every creator read, as handle: the X profile link shows on the paid plan's quote.

status'approved' | 'borderline' | 'not_reviewed' | 'declined'
status_labelstring
status_reasonstring
in_automatic_plansboolean
match_scoreinteger nullable
match_labelstring nullable
on_saleboolean
reach_band'nano' | 'micro' | 'mid' | 'macro' | 'mega'

The creator's size by followers, smallest to largest.

median_views_30dinteger nullable

Deprecated: the same number as median_views_30d_network. Removed on 2027-01-11; read median_views_30d_network.

median_views_30d_networkinteger nullable

Median views per post over the creator's last 30 days, as the network measures it across all their posts. Prices, expected views and format advice use this number. It can differ from posts_summary.posts_sample_median_views, which covers only the posts we hold.

followersinteger nullable

X followers, as the network last measured them. Null when not measured.

verified_badgeboolean nullable

Whether the account carries the X blue check. Null when unknown.

countrystring nullable

The country or region X shows on the account's About panel. Null when X shows none; never inferred.

languagestring nullable

The language the creator posts in, as a name (for example English). Null when unknown.

segmentsstring[]
biostring nullable
positioningstring nullable

One line on who the creator is, taken from their own bio (never written by us); null when the bio has none.

avatar_urlstring nullable
ask_priceboolean

true when nothing is on sale for this creator: the action is Ask for a price (creator_ask_price, POST /creators/{id}/price-request), which asks our team, never the creator; price_estimate is an estimate, never a price. false when a format is on sale: add it from offerings with plan_add_creator.

engagement_rate_30dnumber nullable
posts_per_weeknumber nullable
recent_postsobject[]

The creator's own posts with their numbers, newest first: up to 30 from the last 30 days for an approved creator.

synced_atstring date-time nullable

When the creator's profile and posts were last synced (ISO 8601). Null when unknown.

refresh_failed_atstring date-time nullable

When the last nightly refresh of this creator failed (ISO 8601); null when the last refresh worked or none has run. The figures then stay as of synced_at.

Changes

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