get_creator
Retrieve a creator's full record by UUID or by platform and username. Includes optional social profile summaries.
Instructions
Fetch the full record for a single creator by ID or exact platform username.
Use this when you already have either:
a canonical creator UUID returned by
search_creators,semantic_search_creators,autocomplete_creators, orfind_lookalike_creators; oran exact platform+username pair such as platform "instagram" and username "niickjackson".
Pass include: ['profiles'] to also receive the creator's social profile
summaries when using a creator UUID. For platform+username inputs, this tool resolves
through the profile endpoint and returns the profile record plus the underlying creator
record, so you already get the matched profile context.
Examples:
User: "Get creator 123e4567-e89b-12d3-a456-426614174000" -> call with id.
User: "Get @niickjackson on Instagram" -> call with platform "instagram" and username "niickjackson", or use
get_profileif profile metrics are the main need.User: "Tell me about @niickjackson and include his profiles" -> use platform "instagram" and username "niickjackson"; then use
get_profile/get_postsfor platform-specific metrics and content if needed.
Use lookup_profiles for batch exact profile lookups.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Creator unique identifier | |
| platform | No | Social platform for the username. | |
| username | No | Platform username or handle without the @ sign. | |
| include | No | Additional data to include in response |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| results | No | ||
| count | No | ||
| ok | No | ||
| not_found | No | ||
| has_more | No | ||
| next_cursor | No | ||
| suggested_followups | No |