{"uid":"cap_0x0MNX3VZQJyr7rLMUyMG","slug":"palmyr-social-tiktok-engagement-history-53ca46b8","name":"Palmyr Social – TikTok Engagement History","description":"Read stored per-post engagement history for a TikTok account you own (time series, latest, or growth).","url":"https://palmyr.ai/social/tiktok/series","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"properties":{"queryParams":{"type":"object","additionalProperties":true}}},"output":{"properties":{"example":{"type":"object","additionalProperties":true}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nd0wNaRDjRh8SQo2dobPX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves stored per-post engagement history for a TikTok account you own, supporting time series, latest snapshot, or growth queries.","exampleAgentPrompt":"Pull the engagement history time series for my TikTok account — I want to see how likes, views, and comments have trended across my posts over the past 30 days.","exampleUseCases":[{"title":"Weekly TikTok performance review","prompt":"Show me the engagement time series for my TikTok account over the last 7 days — I want to see how each post has been doing in terms of likes, views, and comments."},{"title":"Tracking viral post growth","prompt":"Fetch the growth data for my TikTok posts this month — I'm trying to figure out which ones picked up momentum and how fast they grew after being published."},{"title":"Latest snapshot for reporting","prompt":"Get me the latest engagement snapshot for each of my TikTok posts so I can put together a performance report for my brand deal this week."}],"resultDescription":"Returns stored engagement history for the specified TikTok account, structured as a time series, latest per-post snapshot, or growth figures — including metrics such as likes, views, comments, and shares per post over the requested period.","failureModes":["Account not registered to the wallet — returns 401 or 403 if the wallet does not own the specified TikTok account","No stored data available — if no engagement history has been collected yet, returns empty series or 404","Invalid query type — unsupported series/latest/growth parameter returns 400","Session expired or TikTok login stale — may return stale or partial data if the browser session needs re-authentication","Rate limit exceeded — too many requests in a short window may return 429"],"whenToPreferThis":"Choose this endpoint when you need historical or time-series engagement data for a TikTok account you own and have registered with Palmyr — especially when you want growth trends or per-post metric snapshots without triggering a live TikTok scrape. Prefer this over live-fetch alternatives when you need low-latency reads of already-collected data, or when building analytics dashboards that poll regularly.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:37:38.373Z","isFirstParty":false}