{"uid":"cap_oREIn-brgitra86LXXX4V","slug":"api-direct-tiktok-hashtag-videos-88ad11fc","name":"API Direct – TikTok Hashtag Videos","description":"Get the videos under a hashtag by name, numeric hashtag ID, or hashtag URL.","url":"https://x402.apidirect.io/v1/tiktok/hashtag/videos?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 hashtag URL, e.g. https://www.tiktok.com/tag/cooking (max 500 characters). Provide exactly one of name, hashtag_id, or url."},"name":{"type":"string","maxLength":100,"description":"Hashtag name, with or without leading # (max 100 characters). Provide exactly one of name, hashtag_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 20 videos."},"hashtag_id":{"type":"string","description":"Numeric hashtag ID, as returned by Search Hashtags. Provide exactly one of name, hashtag_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_UEAxoyZX7cwqTJATwFQUm","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":"Fetches videos posted under a TikTok hashtag, identified by name, numeric ID, or URL, with optional AI sentiment/emotion analysis per video.","exampleAgentPrompt":"Pull the first 3 pages of TikTok videos under the hashtag #cooking and include AI sentiment analysis for each video so I can see the dominant emotions.","exampleUseCases":[{"title":"Trending hashtag content monitoring","prompt":"Fetch the latest TikTok videos under #climatechange — grab 5 pages worth so I can see what content is trending under that tag right now."},{"title":"Brand sentiment analysis on TikTok","prompt":"Get TikTok videos posted under #Nike and turn on the sentiment analysis so I can see whether people are feeling positive, negative, or neutral about the brand in their videos."},{"title":"Competitor hashtag research","prompt":"I need to see what videos are being shared under the TikTok hashtag #veganrecipes — pull 2 pages and include the emotion breakdown for each video."}],"resultDescription":"Returns a paginated list of TikTok videos under the specified hashtag (up to 20 per page), including video metadata such as title, author, view counts, and engagement. When sentiment analysis is enabled, each video also includes an emotions object (joy, trust, fear, surprise, sadness, disgust, anger, anticipation scored 0-100), dominant emotion, emotional intensity (0-10), and polarity (positive, negative, or neutral).","failureModes":["Invalid or non-existent hashtag name returns empty results or 404","Providing more than one of name/hashtag_id/url simultaneously causes a validation error","Pages value outside 1-1000 range triggers a parameter validation error","Private or restricted hashtags may return no videos","Rate limiting or payment failure results in 402 or 429 error"],"whenToPreferThis":"Use this endpoint when you need to retrieve actual video content (not just hashtag metadata) from TikTok for a known hashtag, especially when you want paginated results or AI-powered emotional sentiment scoring per video. Prefer this over a hashtag search endpoint when you already know the hashtag identifier. Choose it when you need bulk video data (up to 1000 pages × 20 videos) rather than a single hashtag's stats.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:08:27.341Z","isFirstParty":false,"canonicalSlug":"api-direct-tiktok-hashtag-videos-88ad11fc"}