--- title: "creator_get: One creator | distribution.tech" description: "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." canonical: https://distribution.tech/docs/mcp/tools/creator-get generator: md-live-route generated: 2026-10-21T22:49:39.743Z --- # creator_get: One creator | distribution.tech - [Getting started](https://distribution.tech/docs) - [API reference](https://distribution.tech/docs/api) - [MCP and agents](https://distribution.tech/docs/agents) - [Changelog](https://distribution.tech/docs/changelog) Search the docs Docs - Agents › - [Run a campaign with your agent](https://distribution.tech/docs/agents) - [MCP server](https://distribution.tech/docs/mcp) - MCP tools › - [inventory](https://distribution.tech/docs/mcp/tools/inventory) - [resolve\_audience](https://distribution.tech/docs/mcp/tools/resolve-audience) - [campaign\_status](https://distribution.tech/docs/mcp/tools/campaign-status) - [evidence](https://distribution.tech/docs/mcp/tools/evidence) - [results](https://distribution.tech/docs/mcp/tools/results) - [brain\_get](https://distribution.tech/docs/mcp/tools/brain-get) - [creators\_search](https://distribution.tech/docs/mcp/tools/creators-search) - [creator\_get](https://distribution.tech/docs/mcp/tools/creator-get) - [creator\_ask\_price](https://distribution.tech/docs/mcp/tools/creator-ask-price) - [plan\_quote](https://distribution.tech/docs/mcp/tools/plan-quote) - [create\_campaign](https://distribution.tech/docs/mcp/tools/create-campaign) - [plan\_add\_creator](https://distribution.tech/docs/mcp/tools/plan-add-creator) - [plan\_remove\_creator](https://distribution.tech/docs/mcp/tools/plan-remove-creator) - [plan\_move\_dates](https://distribution.tech/docs/mcp/tools/plan-move-dates) - [plan\_swap\_creator](https://distribution.tech/docs/mcp/tools/plan-swap-creator) - [set\_creator\_guidelines](https://distribution.tech/docs/mcp/tools/set-creator-guidelines) - [approve\_plan](https://distribution.tech/docs/mcp/tools/approve-plan) - [archive\_campaign](https://distribution.tech/docs/mcp/tools/archive-campaign) - [rename\_campaign](https://distribution.tech/docs/mcp/tools/rename-campaign) - [delete\_campaign](https://distribution.tech/docs/mcp/tools/delete-campaign) - [feedback\_send](https://distribution.tech/docs/mcp/tools/feedback-send) - [feedback\_list](https://distribution.tech/docs/mcp/tools/feedback-list) 1. [distribution](https://distribution.tech/) 2. / [Docs](https://distribution.tech/docs) 3. / [MCP tools](https://distribution.tech/docs#mcp) 4. / creator\_get MCP tool # One creator creator\_get 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. Copy page as markdown [View .md](https://distribution.tech/docs/mcp/tools/creator-get.md) ## 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}](https://distribution.tech/docs/api/get-creators-id) ## Arguments | 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": "" } } }' ``` ## Result The answer's `structuredContent` follows the tool's output schema (the same JSON is in its text content). It has these fields: | Name | Type | Required | Description | | --- | --- | --- | --- | | `provenance` | object | No | DT-159: where each of the creator's measured numbers came from, one entry per stat (served since DT-159; documented from 1.25.2, DT-160). | | `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 ``` { "provenance": { "followers": { "source": "", "method": "", "measured_at": "", "expires_at": "", "label": "Verified", "stale": false, "as_of": "" }, "median_views_30d": { "source": "", "method": "", "measured_at": "", "expires_at": "", "label": "Verified", "stale": false, "as_of": "" }, "engagement_rate_30d": { "source": "", "method": "", "measured_at": "", "expires_at": "", "label": "Verified", "stale": false, "as_of": "" } }, "id": "", "handle": "", "name": "", "url": "", "status": "approved", "status_label": "", "status_reason": "", "in_automatic_plans": false, "match_score": 0, "match_label": "", "on_sale": false, "reach_band": "nano", "median_views_30d": 0, "median_views_30d_network": 0, "followers": 0, "verified_badge": false, "country": "", "language": "", "segments": [ "" ], "bio": "", "positioning": "", "avatar_url": "", "ask_price": false, "price_estimate": { "min_usd": 0, "max_usd": 0, "label": "", "provenance": { "source": "", "method": "", "measured_at": "", "expires_at": "", "label": "Verified", "stale": false, "as_of": "" }, "calc": { "calc_version": "", "inputs": {} } }, "engagement_rate_30d": 0, "posts_per_week": 0, "match_reasons": [ { "kind": "topic", "text": "" } ], "past_collabs": [ { "project": "", "title": "", "date": "", "role": "Launch post", "url": "", "brand": { "handle": "", "avatar_url": "", "site": "", "initials": "" } } ], "recent_posts": [ { "url": "", "text": "", "posted_at": "", "views": 0, "likes": 0, "reposts": 0, "replies": 0, "quotes": 0 } ], "posts_summary": { "posts": 0, "window_days": 0, "capped": false, "median_views": 0, "posts_sample_median_views": 0, "top_post": { "url": "", "views": 0, "excerpt": "" }, "recurring": [ "" ], "latest_at": "", "as_of": "" }, "offerings": [ { "unit_id": "", "format": "post", "label": "", "deliverable": "", "price_cents": 0, "buyable": false, "price_as_of": "", "expected_views": 0, "cost_per_1k_views_cents": 0, "provenance": { "source": "", "method": "", "measured_at": "", "expires_at": "", "label": "Verified", "stale": false, "as_of": "" }, "calc": { "calc_version": "", "inputs": {} } } ], "synced_at": "", "refresh_failed_at": "", "advice": { "recommended": "post", "reason": "" } } ``` ## Other tools - [`inventory`](https://distribution.tech/docs/mcp/tools/inventory): Network coverage - [`resolve_audience`](https://distribution.tech/docs/mcp/tools/resolve-audience): Resolve an audience - [`campaign_status`](https://distribution.tech/docs/mcp/tools/campaign-status): Campaign status - [`evidence`](https://distribution.tech/docs/mcp/tools/evidence): Proof of delivery - [`results`](https://distribution.tech/docs/mcp/tools/results): Results - [`brain_get`](https://distribution.tech/docs/mcp/tools/brain-get): Company context - [`creators_search`](https://distribution.tech/docs/mcp/tools/creators-search): Find creators - [`creator_ask_price`](https://distribution.tech/docs/mcp/tools/creator-ask-price): Ask for a price - [`plan_quote`](https://distribution.tech/docs/mcp/tools/plan-quote): Quote a plan - [`create_campaign`](https://distribution.tech/docs/mcp/tools/create-campaign): Start a campaign - [`plan_add_creator`](https://distribution.tech/docs/mcp/tools/plan-add-creator): Add a creator - [`plan_remove_creator`](https://distribution.tech/docs/mcp/tools/plan-remove-creator): Remove a creator - [`plan_move_dates`](https://distribution.tech/docs/mcp/tools/plan-move-dates): Move a plan's dates - [`plan_swap_creator`](https://distribution.tech/docs/mcp/tools/plan-swap-creator): Swap a creator - [`set_creator_guidelines`](https://distribution.tech/docs/mcp/tools/set-creator-guidelines): Set the creator guidelines - [`approve_plan`](https://distribution.tech/docs/mcp/tools/approve-plan): Approve and get the pay link - [`archive_campaign`](https://distribution.tech/docs/mcp/tools/archive-campaign): Archive a campaign - [`rename_campaign`](https://distribution.tech/docs/mcp/tools/rename-campaign): Rename a campaign - [`delete_campaign`](https://distribution.tech/docs/mcp/tools/delete-campaign): Delete a draft campaign - [`feedback_send`](https://distribution.tech/docs/mcp/tools/feedback-send): Send feedback - [`feedback_list`](https://distribution.tech/docs/mcp/tools/feedback-list): Your feedback ## Get access Keys are created in Developers once your brand is approved. [Connect an agent](https://distribution.tech/distribution#access) to ask for access, then read [the agent guide](https://distribution.tech/docs/agents) for the full flow. On this page - [Overview](#overview) - [Arguments](#arguments) - [Call with curl](#curl) - [Result](#result) - [Other tools](#related) - [Get access](#access) [![distribution.tech](https://distribution.tech/brand/wordmark-light.svg)![distribution.tech](https://distribution.tech/brand/wordmark.svg)](https://distribution.tech/) Your agent buys your distribution. Distribution we run for - ClickUp - Gushwork - Tab Platform - [How it works](https://distribution.tech/how-it-works) - [Network](https://distribution.tech/network) - [Workspace](https://app.distribution.tech/login) - [For your agents](https://distribution.tech/distribution) Solutions - [Product launch](https://distribution.tech/solutions/product-launch) - [Funding announcement](https://distribution.tech/solutions/funding-announcement) - [Feature release](https://distribution.tech/solutions/feature-release) - [For brands](https://distribution.tech/for-brands) - [For creators](https://distribution.tech/for-creators) Resources - [Blog](https://distribution.tech/blog) - [Launch playbook](https://distribution.tech/playbook) - [X creator rates](https://distribution.tech/rates/x-creators) Company - [Customers](https://distribution.tech/customers) - [Pricing](https://distribution.tech/pricing) - [Changelog](https://distribution.tech/changelog) - [Build a distribution plan](https://app.distribution.tech/login) - [Join the creator network](https://distribution.tech/for-creators#apply) - [Log in](https://app.distribution.tech/login) Legal - [Privacy](https://distribution.tech/privacy) - [Terms](https://distribution.tech/terms) © 2026 distribution.tech [Contact: team@distribution.tech](mailto:team@distribution.tech)Cookie settings Light Dark System