POST/profile

Look up one profile

Resolve a profile URL, @handle, username, or channel ID into one normalized profile. Optionally include recent public posts. Fresh lookups pull current metrics from the source.

Request body

targetstringrequired

Profile URL, handle, username, channel ID, or public identifier.

platformstring | null

Optional when the target URL identifies the network.

freshboolean · default false

Refresh current profile metrics from the source at $0.05.

include_postsboolean · default false

Include recent public posts or videos when supported.

Example request

curl -X POST 'https://stormy.ai/api/v1/profile' \
  -H 'Authorization: Bearer YOUR_STORMY_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"target":"https://tiktok.com/@creator","fresh":true,"include_posts":true}'

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.