SSR Quick-Reference: TikTok & Instagram Clay HTTP API Columns
In any Clay table, click Add enrichment → HTTP API and paste the fields below:
| Clay Panel Field | TikTok Creator Profile | Instagram Creator Profile |
|---|---|---|
| Method | GET | GET |
| Endpoint | https://api.shortvidapi.com/v1/user/info?unique_id={{tiktok_handle}} | https://api.shortvidapi.com/v1/instagram/profile?username={{instagram_handle}} |
| Headers | Authorization: Bearer YOUR_API_KEY | Authorization: Bearer YOUR_API_KEY |
| Followers Path | data.stats.followerCount | data.follower_count |
| Likes / Posts Path | data.stats.heartCount · data.stats.videoCount | data.media_count |
| Bio & Link Path | data.user.signature · data.user.bioLink.link | data.biography · data.external_url |
| Exact Unit Rate | 10 credits ($1.00/1K PAYG · $0.40/1K Scale) | 10 credits ($1.00/1K PAYG · $0.40/1K Scale) |
Bonus: Extract public creator emails in a 0-credit Clay Formula column
Once you map data.user.signature (TikTok) or data.biography (Instagram) to a bio column, add a free Formula column in Clay to extract any public business inquiry email at $0 extra cost:
({{bio}} || "").match(/[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/)?.[0]?.toLowerCase() || ""Frequently Asked Questions
Can I use ShortVid API in Clay's HTTP API column without spending Clay credits?
Yes. Clay's HTTP API integration lets you bring your own API key at 0 Clay enrichment credits per row. On ShortVid API, creator profile lookups (GET /v1/user/info and GET /v1/instagram/profile) cost 10 ShortVid credits per profile ($1.00 per 1,000 profiles on PAYG = $0.001/profile, or $0.40 per 1,000 profiles on Business Scale = $0.0004/profile).
Do I need to clean '@' symbols or full TikTok/Instagram URLs in Clay before calling the endpoint?
No. Both GET /v1/user/info?unique_id={{tiktok_handle}} and GET /v1/instagram/profile?username={{instagram_handle}} accept @handle, plain handle, or full https://www.tiktok.com/@handle / https://www.instagram.com/handle/ URLs natively.
What happens in Clay if a handle doesn't exist or was renamed?
Non-existent or private handles return HTTP 404 not_found and deduct 0 ShortVid API credits, so noisy lead lists never waste your balance.