creator_get: One creator | distribution.tech

Overview

One creator's full profile by id: bio, followers, the X blue check, country and language when known, measured engagement, posting rate, the last 30 days of posts with their numbers, the launches and brands it worked with among the launches we track, each format's all-in price and the format advice for your goal. Opening a creator not yet seen today is one of your workspace's 300 creator views a day, shared by the app and every API key; one already seen today is free.

Server: https://app.distribution.tech/api/mcp
Scope: creators:read
Changes data: No, a read
REST endpoint: GET /creators/{id}

Arguments

Arguments of creator_get
Name	Type	Required	Description
`id`	string (uuid)	No	The creator's id from creators_search (creator.id on a quote line).
`creator_id`	string (uuid)	No	The same id under its earlier name. Send id or creator_id, not both.
`goal`	one of "launch", "funding", "feature", "program" or one of "awareness", "signups"	No	The campaign's goal: launch, funding or feature (an announcement with a post of yours to quote) or program (steady reach). Shapes the post or quote advice.

Call with curl

The server speaks streamable HTTP, so one JSON-RPC tools/call request runs the tool. Set DISTRIBUTION_API_KEY to a key from Developers with the creators:read scope; the arguments shown are the required ones.

curl

curl -X POST "https://app.distribution.tech/api/mcp" \
  -H "Authorization: Bearer $DISTRIBUTION_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "creator_get",
    "arguments": {
      "id": "<uuid>"
    }
  }
}'

Result

The answer's structuredContent follows the tool's output schema (the same JSON is in its text content). It has these fields:

Result fields of creator_get
Name	Type	Required	Description
`id`	string (uuid)	No
`handle`	string or null	No	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).
`name`	string or null	No
`url`	string or null	No	Null in every creator read, as handle: the X profile link shows on the paid plan's quote.
`status`	one of "approved", "borderline", "not_reviewed", "declined"	No
`status_label`	string	No
`status_reason`	string	No
`in_automatic_plans`	boolean	No
`match_score`	integer or null	No
`match_label`	string or null	No
`on_sale`	boolean	No
`reach_band`	one of "nano", "micro", "mid", "macro", "mega"	No	The creator's size by followers, smallest to largest.
`median_views_30d`	integer or null	No	Deprecated: the same number as median_views_30d_network. Removed on 2027-01-11; read median_views_30d_network.
`median_views_30d_network`	integer or null	No	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.
`followers`	integer or null	No	X followers, as the network last measured them. Null when not measured.
`verified_badge`	boolean or null	No	Whether the account carries the X blue check. Null when unknown.
`country`	string or null	No	The country or region X shows on the account's About panel. Null when X shows none; never inferred.
`language`	string or null	No	The language the creator posts in, as a name (for example English). Null when unknown.
`segments`	array of string	No
`bio`	string or null	No
`positioning`	string or null	No	One line on who the creator is, taken from their own bio (never written by us); null when the bio has none.
`avatar_url`	string or null	No
`ask_price`	boolean	No	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.
`price_estimate`	object or null	No	For a creator with nothing on sale: an estimated price range from its metrics (the ERP's suggested budget band), never a price; null when it has a price. Ask for a price (creator_ask_price, POST /creators/{id}/price-request) asks our team for a real one; the creator is never contacted directly.
`engagement_rate_30d`	number or null	No
`posts_per_week`	number or null	No
`match_reasons`	array of object	No	Why this creator (row 7858), each from a number the network holds: topic (the brand's segments the creator posts about; a topic match, not audience overlap), reach (median views a post over 30 days, with its as-of date), past_launches (launches posted about), engagement (only when above the median of the creators listed). Empty when none can be said; never a price.
`past_collabs`	array of object	No	Launches the creator posted or quoted among the launches the network tracks, newest first (at most 12), then detected paid partnerships. An empty list means none was found in the launches we track, not that the creator never worked with a brand.
`recent_posts`	array of object	No	The creator's own posts with their numbers, newest first: up to 30 from the last 30 days for an approved creator.
`posts_summary`	object or null	No	posts_sample_median_views is the median over the posts in recent_posts only (at most 30 held posts), so it can differ from median_views_30d_network, which covers all the creator's posts. Counted from recent_posts: null unless 3 or more dated posts fall in the 30 days up to as_of. A summary of their posts; top_post.excerpt quotes the creator's own post.
`offerings`	array of object	No
`synced_at`	string (date-time) or null	No	When the creator's profile and posts were last synced (ISO 8601). Null when unknown.
`refresh_failed_at`	string (date-time) or null	No	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.
`advice`	object	No

structuredContent, every field with its type

{
  "id": "<uuid>",
  "handle": "<string>",
  "name": "<string>",
  "url": "<string>",
  "status": "approved",
  "status_label": "<string>",
  "status_reason": "<string>",
  "in_automatic_plans": false,
  "match_score": 0,
  "match_label": "<string>",
  "on_sale": false,
  "reach_band": "nano",
  "median_views_30d": 0,
  "median_views_30d_network": 0,
  "followers": 0,
  "verified_badge": false,
  "country": "<string>",
  "language": "<string>",
  "segments": [
    "<string>"
  ],
  "bio": "<string>",
  "positioning": "<string>",
  "avatar_url": "<string>",
  "ask_price": false,
  "price_estimate": {
    "min_usd": 0,
    "max_usd": 0,
    "label": "<string>",
    "provenance": {
      "source": "<string>",
      "method": "<string>",
      "measured_at": "<string>",
      "expires_at": "<string>",
      "label": "Verified",
      "stale": false,
      "as_of": "<string>"
    },
    "calc": {
      "calc_version": "<string>",
      "inputs": {}
    }
  },
  "engagement_rate_30d": 0,
  "posts_per_week": 0,
  "match_reasons": [
    {
      "kind": "topic",
      "text": "<string>"
    }
  ],
  "past_collabs": [
    {
      "project": "<string>",
      "title": "<string>",
      "date": "<date>",
      "role": "Launch post",
      "url": "<string>",
      "brand": {
        "handle": "<string>",
        "avatar_url": "<string>",
        "site": "<string>",
        "initials": "<string>"
      }
    }
  ],
  "recent_posts": [
    {}
  ],
  "posts_summary": {
    "posts": 0,
    "window_days": 0,
    "capped": false,
    "median_views": 0,
    "posts_sample_median_views": 0,
    "top_post": {
      "url": "<string>",
      "views": 0,
      "excerpt": "<string>"
    },
    "recurring": [
      "<string>"
    ],
    "latest_at": "<date-time>",
    "as_of": "<date-time>"
  },
  "offerings": [
    {
      "unit_id": "<uuid>",
      "format": "post",
      "label": "<string>",
      "deliverable": "<string>",
      "price_cents": 0,
      "buyable": false,
      "price_as_of": "<date>",
      "expected_views": 0,
      "cost_per_1k_views_cents": 0,
      "provenance": {
        "source": "<string>",
        "method": "<string>",
        "measured_at": "<string>",
        "expires_at": "<string>",
        "label": "Verified",
        "stale": false,
        "as_of": "<string>"
      },
      "calc": {
        "calc_version": "<string>",
        "inputs": {}
      }
    }
  ],
  "synced_at": "<date-time>",
  "refresh_failed_at": "<date-time>",
  "advice": {
    "recommended": "post",
    "reason": "<string>"
  }
}

inventory: Network coverage
resolve_audience: Resolve an audience
campaign_status: Campaign status
evidence: Proof of delivery
results: Results
brain_get: Company context
creators_search: Find creators
creator_ask_price: Ask for a price
plan_quote: Quote a plan
create_campaign: Start a campaign
plan_add_creator: Add a creator
plan_remove_creator: Remove a creator
plan_move_dates: Move a plan's dates
plan_swap_creator: Swap a creator
set_creator_guidelines: Set the creator guidelines
approve_plan: Approve and get the pay link
archive_campaign: Archive a campaign
rename_campaign: Rename a campaign
delete_campaign: Delete a draft campaign
feedback_send: Send feedback
feedback_list: Your feedback

Get access

Keys are created in Developers once your brand is approved. Connect an agent to ask for access, then read the agent guide for the full flow.

Overview

Arguments

Call with curl

Result

Other tools

Get access