Managed gateway · LeanPool

Feeds

For You, Following, STEM, Explore and Nearby feeds.

GETapi.tikultra.com/v1/feedStandard · 5 credits

Upstream/aweme/v1/feed//aweme/v2/follow/feed//tiktok/feed/stem/v2/tiktok/feed/explore/v1/tiktok/feed/nearby/revamp{ cursor, has_more }Every plan

Parameters

Name	Type	Description
`type`required	string	Which feed to read. e.g. foryou
`region`	string	Two-letter country code for egress and storefront. e.g. US
`city`	string	A city in that region. See the supported cities list. e.g. miami
`count`	integer	Items per page. e.g. 10
`cursor`	string	The cursor from the previous page. Omit it for the first page.

Pricing

Plan	Per call	Per 1,000 calls
Starter	5 credits	$0.58
Growth	5 credits	$0.40
Scale	5 credits	$0.29

Responses

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining. Errors return a JSON body with a stable code and cost 0 credits. Error codes

curl -G https://api.tikultra.com/v1/feed \
  -H "x-api-key: $TIKULTRA_KEY" \
  --data-urlencode "type=foryou"

{
  "cursor": "1",
  "has_more": true,
  "items": [
    {
      "aweme_id": "7705852133855161377",
      "desc": "Launch film, 1080p60 master #keyboards #desksetup",
      "create_time": 1762622512,
      "region": "US",
      "author": {
        "uid": "6970000000000000001",
        "unique_id": "acme",
        "sec_uid": "MS4wLjABAAAAq8V3xLm2pR9wQ8mN4vK1zH7tB2yX",
        "nickname": "Acme Studio",
        "follower_count": 128431,
        "verified": false
      },
      "stats": {
        "play_count": 1482906,
        "digg_count": 96442,
        "comment_count": 1318,
        "share_count": 4877,
        "collect_count": 2210,
        "repost_count": 614
      },
      "music": {
        "id": "7569924403851462401",
        "title": "original sound - acme",
        "author": "Acme Studio",
        "duration_sec": 31
      },
      "video": {
        "codec": "bytevc1",
        "width": 1080,
        "height": 1920,
        "fps": 60,
        "duration_ms": 31840,
        "bitrate_bps": 3842100,
        "play_url": "https://v16-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-pve-0068/oQ8kLmN2xR9pV/?a=1233",
        "cover_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/o8kLmN2xR9pV~tplv-tiktokx-origin.image"
      }
    }
  ]
}

Try it in the playground Full reference in the docs

More in Feeds, search & Tako AI

GET/v1/feed/persona-fypPersona For You feed10 cr GET/v1/feed/persona-fyp/citiesSupported persona citiesFree GET/v1/feed/storiesStories feed5 cr GET/v1/feed/landscapeLandscape feed5 cr GET/v1/searchSearch5 cr GET/v1/search/suggestionsSearch suggestions5 cr POST/v1/vision/ecom-searchVision search25 cr POST/v1/tako/askTako ask25 cr POST/v1/tako/chatTako chat25 cr GET/v1/tako/sugTako suggestions5 cr GET/v1/tako/conversationTako conversation10 cr GET/v1/tako/inboxTako inbox10 cr GET/v1/tako/memoryTako memory10 cr GET/v1/creator/search-insightsSearch insights25 cr GET/v1/creator/search-insights/detailSearch insight detail25 cr GET/v1/creator/search-insights/trendSearch insight trend25 cr GET/v1/creator/search-insights/videosSearch insight videos25 cr GET/v1/douyin/hotDouyin hot list10 cr GET/v1/douyin/searchDouyin hot search10 cr GET/v1/douyin/brandDouyin brand board10 cr GET/v1/douyin/musicDouyin music board10 cr

Ready to build?

Start with 2,500 free credits and test every public endpoint, then pick a plan.

Get an API key See pricing