{"uid":"cap_TtdW8OVBWesPm63gVUB6E","slug":"socialfetch-tiktok-profile-lookup-7a5c1147","name":"SocialFetch TikTok Profile Lookup","description":"Get a TikTok profile by handle.","url":"https://api.socialfetch.dev/v1/tiktok/profiles/:handle","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"},"pathParams":{"type":"object","required":["handle"],"properties":{"handle":{"type":"string","maxLength":128,"minLength":1,"description":"TikTok handle to look up, with or without a leading @."}}},"queryParams":{"type":"object","properties":{}}},"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_0VToPT3_MCoCJ-Bbtdn8I","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":"Retrieves public profile data for a TikTok account by its handle.","exampleAgentPrompt":"Can you pull up the TikTok profile for @charlidamelio and show me their bio, follower count, and account details?","exampleUseCases":null,"resultDescription":"Returns structured public profile data for the specified TikTok account, including fields such as display name, bio, follower/following counts, like counts, and other publicly available account metadata.","failureModes":["Handle not found — TikTok account does not exist or is private, returns 404 or empty result","Invalid handle format — handle exceeds 128 characters or is empty, returns validation error","TikTok rate limiting or blocking — upstream TikTok platform throttles the lookup","Payment failure — x402 payment of $0.014 USDC not processed, request rejected","Handle with special characters — may cause URL parsing issues if not properly encoded"],"whenToPreferThis":"Use this endpoint when you need to look up a single TikTok creator or account's public profile metadata by their handle. Ideal for influencer research, audience analysis, or enriching datasets with TikTok profile attributes. Prefer this over manual scraping or browser automation when you need a clean, structured profile response via a simple API call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:03:42.001Z","isFirstParty":false}