{"openapi":"3.1.0","info":{"title":"Scrape Creators API","description":"The easiest way to scrape public social media data at scale. Extract profiles, posts, videos, comments, and more from TikTok, Instagram, YouTube, Twitter, LinkedIn, Facebook, Reddit, and 27+ platforms.","version":"1.0.0","contact":{"name":"Scrape Creators","url":"https://scrapecreators.com","email":"support@scrapecreators.com"}},"servers":[{"url":"https://api.scrapecreators.com","description":"Production server"}],"security":[{"apiKeyAuth":[]}],"tags":[{"name":"Creator Tools","description":"Tools for finding and analyzing creator profiles"}],"paths":{"/v1/find-creator-emails":{"get":{"tags":["Creator Tools"],"summary":"Find Creator Emails","description":"Accepts a supported platform and creator handle, using the same verified social-profile discovery flow as Find Social Profiles. Supported starting platforms are Instagram, TikTok, YouTube, X/Twitter, and Facebook. A leading @ is optional; YouTube also accepts channel IDs. Scans publicly listed profile bios and contact links, recognized link-in-bio pages, and a bounded set of creator-declared public website pages. Other accounts are scanned only when explicitly linked or verified through reciprocal profile links or shared owner-controlled websites. Returns deduplicated email addresses with available public source URLs and source types. URLs from internal-only sources are omitted from email provenance and scan diagnostics; an email found only through those sources has an empty sources array. Partial and limited-scan flags still reflect the complete scan. Addresses may belong to the creator, their management, or a booking contact; the endpoint does not guess addresses or verify mailbox deliverability. Login-only contact details and private account data are not accessed. A successful lookup with no publicly listed email returns an empty emails array. Optional failed or timed-out scans are reported with partial results and diagnostics, so an empty partial result is not proof that no address exists. Live lookups cost 10 credits, including successful empty results. Cache hits cost 0 credits. Missing or invalid inputs, missing source profiles, and failed lookups are not charged. Multi-source discovery can take several seconds and may time out; retry failed requests rather than treating them as no-email results. Contact fields come from public creator pages. To request removal of your own information from Scrape Creators results, email support@scrapecreators.com with the profile URL.","parameters":[{"name":"platform","in":"query","required":true,"description":"Source social platform","schema":{"type":"string","enum":["instagram","tiktok","youtube","x","twitter","facebook"]},"example":"instagram"},{"name":"handle","in":"query","required":true,"description":"Creator handle without a profile URL. A leading @ is optional.","schema":{"type":"string"},"example":"miguelangeles"},{"name":"cache_max_age","in":"query","required":false,"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (10 credits). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","schema":{"type":"string","enum":["1d","3d","7d","14d","30d"]},"example":"7d"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"success":true,"credits_remaining":100,"credits_charged":10,"source":{"platform":"instagram","handle":"miguelangeles","url":"https://www.instagram.com/miguelangeles"},"emails":[{"email":"booking@amsbooking.fr","sources":[{"url":"https://www.instagram.com/miguelangeles","type":"social_profile"}]}],"scanned_profile_urls":["https://www.instagram.com/miguelangeles"],"failed_email_scan_urls":[],"email_scan_limited":true,"link_in_bio_urls":[],"expanded_website_urls":["https://irlangel.com/"],"partial":true,"failed_link_in_bio_urls":[],"failed_website_urls":[],"source_linked_profile_urls":[],"failed_source_linked_profile_urls":[],"same_handle_candidate_urls":["https://www.tiktok.com/@miguelangeles"],"same_handle_search_partial":false,"google_search_used":true,"google_search_failed":false,"google_candidate_urls":[],"google_candidate_link_in_bio_urls":[],"failed_google_candidate_link_in_bio_urls":[],"verified_google_candidate_urls":[],"failed_google_candidate_urls":[],"google_verification_partial":false}}}}}}}},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your Scrape Creators API key"}}}}