User Posts

GET/v1/kwai/user/posts1 credit

Returns a page of a Kwai user's posts, each with caption, cover and video URLs, duration, view, like, comment and share counts, music, tags and author.

01Query parameters

Name	Type	Description
handleoptional	string	Kwai username, e.g. `KwaiBrasilOficial` (a leading `@` is ignored). One of `handle` or `url` is required.
urloptional	string	Kwai profile URL, e.g. `https://www.kwai.com/@KwaiBrasilOficial`. One of `handle` or `url` is required.
countoptional	integer	Posts per page, from 1 to 50.Default: `20`
cursoroptional	string	The `cursor` value of the previous answer, to get the next page.

02Request

curl "https://api.scrapesocial.ai/v1/kwai/user/posts?handle=KwaiBrasilOficial" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/kwai/user/posts?handle=KwaiBrasilOficial

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "posts": [
    {
      "id": "5197585554602857267",
      "photo_id": 5197585554602857000,
      "url": "https://www.kwai.com/@KwaiBrasilOficial/photo/5197585554602857267",
      "caption": "TODO MUNDO TEM UM AMIGO ASSIM! 🤠😂 Do marombeiro até o sem filtro. Esse elenco de a Fazenda entrega MUITO. Qual peão te representou? #AFazendaNoKwai",
      "cover_caption": "TODO MUNDO TEM UM AMIGO ASSIM! 🤠😂 Do marombeiro até o sem filtro. Esse elenco de a Fazenda entrega MUITO. Qual peão te representou?",
      "created_at": "2026-10-25T17:00:00.018Z",
      "created_at_text": "2026-10-25 17:00:00",
      "video_url": "https://ak-eg-cdn.kwai.net/upic/2026/10/24/03/BMjAyNjEwMjQwMzI5NDBfNTU4ODQzMDkzXzE1MDExMTU3MDg0OTA3MV8zXzM=_b_Bb4ac892c95ee69201978af0e95691136.mp4?tag=1-1792948378-s-0-aaprsro1ab-9681094e4b1ce5e7",
      "video_urls": [
        {
          "cdn": "ak-eg-cdn.kwai.net",
          "url": "https://ak-eg-cdn.kwai.net/upic/2026/10/24/03/BMjAyNjEwMjQwMzI5NDBfNTU4ODQzMDkzXzE1MDExMTU3MDg0OTA3MV8zXzM=_b_Bb4ac892c95ee69201978af0e95691136.mp4?tag=1-1792948378-s-0-aaprsro1ab-9681094e4b1ce5e7"
        },
        {
          "cdn": "aws-eg-cdn.kwai.net",
          "url": "https://aws-eg-cdn.kwai.net/upic/2026/10/24/03/BMjAyNjEwMjQwMzI5NDBfNTU4ODQzMDkzXzE1MDExMTU3MDg0OTA3MV8zXzM=_b_Bb4ac892c95ee69201978af0e95691136.mp4?tag=1-1792948378-s-1-iz7oevp4gm-01109b6f23ba423c"
        }
      ],
      "cover_url": "https://p16-kimg.kwai.net/kimg/EKzM1y8qkAEKAnMzEg1waG90by1vdmVyc2VhGnt1cGljLzIwMjYvMTAvMjQvMDMvQk1qQXlOakV3TWpRd016STVOREJmTlRVNE9EUXpNRGt6WHpFMU1ERXhNVFUzTURnME9UQTNNVjh6WHpNPV9vdXVfQjFhYTNhYTVmMWZlNDgwOThjYThiM2I3ZDM4ZjdjYzg3LndlYnA.webp",
      "cover_urls": [
        {
          "cdn": "p16-kimg.kwai.net",
          "url": "https://p16-kimg.kwai.net/kimg/EKzM1y8qkAEKAnMzEg1waG90by1vdmVyc2VhGnt1cGljLzIwMjYvMTAvMjQvMDMvQk1qQXlOakV3TWpRd016STVOREJmTlRVNE9EUXpNRGt6WHpFMU1ERXhNVFUzTURnME9UQTNNVjh6WHpNPV9vdXVfQjFhYTNhYTVmMWZlNDgwOThjYThiM2I3ZDM4ZjdjYzg3LndlYnA.webp"
        },
        {
          "cdn": "p15-kimg.kwai.net",
          "url": "https://p15-kimg.kwai.net/kimg/EKzM1y8qkAEKAnMzEg1waG90by1vdmVyc2VhGnt1cGljLzIwMjYvMTAvMjQvMDMvQk1qQXlOakV3TWpRd016STVOREJmTlRVNE9EUXpNRGt6WHpFMU1ERXhNVFUzTURnME9UQTNNVjh6WHpNPV9vdXVfQjFhYTNhYTVmMWZlNDgwOThjYThiM2I3ZDM4ZjdjYzg3LndlYnA.webp"
        }
      ],
      "duration": 45.206,
      "view_count": 77,
      "like_count": 1,
      "comment_count": 1,
      "forward_count": 0,
      "favorite_count": 0,
      "allow_download": true,
      "author": {
        "id": 558843093,
        "handle": "KwaiBrasilOficial",
        "username": "Kwai Brasil Oficial",
        "bio": "Votações abertas pro #PrêmioKwai2026!\nVote no seu criador favorito! 🏆",
        "avatar_url": "https://ak-eg-pic.kwai.net/bs2/overseaHead/20261008020943_BNTU4ODQzMDkz_tw.webp",
        "avatar_urls": [
          {
            "cdn": "ak-eg-pic.kwai.net",
            "url": "https://ak-eg-pic.kwai.net/bs2/overseaHead/20261008020943_BNTU4ODQzMDkz_tw.webp"
          },
          {
            "cdn": "ak-eg-pic.kwai.net",
            "url": "https://ak-eg-pic.kwai.net/bs2/overseaHead/20261008020943_BNTU4ODQzMDkz_tw.webp"
          }
        ],
        "verified": true,
        "verified_description": "Conta Oficial"
      },
      "music": {
        "id": 13748034192,
        "name": null,
        "artist": "Kwai Brasil Oficial",
        "url": "https://ak-eg-pic.kwai.net/bs2/ost/MTUwMTExNTcwODQ5MDcxXzU1ODg0MzA5Mw.m4a",
        "duration": 45,
        "avatar_url": "https://ak-eg-pic.kwai.net/bs2/overseaHead/20261008020943_BNTU4ODQzMDkz_tw.webp",
        "photo_count": 0
      },
      "tags": []
    },
    {
      "id": "5242903026697583932",
      "photo_id": 5242903026697584000,
      "url": "https://www.kwai.com/@KwaiBrasilOficial/photo/5242903026697583932",
      "caption": "O #Halloween TÁ ON NO APP! 🎃🔥 De transformações incríveis e sustos de arrepiar até as deliciosas #ReceitasLaranjas. Quer faturar prêmios em dinheiro? Grave o seu vídeo com as hashtags oficiais e participe do desafio até dia 02/11! ✨ #TaNoKwai",
      "cover_caption": "O TÁ ON NO APP! 🎃🔥 De transformações incríveis e sustos de arrepiar até as deliciosas . Quer faturar prêmios em dinheiro? Grave o seu vídeo com as hashtags oficiais e participe do desafio até dia 02/11! ✨",
      "created_at": "2026-10-24T19:00:00.020Z",
      "created_at_text": "2026-10-24 19:00:00",
      "video_url": "https://ak-eg-cdn.kwai.net/upic/2026/10/24/02/BMjAyNjEwMjQwMjQ1MjRfNTU4ODQzMDkzXzE1MDExMTU3MDcwMDc2Nl8zXzM=_b_B25c5dddfde0e2937ff70f1b07e7774da.mp4?tag=1-1792948378-s-0-pkygsl5ygt-8b1c6870f9f9680f",
      "video_urls": [
        {
          "cdn": "ak-eg-cdn.kwai.net",
          "url": "https://ak-eg-cdn.kwai.net/upic/2026/10/24/02/BMjAyNjEwMjQwMjQ1MjRfNTU4ODQzMDkzXzE1MDExMTU3MDcwMDc2Nl8zXzM=_b_B25c5dddfde0e2937ff70f1b07e7774da.mp4?tag=1-1792948378-s-0-pkygsl5ygt-8b1c6870f9f9680f"
        },
        {
          "cdn": "aws-eg-cdn.kwai.net",
          "url": "https://aws-eg-cdn.kwai.net/upic/2026/10/24/02/BMjAyNjEwMjQwMjQ1MjRfNTU4ODQzMDkzXzE1MDExMTU3MDcwMDc2Nl8zXzM=_b_B25c5dddfde0e2937ff70f1b07e7774da.mp4?tag=1-1792948378-s-1-y9rtyjrjyo-3cd859fb2a4c5cfd"
        }
      ],
      "cover_url": "https://p15-kimg.kwai.net/kimg/EKzM1y8qkAEKAnMzEg1waG90by1vdmVyc2VhGnt1cGljLzIwMjYvMTAvMjQvMDIvQk1qQXlOakV3TWpRd01qUTFNalJmTlRVNE9EUXpNRGt6WHpFMU1ERXhNVFUzTURjd01EYzJObDh6WHpNPV9vdXVfQjNkZjRjZGYyMzBjNzQzNTBkNzczYWI0YWRmYTI0MjVmLndlYnA.webp",
      "cover_urls": [
        {
          "cdn": "p15-kimg.kwai.net",
          "url": "https://p15-kimg.kwai.net/kimg/EKzM1y8qkAEKAnMzEg1waG90by1vdmVyc2VhGnt1cGljLzIwMjYvMTAvMjQvMDIvQk1qQXlOakV3TWpRd01qUTFNalJmTlRVNE9EUXpNRGt6WHpFMU1ERXhNVFUzTURjd01EYzJObDh6WHpNPV9vdXVfQjNkZjRjZGYyMzBjNzQzNTBkNzczYWI0YWRmYTI0MjVmLndlYnA.webp"
        },
        {
          "cdn": "p16-kimg.kwai.net",
          "url": "https://p16-kimg.kwai.net/kimg/EKzM1y8qkAEKAnMzEg1waG90by1vdmVyc2VhGnt1cGljLzIwMjYvMTAvMjQvMDIvQk1qQXlOakV3TWpRd01qUTFNalJmTlRVNE9EUXpNRGt6WHpFMU1ERXhNVFUzTURjd01EYzJObDh6WHpNPV9vdXVfQjNkZjRjZGYyMzBjNzQzNTBkNzczYWI0YWRmYTI0MjVmLndlYnA.webp"
        }
      ],
      "duration": 59.968,
      "view_count": 1038,
      "like_count": 107,
      "comment_count": 28,
      "forward_count": 20,
      "favorite_count": 0,
      "allow_download": true,
      "author": {
        "id": 558843093,
        "handle": "KwaiBrasilOficial",
        "username": "Kwai Brasil Oficial",
        "bio": "Votações abertas pro #PrêmioKwai2026!\nVote no seu criador favorito! 🏆",
        "avatar_url": "https://ak-eg-pic.kwai.net/bs2/overseaHead/20261008020943_BNTU4ODQzMDkz_tw.webp",
        "avatar_urls": [
          {
            "cdn": "ak-eg-pic.kwai.net",
            "url": "https://ak-eg-pic.kwai.net/bs2/overseaHead/20261008020943_BNTU4ODQzMDkz_tw.webp"
          },
          {
            "cdn": "ak-eg-pic.kwai.net",
            "url": "https://ak-eg-pic.kwai.net/bs2/overseaHead/20261008020943_BNTU4ODQzMDkz_tw.webp"
          }
        ],
        "verified": true,
        "verified_description": "Conta Oficial"
      },
      "music": {
        "id": 13745270459,
        "name": null,
        "artist": "Kwai Brasil Oficial",
        "url": "https://ak-eg-pic.kwai.net/bs2/ost/MTUwMTExNTcwNzAwNzY2XzU1ODg0MzA5Mw.m4a",
        "duration": 59,
        "avatar_url": "https://ak-eg-pic.kwai.net/bs2/overseaHead/20261008020943_BNTU4ODQzMDkz_tw.webp",
        "photo_count": 0
      },
      "tags": [
        {
          "tagId": 36070,
          "tag": "Halloween",
          "rich": true,
          "photoCount": 0,
          "highlight": false,
          "fullMatch": false,
          "tagType": 0,
          "startTime": 0,
          "endTime": 0
        }
      ]
    }
  ],
  "albums": [
    {
      "id": "167212497917445739",
      "author_id": 558843093,
      "author_name": "Kwai Brasil Oficial",
      "count": 2,
      "view_count": 20677,
      "first_photo_caption": "A lista oficial dos indicados ao #PrêmioKwai2026 tá no ar e essa disputa promete! Quem acompanhou a evolução desses criadores e quer ver o seu favorito no tapete laranja? 🧡 Marca a galera que não perde um vídeo e chame a torcida nos comentários! #PrêmioKwai2026",
      "first_photo_cover_url": "http://ak-eg-pic.kwai.net/upic/2026/10/10/02/BMjAyNjEwMTAwMjQyNTBfNTU4ODQzMDkzXzE1MDExMTUwMzQ1NjkxMF8zXzM=_ouu_B8d837ea8153e8226b745f975e5d2e3b7.webp?tag=1-1792948378-ALBUM-0-dk2u9dy3zq-37959f118f32ef57",
      "first_photo_cover_urls": [
        {
          "cdn": "ak-eg-pic.kwai.net",
          "url": "http://ak-eg-pic.kwai.net/upic/2026/10/10/02/BMjAyNjEwMTAwMjQyNTBfNTU4ODQzMDkzXzE1MDExMTUwMzQ1NjkxMF8zXzM=_ouu_B8d837ea8153e8226b745f975e5d2e3b7.webp?tag=1-1792948378-ALBUM-0-dk2u9dy3zq-37959f118f32ef57"
        },
        {
          "cdn": "ak-eg-pic.kwai.net",
          "url": "http://ak-eg-pic.kwai.net/upic/2026/10/10/02/BMjAyNjEwMTAwMjQyNTBfNTU4ODQzMDkzXzE1MDExMTUwMzQ1NjkxMF8zXzM=_ouu_B8d837ea8153e8226b745f975e5d2e3b7.webp?tag=1-1792948378-ALBUM-1-gykh306a9h-3acae2c0632fabfa"
        }
      ]
    },
    {
      "id": "167212497917445097",
      "author_id": 558843093,
      "author_name": "Kwai Brasil Oficial",
      "count": 2,
      "view_count": 14551,
      "first_photo_caption": "INDICADOS DA CATEGORIA TÁ NA VIBE! ✨ Chegou a hora de conhecer quem dominou os vlogs e a rotina em 2026! Acompanhar o dia a dia dessa galera trouxe leveza, boas risadas e muita inspiração. 🧡 Para quem vai a sua torcida? 🔥 #PrêmioKwai2026",
      "first_photo_cover_url": "http://ak-eg-pic.kwai.net/upic/2026/10/10/04/BMjAyNjEwMTAwNDA5MTVfNTU4ODQzMDkzXzE1MDExMTUwMzczNjk0NV8zXzM=_ouu_B8bd9b1718c03c735a96549dbdb20928f.webp?tag=1-1792948378-ALBUM-0-bjdqxslstq-473e3a366c687d49",
      "first_photo_cover_urls": [
        {
          "cdn": "ak-eg-pic.kwai.net",
          "url": "http://ak-eg-pic.kwai.net/upic/2026/10/10/04/BMjAyNjEwMTAwNDA5MTVfNTU4ODQzMDkzXzE1MDExMTUwMzczNjk0NV8zXzM=_ouu_B8bd9b1718c03c735a96549dbdb20928f.webp?tag=1-1792948378-ALBUM-0-bjdqxslstq-473e3a366c687d49"
        },
        {
          "cdn": "ak-eg-pic.kwai.net",
          "url": "http://ak-eg-pic.kwai.net/upic/2026/10/10/04/BMjAyNjEwMTAwNDA5MTVfNTU4ODQzMDkzXzE1MDExMTUwMzczNjk0NV8zXzM=_ouu_B8bd9b1718c03c735a96549dbdb20928f.webp?tag=1-1792948378-ALBUM-1-gvolqv5oip-62ba696cb1607b61"
        }
      ]
    }
  ],
  "cursor": "1791651600011",
  "has_more": true
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Posts are in `posts`; `albums` holds the user's albums when they have any, else `[]`. Pass `cursor` back for the next page; after the last page `cursor` is null and `has_more` false. An account without posts is a 200 with an empty `posts` list for 0 credits. `created_at` and `created_at_text` are UTC. An unknown profile is a free 404, a private one a free 403; a value that is neither a username nor a kwai.com profile URL is a free 400.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.