Responses below are illustrative reconstructions, not verbatim terminal output. Exact wording, table layout, and credit numbers will vary across runs.
Example 1: Check your account balance
To check your CreatorDB account balance, you can use theaccount skill. For example, you can prompt Claude Code with the following query:
- Prompt example
- Response example
account skill to call the CreatorDB API and retrieve your account information.Example 2: Search for a specific creator
To search for a specific creator, you can use thecreator-search skill. For example, to find information about the YouTube creator “PewDiePie”, you can prompt Claude Code with the following query:
- Prompt example
- Response example
creator-search skill to call the CreatorDB API.Example 3: Search for creators that meet specific conditions
To search for creators based on specific criteria, you can use thecreator-search skill. For example, to find Instagram creators in the US “gaming” category with more than 1 million followers and high engagement rates, you can prompt Claude Code with the following query:
- Prompt example
- Response example
creator-search skill to call the CreatorDB API.Example 4: Build an outreach list end-to-end
To create an outreach list of potential creator partners for a campaign, you can use a combination of thecreator-search and creator-enrichment skills. For example, to find 50 beauty TikTokers with more than 500,000 subscribers in the US with high engagement rates and retrieve their contact information, you can prompt Claude Code with the following query:
- Prompt example
- Response example
creator-search and creator-enrichment skills to call the CreatorDB API.Examples 5a-5c each show a different cut of the
brand-sponsorship skill: known brand → roster (5a), vertical → brands (5b), brand → spend estimate (5c).Example 5: Brand and sponsorship analysis
The following examples show how to use thebrand-sponsorship skill to analyze a brand’s sponsored creator roster, identify which brands are active in a specific vertical, and estimate a brand’s monthly spend on creator partnerships.
5a: Verify a brand’s sponsored creator roster
To verify a brand’s sponsored creator roster, you can use thebrand-sponsorship skill. For example, to find out which creators are sponsored by Adidas, you can prompt Claude Code with the following query:
- Prompt example
- Response example
brand-sponsorship skill to call the CreatorDB API.5b: Retrieve brands sponsoring creators
To retrieve data on brands sponsoring creators, you can use thebrand-sponsorship skill. For example, to find the top 10 brands sponsoring US gaming YouTubers, you can prompt Claude Code with the following query:
- Prompt example
- Response example
brand-sponsorship skill to call the CreatorDB API.5c: Estimate brand spend on sponsoring creators
To retrieve data on a brand’s spend on sponsoring activities, you can use thebrand-sponsorship skill. For example, to find Nvidia’s latest sponsoring activities, you can prompt Claude Code with the following query:
- Prompt example
- Response example
brand-sponsorship skill to call the CreatorDB API.Example 6: Transcribe a video for content analysis
To transcribe a video for content analysis, you can use thecontent-analysis skill. For example, to transcribe a creator’s video to find out if they mention a specific brand, you can use the following prompt:
- Prompt example
- Response example
content-analysis skill to call the CreatorDB API.Example 7: Submit and enrich creator list in CSV format
To submit and enrich a creator list in CSV format, you can use thecreator-csv-workflow skill. For example, if you have a CSV file with a list of YouTube creator channel IDs and you want to enrich it with additional data from CreatorDB, you can follow these steps:
1
Get a list of creator account or channel IDs.
a. Obtain YouTube creator channel IDs through any of the following methods:
- Call the CreatorDB API.
You can call the CreatorDB API using the
creator-search skill in Claude Code to find creators based on specific criteria (e.g., niche, subscriber count, location). This will return a list of creator profiles, including their channel IDs, which you can then export to a CSV file for enrichment. For details, see Examples 2 and 3 in this guide on how to use the creator-search skill effectively.- Search social media platforms, such as YouTube.
- Use your own database.
- Purchase a list from a data provider.
b. Ensure that the channel IDs are in a CSV format with a header row (e.g.,channelId).
2
Prompt Claude Code to enrich the creator list.
Prompt Claude Code with the following query, replacing Claude Code will then use the
For example, if your original CSV had a
The following is an example of the messages returned for a successful enrichment of a list of 50 gaming YouTubers:Results
path/to/your/creators.csv with the actual path to your CSV file:creator-csv-workflow and creator-enrichment skills to call the CreatorDB API and enrich your creator list with additional data such as subscriber count, engagement metrics, audience demographics, and more. The final output should be an enriched CSV file with the new data columns added, which you can use for further analysis or outreach. For example, if your original CSV had a
channelId column, the enriched CSV might include additional columns like displayName, totalSubscribers, engagementRate, audienceAgeRange, etc., depending on the data available for each creator in CreatorDB. The following is an example of the messages returned for a successful enrichment of a list of 50 gaming YouTubers:Results
Bio-first saved ~165 cr vs always calling
/contact (would’ve been 50 × 27 = 1,350).Output- Enriched data:
/{YOUR WORKING DIRECTORY}/{FILENAME}.csv— 50 rows × 40 columns (profile + audience demographics + emails +_row_id/email_source/_credits_used/_errorbookkeeping). - Summary:
/{YOUR WORKING DIRECTORY}/{FILENAME}.csv— totals + failed-row list (empty). - Script:
/{YOUR WORKING DIRECTORY}/{SCRIPTNAME}.py(kept, in case you want to re-run or adapt).