{"schema_version":1,"name":"Roster Creator Data API","description":"Search the creator directory and read stored creator profiles with a read-only data key.","base_url":"https://api.ugcroster.com/v1","authentication":{"type":"http_bearer","key_type":"data","signup_url":"https://api.ugcroster.com/keys"},"documentation_url":"https://api.ugcroster.com/docs","openapi_url":"https://api.ugcroster.com/v1/openapi.json","mcp":{"url":"https://api.ugcroster.com/v1/mcp","transport":"streamable-http","data_key_tools":["search_creators","get_creator","get_usage"]},"skill_url":"https://api.ugcroster.com/integrations/creator-data-skill.md","pricing":{"currency":"USD","model":"prepaid_usage_based","active_subscription_required":false,"free_tier":true,"free_tier_type":"one_time_trial","free_trial":{"credits":50,"recurring":false,"credit_card_required":false,"verified_email_required":true,"eligibility":"New API customers; one grant per account and email, subject to availability and abuse limits","signup_url":"https://api.ugcroster.com/keys"},"search_page_credits":10,"profile_read_credits":1,"free_operations":["usage checks","connection verification","documentation and workflow downloads"],"billing_url":"https://api.ugcroster.com/keys","plans":[],"topups":[{"id":"credits-5k-v1","credits":5000,"price_usd":25},{"id":"credits-25k-v1","credits":25000,"price_usd":125},{"id":"credits-100k-v1","credits":100000,"price_usd":500}],"auto_reload":{"available":true,"default_enabled":false,"requires_customer_consent":true,"monthly_spend_cap_required":true},"pricing_url":"https://api.ugcroster.com/pricing"},"endpoints":[{"method":"GET","path":"/creators/search","mcp_tool":"search_creators","credits":10,"max_results_per_page":100,"read_only":true},{"method":"GET","path":"/creators/{pk}","mcp_tool":"get_creator","credits":1,"id_source":"pk from search results","read_only":true},{"method":"GET","path":"/usage","mcp_tool":"get_usage","credits":0,"read_only":true}],"limitations":["Stored directory data; a profile read does not trigger a live scrape.","Creator location does not describe audience location.","An email on file does not guarantee deliverability.","Data keys cannot send messages, create campaigns or issue payouts."],"credit_exhaustion":{"code":"CREDITS_EXHAUSTED","retry_until_funded":false,"preserve_completed_results":true,"resume_unfinished_work_after_funding":true,"billing_url":"https://api.ugcroster.com/keys"},"suggested_agent_policy":{"task_scope":"creator discovery and directory profile lookup","default_search_pages":1,"default_profile_reads":0,"automatic_topups":false,"automatic_retries":false,"note":"These are client instructions, not server-enforced per-job limits. Respect the user-approved budget."}}