Managed gateway · LeanPool

Persona For You feed

What the For You feed shows in one of 84 supported cities for a given niche, from a device context pinned to that city and calibrated to that topic.

GETapi.tikultra.com/v1/feed/persona-fypHeavy · 10 credits

Upstream/aweme/v1/feed/Exclusive{ cursor, has_more }Every plan

Parameters

Name	Type	Description
`region`required	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
`niche`required	string	The topic the context is calibrated to. e.g. fitness
`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	10 credits	$1.16
Growth	10 credits	$0.79
Scale	10 credits	$0.58

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/persona-fyp \
  -H "x-api-key: $TIKULTRA_KEY" \
  --data-urlencode "region=US" \
  --data-urlencode "niche=fitness"

{
  "region": "US",
  "city": "miami",
  "niche": "fitness",
  "cursor": "2",
  "has_more": true,
  "items": [
    {
      "aweme_id": "7705852133855161377",
      "desc": "Morning run Brickell Key 5K pace #miami #fitness",
      "author": {
        "unique_id": "miamirunclub"
      },
      "stats": {
        "play_count": 612900,
        "digg_count": 48210
      },
      "position": 1
    }
  ]
}

Try it in the playground Full reference in the docs

More in Feeds, search & Tako AI

GET/v1/feed/persona-fyp/citiesSupported persona citiesFree GET/v1/feedFeeds5 cr 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