{"uid":"cap_tHMQ-B-4-WoElFGRmK4jq","slug":"tiktok-user-stories-fetcher-16a2a86c","name":"TikTok User Stories Fetcher","description":"Get a user's currently live stories (the 24-hour posts shown on their profile) by username, numeric user ID, or profile URL.","url":"https://x402.apidirect.io/v1/tiktok/user/stories?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"url":{"type":"string","maxLength":500,"description":"TikTok profile URL, e.g. https://www.tiktok.com/@tiktok (max 500 characters). Provide exactly one of username, user_id, or url."},"pages":{"type":"integer","default":1,"maximum":1000,"minimum":1,"description":"Number of pages to fetch, 1-1000 (default: 1). Each page returns up to 30 stories."},"user_id":{"type":"string","description":"Numeric TikTok user ID, as returned by Search Users or User Profile. Provide exactly one of username, user_id, or url."},"username":{"type":"string","maxLength":100,"description":"TikTok username, with or without leading @ (max 100 characters). Provide exactly one of username, user_id, or url."},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis to each item. Adds a `sentiment` object containing `emotions` (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), `dominant_emotion`, `emotional_intensity` (0-10), and `polarity` (positive, negative or neutral). Any item t"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BA7hLlXnyy9WuNQ0k-hIY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a TikTok user's currently live 24-hour stories by username, numeric user ID, or profile URL, with optional AI sentiment analysis.","exampleAgentPrompt":"Can you pull the current live stories from TikTok user @charlidamelio — grab the first 2 pages and include sentiment analysis so I can see the emotional tone of what she's posting?","exampleUseCases":[{"title":"Influencer story monitoring for brand","prompt":"Fetch the current TikTok stories for @nike and run sentiment analysis on them — I want to know the dominant emotions and whether the tone is positive or negative across their 24-hour posts."},{"title":"Competitor social media tracking","prompt":"What TikTok stories does @dunkindonuts have up right now? Grab up to 3 pages of results so I get a full picture of their current story activity."},{"title":"Creator content audit by user ID","prompt":"Get the live TikTok stories for user ID 6569595898742096902 — I have their numeric ID from a previous lookup — and include the sentiment scores so I can assess the emotional intensity of their content."}],"resultDescription":"Returns a paginated list of the user's currently active TikTok stories (up to 30 per page), including story content and metadata. When sentiment analysis is enabled, each story item includes an emotions object with scores for joy, trust, fear, surprise, sadness, disgust, anger, and anticipation (each 0–100), plus dominant_emotion, emotional_intensity (0–10), and polarity (positive, negative, or neutral).","failureModes":["User not found — invalid username, user ID, or URL returns an error or empty result","No active stories — user has no live 24-hour posts at query time, returns empty list","Private account — stories may be inaccessible if the account is private","Rate limiting — excessive calls may trigger throttling","Invalid identifier combination — providing more than one of username/user_id/url simultaneously may cause an error","Pagination out of range — requesting pages beyond available story count returns empty pages"],"whenToPreferThis":"Use this endpoint when you need to retrieve the ephemeral 24-hour story content from a specific TikTok user rather than their permanent feed posts. It's the right choice when you need real-time story snapshots for influencer monitoring, brand auditing, or competitive intelligence, and especially when you want AI-powered emotion scoring layered onto story content without building your own NLP pipeline.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:08:33.752Z","isFirstParty":false,"canonicalSlug":"tiktok-user-stories-fetcher-16a2a86c"}