{"uid":"cap_HYKyOee0UGocoA9LjFLu4","slug":"api-direct-tiktok-video-lookup-5c8ccd93","name":"API Direct – TikTok Video Lookup","description":"Look up a single TikTok video by URL or numeric video ID.","url":"https://x402.apidirect.io/v1/tiktok/video?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 video URL, e.g. https://www.tiktok.com/@tiktok/video/7516594811734854943 (max 500 characters). Must contain tiktok.com/. Provide exactly one of url or video_id."},"video_id":{"type":"string","maxLength":25,"description":"Numeric TikTok video ID: the number at the end of a video URL. Digits only, max 25 characters, and not all zeros. Provide exactly one of url or video_id."}}}},"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_ioEvgvMD8_oHrS7NLkR1O","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 metadata and details for a single TikTok video by its URL or numeric video ID.","exampleAgentPrompt":"Can you look up the TikTok video at https://www.tiktok.com/@charlidamelio/video/7516594811734854943 and tell me its title, creator, view count, and engagement stats?","exampleUseCases":[{"title":"Verify viral video details","prompt":"I saw this TikTok going viral — can you pull up the details for https://www.tiktok.com/@khaby.lame/video/7123456789012345678 and tell me who posted it, when it was uploaded, and how many likes and views it has?"},{"title":"Monitor competitor content performance","prompt":"Fetch the metadata for TikTok video ID 7098765432109876543 — I want to see the view count, share count, and description so I can track how this competitor's post is doing."},{"title":"Content research for influencer analysis","prompt":"Look up this TikTok video for me: https://www.tiktok.com/@mrbeast/video/7200000000000000001 — I need the creator's username, the video caption, and the engagement numbers for a report I'm putting together."}],"resultDescription":"Returns a structured object containing details about the requested TikTok video, including video metadata such as title/description, creator information, upload timestamp, view count, like count, share count, comment count, video duration, and other available engagement metrics.","failureModes":["Invalid or non-TikTok URL returns a validation error","Video not found (deleted or private) returns a 404-style error","Providing both url and video_id simultaneously may cause an error — only one should be provided","video_id containing non-digit characters or all zeros is rejected","URL exceeding 500 characters is rejected","Rate limiting or payment failure may return a 402 error"],"whenToPreferThis":"Use this endpoint when you need detailed metadata for a specific, known TikTok video and already have the URL or numeric video ID. It is ideal for single-video lookups, content verification, engagement analysis, or enriching a dataset with video-level details. Prefer this over search-based endpoints when the exact video is already identified.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:06:30.446Z","isFirstParty":false,"canonicalSlug":"api-direct-tiktok-video-lookup-5c8ccd93"}