Skip to content
ShortVid API

Enrich TikTok & Instagram Creators in Clay via HTTP API

Replace 2-credit Clay social enrichments (~$0.14/row) with a direct Clay HTTP API column calling /v1/user/info and /v1/instagram/profile at $0.0004–$0.001 per profile ($0.40/1K Business Scale · $1.00/1K PAYG, 0 credits on 404).

Interactive Clay HTTP API Column Builder

Clay's HTTP API enrichment column is configured field-by-field (no JSON upload). Set your Clay input column variable below and copy each field in one click.

10 credits / profile (0 on 404)
Auth Header Format:

1. Method

GET

2. Endpoint

https://api.shortvidapi.com/v1/user/info?unique_id={{tiktok_handle}}

3. Headers (Key / Value or JSON)

Authorization: Bearer YOUR_API_KEY

4. Run Settings -> Only run if (prevents re-billing filled rows)

!!{{tiktok_handle}} && !{{followerCount}}
Accepts @handle, plain handle, or full profile URLs automatically — no pre-cleaning formula required.

5. Clay Output Columns — Click Any JSON Path to Copy

Clay ColumnResponse JSON PathDescription & SampleAction
followerCountdata.stats.followerCountLive TikTok follower count (e.g. 2434111)
heartCountdata.stats.heartCountCumulative lifetime likes across all public videos (e.g. 31638808)
videoCountdata.stats.videoCountTotal published public videos (e.g. 986)
biodata.user.signatureCreator bio text (parse with Clay regex for public email) (e.g. The entrepreneurship company · press@brand.com)
bioWebsitedata.user.bioLink.linkClickable external website / storefront link in bio (e.g. shopify.supply)
verifieddata.user.verifiedBlue-checkmark verification badge (e.g. true)
isBusinessAccountdata.user.isBusinessAccountTikTok Business Account indicator (e.g. true)
secUiddata.user.secUidImmutable sec_uid for chaining /v1/user/posts (e.g. MS4wLjABAAAA...)

Unit Economics · Bring Your Own API Key in Clay

Clay Native Credits vs. ShortVid HTTP API

Clay Native Enrichment (~2 credits/row)

$1,400.00

~$0.14 / enriched creator row

ShortVid PAYG ($1.00 / 1K ($0.001 / profile))

$10.00

Paid credits never expire · 0 charge on 404 handles

ShortVid Business Scale ($0.40 / 1K ($0.0004 / profile))

$4.00

600 RPM · Save 99.7% vs native credits

New accounts get 10,500 Free Credits ($1.05) instantly — enough to enrich 1,050 creator profiles in Clay with no credit card.Get Free API Key (1,050 Profiles) →

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 FieldTikTok Creator ProfileInstagram Creator Profile
MethodGETGET
Endpointhttps://api.shortvidapi.com/v1/user/info?unique_id={{tiktok_handle}}https://api.shortvidapi.com/v1/instagram/profile?username={{instagram_handle}}
HeadersAuthorization: Bearer YOUR_API_KEYAuthorization: Bearer YOUR_API_KEY
Followers Pathdata.stats.followerCountdata.follower_count
Likes / Posts Pathdata.stats.heartCount · data.stats.videoCountdata.media_count
Bio & Link Pathdata.user.signature · data.user.bioLink.linkdata.biography · data.external_url
Exact Unit Rate10 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.