{"uid":"cap_RhHSoJVgC03DK5p7zPYm5","slug":"socialfetch-tiktok-video-search-cbdae74b","name":"SocialFetch TikTok Video Search","description":"Search TikTok videos by free-text keyword (not hashtag — use tiktok.search.hashtag.list for that).","url":"https://api.socialfetch.dev/v1/tiktok/search","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"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"trim":{"type":"boolean","description":"When true, returns a smaller response with fewer fields."},"query":{"type":"string","maxLength":512,"minLength":1,"description":"Search query text for TikTok videos."},"cursor":{"type":"string","minLength":1,"description":"Opaque pagination cursor returned by a previous response."},"region":{"type":"string","description":"Optional two-letter ISO 3166-1 country code for localized search results."},"sortBy":{"enum":["relevance","most-liked","date-posted"],"type":"string","description":"Optional sort order for search results."},"datePosted":{"enum":["yesterday","this-week","this-month","last-3-months","last-6-months","all-time"],"type":"string","description":"Optional upload date filter for video results."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.014","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.014/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dowJlzYD_8zTjKwAEwVdG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.014","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search TikTok videos by keyword with optional filters for region, sort order, and date posted.","exampleAgentPrompt":"Search TikTok for videos about 'sustainable fashion' in the US, sorted by most-liked, posted within the last 3 months.","exampleUseCases":[{"title":"Monitor trending dance challenges","prompt":"Find the latest TikTok videos about dance challenges from the past week, sorted by view count, so I can see which ones are going viral right now."},{"title":"Research competitor content strategy","prompt":"Search TikTok for videos from our competitors in the fitness space, sorted by engagement, and show me the most recent ones from the last month."},{"title":"Scout influencer content by region","prompt":"Look up TikTok videos about tech product reviews posted in Japan and Canada over the past two weeks, sorted by likes, so I can find potential brand partners."}],"resultDescription":"A list of TikTok video results matching the search query, including video metadata such as titles, authors, view counts, and links, plus an opaque pagination cursor for fetching the next page of results. When trim is true, a reduced set of fields is returned.","failureModes":["Missing required 'query' parameter returns a 400 error","Invalid region code returns no localized results or an error","Expired or invalid pagination cursor returns an error or empty results","Query too long (over 512 characters) is rejected","Rate limiting or quota exceeded returns a 429 or payment-related error","TikTok platform unavailability may cause upstream errors"],"whenToPreferThis":"Use this endpoint when you need to search TikTok videos by keyword with support for region filtering, date range filtering, and sort ordering. Prefer this over general web search when you specifically need TikTok video results with structured metadata and pagination support.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:01:20.797Z","isFirstParty":false}