API Documentation

TikTok Feed API

Query public TikTok data synchronously; empty results and failures are free.

Test API

Results return directly in the same request; no task submission or polling is needed.

Open product page and API Tester

Endpoint and authentication

GET https://api.goanyapi.com/api/v1/tiktok/feed

Authenticate with Authorization: Bearer YOUR_API_KEY. Supply query-string parameters; there is no request body.

Input parameters

ParameterTypeLocationRequiredConstraints / defaultDescription
AuthorizationstringHeaderYesBearer YOUR_API_KEYAPI key for the current account
cursorstringQueryNoDefault: 0Collection cursor. Use nextCursor only when returned; never infer an offset.
countintegerQueryNoDefault: 20; Fixed: 20Fixed page size 20; actual returned records may be fewer.

Request example

GET /api/v1/tiktok/feed?cursor=0&count=20
Authorization: Bearer YOUR_API_KEY

Output parameters

Success returns HTTP 200. Null, empty and missing business fields are preserved; a zero statistic is valid. Only documented public fields are returned.

FieldTypeDescription
codestringok on success
messagestringRequest message
data.creditsUsednumberCredits charged for this request; zero for empty results
data.remainingCreditsnumberAccount balance after settlement
data.itemsarrayPosts on this page; [] for empty results
data.hasMorebooleanWhether more records are reported; does not guarantee a cursor
data.nextCursorstring | nullReturned next cursor, or null when unavailable; never invent a cursor even when hasMore=true
data.pageSizeintegerFixed requested maximum 20
data.items[].idstringPost ID
data.items[].descstringPost description
data.items[].createTimenumberUnix timestamp in seconds
data.items[].isAdbooleanAdvertisement indicator
data.items[].authorobjectAuthor information
data.items[].statsobjectEngagement statistics
data.items[].statsV2objectString statistics
data.items[].videoobjectVideo media information
data.items[].author.idstring | number | boolean | nullReturned public author field; may be absent or empty
data.items[].author.uniqueIdstring | number | boolean | nullReturned public author field; may be absent or empty
data.items[].author.nicknamestring | number | boolean | nullReturned public author field; may be absent or empty
data.items[].author.signaturestring | number | boolean | nullReturned public author field; may be absent or empty
data.items[].author.secUidstring | number | boolean | nullReturned public author field; may be absent or empty
data.items[].author.avatarThumbstring | number | boolean | nullReturned public author field; may be absent or empty
data.items[].author.avatarMediumstring | number | boolean | nullReturned public author field; may be absent or empty
data.items[].author.avatarLargerstring | number | boolean | nullReturned public author field; may be absent or empty
data.items[].author.verifiedstring | number | boolean | nullReturned public author field; may be absent or empty
data.items[].author.privateAccountstring | number | boolean | nullReturned public author field; may be absent or empty
data.items[].author.createTimestring | number | boolean | nullReturned public author field; may be absent or empty
data.items[].video.idstring | number | nullReturned public media field; may be absent or empty
data.items[].video.descstring | number | nullReturned public media field; may be absent or empty
data.items[].video.createTimestring | number | nullReturned public media field; may be absent or empty
data.items[].video.durationstring | number | nullReturned public media field; may be absent or empty
data.items[].video.widthstring | number | nullReturned public media field; may be absent or empty
data.items[].video.heightstring | number | nullReturned public media field; may be absent or empty
data.items[].video.ratiostring | number | nullReturned public media field; may be absent or empty
data.items[].video.coverstring | number | nullReturned public media field; may be absent or empty
data.items[].video.originCoverstring | number | nullReturned public media field; may be absent or empty
data.items[].video.dynamicCoverstring | number | nullReturned public media field; may be absent or empty
data.items[].video.playAddrstring | number | nullReturned public media field; may be absent or empty
data.items[].video.downloadAddrstring | number | nullReturned public media field; may be absent or empty
data.items[].stats.diggCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].stats.shareCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].stats.commentCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].stats.playCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].stats.collectCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].stats.followerCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].stats.followingCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].stats.heartCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].stats.heartnumber | string | nullReturned statistic; may be absent or empty
data.items[].stats.videoCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].stats.friendCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].stats.viewCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].statsV2.diggCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].statsV2.shareCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].statsV2.commentCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].statsV2.playCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].statsV2.collectCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].statsV2.followerCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].statsV2.followingCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].statsV2.heartCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].statsV2.heartnumber | string | nullReturned statistic; may be absent or empty
data.items[].statsV2.videoCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].statsV2.friendCountnumber | string | nullReturned statistic; may be absent or empty
data.items[].statsV2.viewCountnumber | string | nullReturned statistic; may be absent or empty

Real response example

Saved from a real successful response and projected to public fields. Lists show only the first two records. Account balance and request charges are omitted; live responses also contain creditsUsed and remainingCredits based on current configuration. Displaying the example sends no query and charges no credits.

{
  "code": "ok",
  "message": "ok",
  "data": {
    "items": [
      {
        "id": "7693207580608384286",
        "desc": "Good morning #viral #fyp#dance#school#friend",
        "createTime": 1791214511,
        "isAd": false,
        "author": {
          "id": "7518625995999904823",
          "uniqueId": "wtfkebba",
          "nickname": "Kebba",
          "signature": "📍MI\n170k/200k\nSc/insta/yt: wtfkebba\nCollabs:ceesayk158@gmail.com\nCheck out @Lovershoe.To🇺🇸 shoes",
          "secUid": "MS4wLjABAAAAhiE3XKYucx7Yez2Qh6CFUeEGFjeYf4hwUySlFQ11UqLwhqsXfOBa1i62GVcl0OxV",
          "avatarThumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/811276cd4a94f67d3787411bb2d6acd8~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=f2ee4bad&x-expires=1794646800&x-signature=RRJTx5Au8IgsAgPxYOWGXCjRIIM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "avatarMedium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/811276cd4a94f67d3787411bb2d6acd8~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=73cd5ae9&x-expires=1794646800&x-signature=hMFTebVSEIjvbQyrLpmz%2BdNSyVo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "avatarLarger": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/811276cd4a94f67d3787411bb2d6acd8~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=6936eacd&x-expires=1794646800&x-signature=vXPW4Zy1cNoQ52JN5%2Fvre4vszTo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "verified": false,
          "privateAccount": false
        },
        "stats": {
          "diggCount": 2200000,
          "shareCount": 93600,
          "commentCount": 12500,
          "playCount": 16900000,
          "collectCount": 191700
        },
        "statsV2": {
          "diggCount": "2200000",
          "shareCount": "93600",
          "commentCount": "12500",
          "playCount": "16900000",
          "collectCount": "191708"
        },
        "video": {
          "id": "7693207580608384286",
          "duration": 9,
          "width": 720,
          "height": 1280,
          "ratio": "720p",
          "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ocFG6WhqwAofE3aBEtP8XRwBV6DfIHcGEvhAED~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=9RdE9ZqXdXLeIjtoCaJSpumhtkI%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "originCover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ocK5h4I8MQ22CH2MAfWCqfj1vC8bVPIQQlAeIh~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=sEA8X9cI546LYOjhyYNJ%2BAnDsmM%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "dynamicCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/owfUw8aVwBEFcuhIBIfPtPAF3vGA7qZPDERDET~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=ZqEemqQw8FNgelPDN5HWknF458I%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "playAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-pve-0068-tx2/oIfRIEGvhta3nBPD37BkELcwAQF7EqA8wfDVUE/?a=1988&bti=ODszNWYuMDE6&&bt=1099&ft=4KJMyMzm8Zmo07cjMa4jVsSWdpWrKsd.&mime_type=video_mp4&rc=OjM6aDQ4M2g4aTU8Z2Y7NkBpanFzc3A5cjl2ZTMzaTczNEA1MV8tMS02XzExYWEtMjEzYSNkc3FvMmRrMC5hLS1kMTJzcw%3D%3D&expire=1794648888&l=20261112093438EDC29B550F5E9E012EE2&ply_type=2&policy=2&signature=a711186f29d4cfd3366e0d202ff9c159&tk=tt_chain_token&btag=e000b0000"
        }
      },
      {
        "id": "7689116773324541214",
        "desc": "9月24日,华盛顿DC街头,中国人以最热烈的方式“欢迎”习近平访美。欢迎央视新闻报道。",
        "createTime": 1790262021,
        "isAd": false,
        "author": {
          "id": "7414635498722214954",
          "uniqueId": "yifeng.su.ii",
          "nickname": "YiFeng Su II",
          "signature": "欢迎投稿爆料👊\n中国不需要谁指明方向,自由民主就是方向!\n因为有共产党,作为中国人实在太丢脸,反共光荣,亲共可耻👊\n\n欢迎朋友们关注我的 X 谢谢。",
          "secUid": "MS4wLjABAAAAyPwVzO0msWnWyqPe4vb3quBeDrTpNGBM6om5E_EPwfTy5SAiJEt38s9lZRFEIr2V",
          "avatarThumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/76769c8ef2f3d91f6c4cc97ecdb6f20f~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=58c6e663&x-expires=1794646800&x-signature=W%2FKMU%2F%2FSEuzH11yYHm4poGzZoaA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "avatarMedium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/76769c8ef2f3d91f6c4cc97ecdb6f20f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=279aaa74&x-expires=1794646800&x-signature=9wKPQBTcsqPnJdE1vdbBctxBSkc%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "avatarLarger": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/76769c8ef2f3d91f6c4cc97ecdb6f20f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=92b8a921&x-expires=1794646800&x-signature=XFKuV8gR%2B0XvS2ER%2BlNZCGeL4D0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
          "verified": false,
          "privateAccount": false
        },
        "stats": {
          "diggCount": 51300,
          "shareCount": 3883,
          "commentCount": 2859,
          "playCount": 2700000,
          "collectCount": 4423
        },
        "statsV2": {
          "diggCount": "51300",
          "shareCount": "3883",
          "commentCount": "2859",
          "playCount": "2700000",
          "collectCount": "4423"
        },
        "video": {
          "id": "7689116773324541214",
          "duration": 8,
          "width": 848,
          "height": 464,
          "ratio": "480p",
          "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oUEA1qSEYCTAzAREymIACFEEsODsytAF3ffBwV~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=NLNJPRMoiu3dfMpX6N4H8pvxong%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "originCover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/owqeas1jKQwSIdGIIVnARYGsLDeDACgI1QCq8f~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=dvkj1XwePuoXRFZssMKsYRYaT40%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "dynamicCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oUEA1qSEYCTAzAREymIACFEEsODsytAF3ffBwV~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=d2QWaRz%2FDvZJKdNlSY240Tvkyrs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
          "playAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-ve-0068c001-tx2/oMwCWfp1vAuIB0BEQk7iAAAqOiWiID7B1F2MqW/?a=1988&bti=ODszNWYuMDE6&&bt=1640&ft=4KJMyMzm8Zmo07cjMa4jVsSWdpWrKsd.&mime_type=video_mp4&rc=Z2VlOWhoO2Q8Z2Y8aDc2OEBpMzhsM3U5cjNtZDMzaTczNEAwNS80MzRfNTQxLmA0MC4xYSNfcmAzMmRjam5hLS1kMTJzcw%3D%3D&expire=1794648887&l=20261112093438EDC29B550F5E9E012EE2&ply_type=2&policy=2&signature=ddd71808b8a1b7dbc065a589055904b7&tk=tt_chain_token&btag=e000b0000",
          "downloadAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-ve-0068c002-tx2/oQ17q41MAAFIpAiI7ivEB0bQBWCkAcfKt2OBiW/?a=1988&bti=ODszNWYuMDE6&&bt=1899&ft=4KJMyMzm8Zmo07cjMa4jVsSWdpWrKsd.&mime_type=video_mp4&rc=OmU8aGVlZjQ7ZTs8NmYzPEBpMzhsM3U5cjNtZDMzaTczNEBeLzYwXzEyNl4xLS0yYzQxYSNfcmAzMmRjam5hLS1kMTJzcw%3D%3D&expire=1794648887&l=20261112093438EDC29B550F5E9E012EE2&ply_type=2&policy=2&signature=814d3bf328a737b53037091e8ee7658c&tk=tt_chain_token&btag=e000b0000"
        }
      }
    ],
    "hasMore": true,
    "nextCursor": null,
    "pageSize": 20
  }
}

Pagination

Each request asks for up to 20 records. Actual counts may be smaller. Continue only when hasMore=true and nextCursor is a valid string; pass it as cursor. Never infer an offset from record counts. When hasMore=true but nextCursor=null, this response cannot supply a subsequent page. Each next page is a separate billed request; pages are not fetched automatically.

Billing

With the current configuration, each successful request costs 1 credit.

Non-empty successful results use the currently configured rate; empty results and failures are free. Sufficient balance is required before requesting. A concurrent settlement with insufficient balance also returns 402 without delivering unsettled paid results. Empty or null details and lists without meaningful records are empty; individual empty fields do not make a populated result empty.

Errors

400: invalid parameters; 401: invalid authentication; 402: insufficient credits; 429: rate limit; 502: request failed; 503: API or pricing not configured. Errors contain code and message without internal addresses or credentials.

{"code":"invalid_params","message":"Invalid parameter"}