Profile
1 credit/v1/kwai/profileGet a Kwai user profile.
handle, url
Fetch public Kwai data as structured JSON with one SocialCrawl API key. Same Post, Comment, and Author schema as every other platform. Reads are priced in credits.
3 active endpoints
3 live read endpoints for public Kwai data. Profiles, user posts, and single posts. Data API only.
/v1/kwai/profileGet a Kwai user profile.
handle, url
/v1/kwai/user/postsList a Kwai user's posts.
handle, url, cursor, count
/v1/kwai/postGet a Kwai post.
url
Returns a Kwai account's public profile: username, bio, avatar, verification status, and follower, following, like, and post counts.
Use it for a snapshot of an account by handle or profile URL, before pulling what it has posted with user/posts.
1 credit
$ curl https://www.socialcrawl.dev/v1/kwai/profile?handle=KwaiBrasilOficial \
-H "x-api-key: sc_YOUR_API_KEY"// Running this live needs your own API key. Hit "Try it" to see an example responseKwai is a normal SocialCrawl social surface. You call GET /v1/kwai/… with an API key, spend credits on live misses, and get a single JSON envelope back. No second SDK.
Send your key in the x-api-key header. The same key works across the SocialCrawl catalog.
Routes are GET. Pass handles, urls, queries, and cursors as query strings. We validate formats before charging.
Live misses debit the route tier. Cache hits cost 0. Empty or hard failures refund.
Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached.
Most products resolve an account, page content, then deepen only the posts that matter.
GET /v1/kwai/profileAuthor-shaped profile
Resolve the handle or id once.
GET /v1/kwai/user/postsPostList of recent public items
Page with cursor or after when the route supports it.
GET /v1/kwai/postFull Post for one URL or id
List rows are not enough when you need the full record.
GET /v1/kwai/postCommentList when the platform exposes it
Expand only when a thread matters.
GET /v1/kwai/profile
?handle=KwaiBrasilOficial
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here{
"success": true,
"data": { "/* Author | Post | PostList | CommentList | … */": true },
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}Field names match the rest of SocialCrawl where archetypes align.
id, username, display_name, avatar_url, bio, followers, url, ext
items[].post with id, url, content, engagement, author, published_at, ext
items[] with author, content.text, engagement, published_at when comments ship
search hits, media metadata, or transcripts depending on route
Same request lifecycle as every other /v1 platform endpoint.
Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit and concurrency.
Registry lookup finds the route. Required params run first. Invalid input returns 400 with no charge. Valid calls debit before upstream work.
A deterministic cache key is built from platform + resource + params. Hit: credits_used = 0. Miss: upstream fetch with retries and circuit breaker.
Upstream JSON is mapped to Author / Post / PostList / CommentList (or route archetype), validated, wrapped in the success envelope, and logged for billing audit.
Billing rules that matter in production
Kwai is public-read data on SocialCrawl. We normalize it into the shared schema so your code does not learn a second OAuth flow.
Public Kwai surfaces exposed by the registry. Read-only for research, monitoring, and product jobs.
Social-read upstreams behind one gateway. Prism composites combine legs when a fat route is registered.
Unified JSON envelope: success, data, credits_used, request_id, cached. Shared Author / Post / Comment leaves where archetypes align.
No write endpoints and no private inbox. Disabled routes stay out of the active count. Prefer registry docs for the live inventory.
The jobs this API is most often used for.
Kwai monitoring and content intelligence
Callers concentrate on profile, content lists, search, and deepen paths on Kwai. Structured Kwai JSON on the shared schema with one SocialCrawl API key.
Detail reads are typically a few seconds on live miss. Search and fat composites are slower paths.
Common ways teams put this data to work, and the stack each one tends to run.
Poll profiles and feeds on Kwai. Alert when engagement velocity jumps.
Search and expand posts for brand, product, and competitor language on Kwai.
Wire resolve to list to detail into pipelines. Cache hits keep recurring runs cheap.
Live misses spend credits by tier. Cache hits are free. Empty or hard failures refund.
curl "https://www.socialcrawl.dev/v1/kwai/profile?handle=KwaiBrasilOficial" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/kwai/user/posts?handle=KwaiBrasilOficial" \
-H "x-api-key: sc_your_api_key_here"Same key as the rest of the catalog
Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.
Same Kwai data, two very different paths. Auth, rate limits, schema, and cost, side by side.
| Feature | SocialCrawl | DIY scraping |
|---|---|---|
| Setup | Sign up and send one GET request | Reverse-engineer kwai.com, then build proxies and parsers |
| Authentication | One x-api-key header | None: you manage IP rotation and bot detection yourself |
| Response schema | Unified JSON, same shape as TikTok and Instagram | Raw HTML or private JSON you normalize yourself |
| Pricing | 1 credit per request; 100 free credits on signup | Proxy, server, and engineering costs that scale with volume |
| Data coverage | Profiles, paginated post feeds, and video details | Whatever your scraper can reach before it breaks |
| Maintenance | SocialCrawl absorbs Kwai frontend changes upstream | Every Kwai update can silently break your pipeline |
Setup
Authentication
Response schema
Pricing
Data coverage
Maintenance
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usAsk AI about SocialCrawl