> ## Documentation Index > Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt > Use this file to discover all available pages before exploring further. # Post > Returns a public Kwai post by link: caption and hashtags, post time, views, likes, comments and shares, length and size, the MP4, cover and thumbnail, Kwai's category and genres, the sound, Kwai's transcript of the video (speech-to-text, when it has one), the AI-generated flag and the author (name, Kwai ID, ids, avatar, verified badge). Only publicly available data is returned. > [!NOTE] > > **Cost: 1 credit** per successful request. Errors and cache hits (`cache_max_age`) are free. > [accordion] Copy for AI assistant > > Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button). > > ```text Prompt > I want to make an API call to /v1/kwai/post. Here are the details: > > Endpoint: GET https://api.scraperize.com/v1/kwai/post > Description: Returns a public Kwai post by link: caption and hashtags, post time, views, likes, comments and shares, length and size, the MP4, cover and thumbnail, Kwai's category and genres, the sound, Kwai's transcript of the video (speech-to-text, when it has one), the AI-generated flag and the author (name, Kwai ID, ids, avatar, verified badge). Only publicly available data is returned. > > Required Headers: > - x-api-key: Your API key > > Parameters: > - url (string) [required]: The post's link: `https://www.kwai.com/@/video/` or `…/photo/`. > - cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. > > Example Response: > { > "data": { > "id": "5192237529965856725", > "url": "https://www.kwai.com/@brunosantosnut/video/5192237529965856725", > "caption": "#nutricaoesportiva", > "hashtags": [ > "nutricaoesportiva" > ], > "createdAt": "2026-10-20T16:43:33.916Z", > "views": 274, > "likes": 17, > "comments": 2, > "shares": 4, > "durationMs": 67567, > "width": 576, > "height": 1024, > "videoUrl": "https://aws-br-cdn.kwai.net/upic/2026/10/21/00/BMjAyNjEwMjEwMDQzMzNfMTUwMDAxNDcxMzg1OTQ5XzE1MDExMTU1NTc1NDU4Nl8wXzM=_b_B93257e31741f74f5a71d05b16ae3b689.mp4?tag…", > "coverUrl": "https://aws-br-pic.kwai.net/upic/2026/10/21/00/BMjAyNjEwMjEwMDQzMzNfMTUwMDAxNDcxMzg1OTQ5XzE1MDExMTU1NTc1NDU4Nl8wXzM=_offn_B5e1f1275e7940478abf7dec359a5b99a.webp…", > "thumbnailUrl": "https://aws-br-pic.kwai.net/upic/2026/10/21/00/BMjAyNjEwMjEwMDQzMzNfMTUwMDAxNDcxMzg1OTQ5XzE1MDExMTU1NTc1NDU4Nl8wXzM=_oscn2_Bcc9f9cea1fa7aafcbd4a39f9f822efe5.web…", > "category": "Education", > "isPinned": null, > "hasOriginalSound": null, > "soundAuthor": "brunosantosnutri", > "music": null, > "album": null, > "allowsDownload": null, > "isAiGenerated": false, > "author": { > "userId": null, > "eid": "3xsk27vr9mi2waw", > "kwaiId": "brunosantosnut", > "name": "brunosantosnutri", > "avatarUrl": "https://aws-br-pic.kwai.net/bs2/overseaHead/20230417031941_BMTUwMDAxNDcxMzg1OTQ5_t.jpg", > "isVerified": false > }, > "transcript": "Quando você tem shape, até a roupa mais barata fica bonita. Quando você tem shape, até a roupa mais barata fica bonita", > "genres": [ > "Education" > ], > "soundName": "Áudio original criado por brunosantosnutri", > "fetchedAt": "2026-11-11T09:06:19.966Z" > }, > "meta": { > "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f", > "creditsCharged": 1, > "creditsRemaining": 4999, > "cached": false > } > } > > Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices. > ``` ## OpenAPI ````yaml /api-reference/openapi.json get /v1/kwai/post openapi: 3.0.3 info: title: Scraperize API version: 1.0.0 description: >- Extract public data from social media platforms as clean JSON. Endpoints are split by platform and by what they return, e.g. `GET /v1/twitter/tweet`. ## Authentication Send your API key in the `x-api-key` header (or `Authorization: Bearer `). Create keys in your dashboard. ## Credits Each successful live scrape costs **1 credit**. Credits are prepaid and never expire. ## Caching Every endpoint accepts an optional `cache_max_age` (`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for **0 credits**. ## Responses Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return `{ "error": { "code", "message", "requestId" } }` with a matching HTTP status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`, `cached`, and (on a hit) `cachedAt`. ## Rate limits Requests are limited per team per minute; over the limit returns `429` with a `Retry-After` header. servers: - url: https://api.scraperize.com description: Production security: - ApiKeyAuth: [] tags: - name: Twitter description: Twitter / X scraping endpoints - name: Facebook description: Facebook scraping endpoints - name: Linkme description: Linkme (link.me) scraping endpoints - name: Amazon description: Amazon (creator shop / storefront) scraping endpoints - name: Linkbio description: Linkbio (lnk.bio) scraping endpoints - name: Pillar description: Pillar (pillar.io) scraping endpoints - name: Komi description: Komi (komi.io) scraping endpoints - name: Linktree description: Linktree (linktr.ee) scraping endpoints - name: Kick description: Kick (kick.com) scraping endpoints - name: Snapchat description: Snapchat (snapchat.com) scraping endpoints - name: Telegram description: Telegram (t.me) scraping endpoints - name: LinkedIn description: LinkedIn scraping endpoints - name: Twitch description: Twitch scraping endpoints - name: TikTok description: TikTok (tiktok.com) scraping endpoints - name: Instagram description: Instagram scraping endpoints - name: Lagos Life description: Lagos Life scraping endpoints - name: Bluesky description: Bluesky (bsky.app) scraping endpoints - name: Threads description: Threads (threads.com) scraping endpoints - name: Reddit description: Reddit (reddit.com) scraping endpoints - name: Rumble description: Rumble (rumble.com) scraping endpoints - name: SoundCloud description: SoundCloud (soundcloud.com) scraping endpoints - name: Kwai description: Kwai (kwai.com) scraping endpoints - name: Apple Music description: Apple Music (music.apple.com) scraping endpoints - name: Truth Social description: Truth Social (truthsocial.com) scraping endpoints - name: YouTube description: YouTube (youtube.com) scraping endpoints paths: /v1/kwai/post: get: tags: - Kwai summary: Post description: >- Returns a public Kwai post by link: caption and hashtags, post time, views, likes, comments and shares, length and size, the MP4, cover and thumbnail, Kwai's category and genres, the sound, Kwai's transcript of the video (speech-to-text, when it has one), the AI-generated flag and the author (name, Kwai ID, ids, avatar, verified badge). Only publicly available data is returned. parameters: - name: url in: query required: true description: >- The post's link: `https://www.kwai.com/@/video/` or `…/photo/`. schema: type: string example: https://www.kwai.com/@brunosantosnut/video/5192237529965856725 - name: cache_max_age in: query required: false description: >- Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. schema: type: string enum: - 1d - 3d - 7d - 14d - 30d example: 7d responses: '200': description: The post. content: application/json: schema: type: object properties: data: type: object meta: type: object description: >- requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt). required: - data - meta example: data: id: '5192237529965856725' url: >- https://www.kwai.com/@brunosantosnut/video/5192237529965856725 caption: '#nutricaoesportiva' hashtags: - nutricaoesportiva createdAt: '2026-10-20T16:43:33.916Z' views: 274 likes: 17 comments: 2 shares: 4 durationMs: 67567 width: 576 height: 1024 videoUrl: >- https://aws-br-cdn.kwai.net/upic/2026/10/21/00/BMjAyNjEwMjEwMDQzMzNfMTUwMDAxNDcxMzg1OTQ5XzE1MDExMTU1NTc1NDU4Nl8wXzM=_b_B93257e31741f74f5a71d05b16ae3b689.mp4?tag=1-1794387980-s-0-tby7hjs8vv-2bb814a035aa20e8 coverUrl: >- https://aws-br-pic.kwai.net/upic/2026/10/21/00/BMjAyNjEwMjEwMDQzMzNfMTUwMDAxNDcxMzg1OTQ5XzE1MDExMTU1NTc1NDU4Nl8wXzM=_offn_B5e1f1275e7940478abf7dec359a5b99a.webp?tag=1-1794387980-s-0-ftbfrsp44k-368bf7de10728a58 thumbnailUrl: >- https://aws-br-pic.kwai.net/upic/2026/10/21/00/BMjAyNjEwMjEwMDQzMzNfMTUwMDAxNDcxMzg1OTQ5XzE1MDExMTU1NTc1NDU4Nl8wXzM=_oscn2_Bcc9f9cea1fa7aafcbd4a39f9f822efe5.webp category: Education isPinned: null hasOriginalSound: null soundAuthor: brunosantosnutri music: null album: null allowsDownload: null isAiGenerated: false author: userId: null eid: 3xsk27vr9mi2waw kwaiId: brunosantosnut name: brunosantosnutri avatarUrl: >- https://aws-br-pic.kwai.net/bs2/overseaHead/20230417031941_BMTUwMDAxNDcxMzg1OTQ5_t.jpg isVerified: false transcript: >- Quando você tem shape, até a roupa mais barata fica bonita. Quando você tem shape, até a roupa mais barata fica bonita genres: - Education soundName: Áudio original criado por brunosantosnutri fetchedAt: '2026-11-11T09:06:19.966Z' meta: requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f creditsCharged: 1 creditsRemaining: 4999 cached: false '401': description: Missing, invalid, or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: API key required — pass it in the `x-api-key` header. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '402': description: Not enough credits for this request. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INSUFFICIENT_CREDITS message: >- This request costs 1 credit, but your balance is 0. Top up to continue. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '404': description: No such post (it may not exist, be private or have been removed). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: NOT_FOUND message: >- The requested content was not found (it may not exist, be deleted, or be private). requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '422': description: Invalid query parameters (`url` must be a Kwai post URL). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: VALIDATION_ERROR message: Request validation failed requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: - path: url message: url is required '429': description: Over the per-minute rate limit — honour `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RATE_LIMITED message: >- Rate limit exceeded — max 100 requests per 60s. Retry in ~30s. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '503': description: >- Temporarily unavailable — retry after `Retry-After`. `error.code` tells you why: `UPSTREAM_BLOCKED` (the source blocked this request), `EXTRACTION_FAILED` (the source returned unexpected data), `PLATFORM_UNAVAILABLE` (the source is down), or `SERVICE_UNAVAILABLE` (we are at capacity). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UPSTREAM_BLOCKED message: >- The source is temporarily unavailable. Please try again shortly. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f components: schemas: Error: type: object properties: error: type: object properties: code: type: string example: NOT_FOUND message: type: string example: The requested content was not found. requestId: type: string example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: type: array items: type: object description: Present on validation errors. required: - code - message - requestId required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your API key. Send it in the `x-api-key` header (or `Authorization: Bearer `). Create and manage keys from your dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.