kwai/
post

The Kwai Post API retrieves one public Kwai post from a known kwai.com or kwai-video.com URL, returning normalized text, author, media, timestamps, and visible engagement.

Kwai Post API

Known post URL
Post and author context
Fixed task cost
0.19 credits / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Kwai Post

Kwai posts are public content records that can pair text and media with author identity, hashtags, mentions, publication time, and visible engagement. These fields support URL catalog enrichment, content review, and point-in-time comparison of selected posts.

Kwai Post API Features

  • Single known-URL lookupResolve one public URL on kwai.com, kwai-video.com, or their subdomains without adding an unverified path rule.
  • Post and author contextReturn post identity, source URL, text, publication time, and available author ID, username, display name, profile URL, avatar, and account flags.
  • Media and content entitiesKeep available media references, previews, dimensions, duration, hashtags, and mentions alongside the post record.
  • Visible engagement snapshotNormalize available like, comment, share, and view counts with collected_at so the record has a clear observation time.

Kwai Post API Parameters

ParametersRequiredDescription
urlRequiredRequired non-empty URL with a parseable kwai.com or kwai-video.com hostname, including supported subdomains. The runtime does not require a particular path pattern.

How to Use the Kwai Post API

Submit one accepted Kwai URL to the Kwai Post API, track the asynchronous task, and read the normalized post record after completion.

  1. Confirm that the URL includes a parseable hostname on kwai.com, kwai-video.com, or an accepted subdomain.
  2. POST the url string to /v1/kwai/post and save the returned task_id.
  3. Poll /v1/tasks/{task_id} until the task succeeds or fails.
  4. Read data.results.items after success. The detail provider can save at most one post, so has_more should normally be false even though the task-results route exposes next_cursor.
curl -X POST "https://api.socq.ai/v1/kwai/post" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.kwai.com/@ShortShortz8/photo/5235021727595785285"}'

# Poll GET /v1/tasks/{task_id}
# Read the normalized post from data.results.items

Kwai Post API Use Cases

  • Enrich a known-post catalog: Replace a stored Kwai link with normalized post ID, text, author identity, publication time, and source fields.
  • Review selected post content: Use text, media references, hashtags, mentions, and author context to inspect an approved set of individual posts.
  • Compare engagement snapshots: Repeat lookups at defined times and pair visible like, comment, share, and view counts with collected_at for point-in-time comparison.

Kwai Post API Pro Tips

  • Include a URL scheme so the hostname can be parsed, and use the exact public post link rather than a bare account name.
  • Submit one URL per task because this detail endpoint accepts a single url field and has no results_limit or batch input.
  • Preserve the submitted URL when a successful task returns no item, since an accepted hostname does not guarantee that the provider can resolve the resource.
  • Store optional author, media, entity, and engagement fields defensively because a public post may not expose every normalized field.
  • Use collected_at with every metric comparison and do not treat visible counters as a live feed.

Beyond the Kwai Post API, use these APIs when you need a different type of public Kwai data.

  • Kwai Profile API — Retrieve one public Kwai profile by username or supported URL with normalized identity, imagery, account flags, visible counts, and collection context.
  • Kwai User Posts API — Collect one page of public Kwai posts by username or supported profile URL with normalized content, authors, media, timestamps, hashtags, mentions, and visible engagement.

Explore other platforms

Combine Kwai data with public data from other supported social platforms.

Kwai Post API — FAQ

Kwai Post API is a programmatic interface for retrieving one public Kwai post from a known URL on an accepted Kwai host. It returns normalized post identity, text, author, media, hashtags, mentions, timestamps, and visible engagement fields.

Submit a non-empty URL whose parsed hostname is kwai.com, kwai-video.com, or one of their subdomains. A scheme is needed for hostname parsing.

No path pattern is enforced by the current runtime validator. Use an actual public post URL because a different resource path can pass hostname validation yet produce no post record.

A record can include post identity, URL, text, publication and collection times, author details, media, hashtags, mentions, and visible like, comment, share, and view counts. Optional public fields can be null.

No results_limit is accepted, and one provider request can save at most one post. The shared task-results route still exposes limit, next_cursor, and has_more, but this detail result should normally fit on its first page.

Each successful Kwai Post API task costs a fixed 0.19 SocQ credits. The estimate does not change with result count, and a successful task that resolves no record still uses the fixed task charge.