POST/emails

Find verified contact emails

Run the Stormy enrichment chain for 1–25 Instagram, TikTok, or YouTube profiles. Only successful verified finds are billed at $0.15 — attempts that return nothing cost $0. Search and profile responses always strip contact fields; this endpoint is the only way to get them.

Request body

platformstringrequired

instagram, tiktok, or youtube.

targetsstring[]required

Between 1 and 25 handles, profile URLs, usernames, or channel IDs.

Example request

curl -X POST 'https://stormy.ai/api/v1/emails' \
  -H 'Authorization: Bearer YOUR_STORMY_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"platform":"youtube","targets":["@buildwithalex","@roofinginsights"]}'

Every response includes a usage receipt: operation · metered_results · billed_results · cost_usd · credits · remaining_usage_usd. Reusing an Idempotency-Key returns the existing receipt instead of charging twice.