{"uid":"cap_e7_cSeFFP2jlhFkeNW3xu","slug":"machine-market-social-fetch-post-comments-d501dcee","name":"Machine Market Social – Fetch Post Comments","description":"Fetch the first page of public comments for a post.","url":"https://machine-market-social-mainnet.machine-market.workers.dev/comments?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"],"type":"string"},"queryParams":{"type":"object","required":["platform","target"],"properties":{"target":{"type":"string","minLength":1,"description":"Public TikTok video URL"},"platform":{"enum":["tiktok","instagram"],"type":"string","description":"Social or creator-link platform adapter."},"freshness":{"enum":["live","24h","7d"],"type":"string","default":"live","description":"Maximum acceptable upstream freshness policy."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["success","provider","platform","type","freshness","data"],"properties":{"data":{"type":"object","additionalProperties":true},"type":{"type":"string","const":"comments"},"success":{"type":"boolean","const":true},"platform":{"type":"string"},"provider":{"type":"string","const":"machine.market"},"freshness":{"type":"object","required":["cached","observed_at"],"properties":{"cached":{"type":"boolean"},"observed_at":{"type":"string","description":"ISO 8601 timestamp"}}}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.012","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.012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0WOtrJfxekFIE1SVnEx5r","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the first page of public comments for a TikTok or Instagram post by URL.","exampleAgentPrompt":"Can you grab the public comments from this TikTok video — https://www.tiktok.com/@creator/video/123456789 — and show me what people are saying? Use live freshness.","exampleUseCases":[{"title":"Sentiment check on viral TikTok","prompt":"Pull the comments from this TikTok video https://www.tiktok.com/@brand/video/987654321 with live freshness so I can see how the audience is reacting to our product launch."},{"title":"Instagram post audience feedback","prompt":"Fetch the public comments on this Instagram post https://www.instagram.com/p/ABC123/ — I want to read what followers are saying about it."},{"title":"Content research for creator analysis","prompt":"Get me the first page of comments on this TikTok https://www.tiktok.com/@influencer/video/555000111 using 7-day freshness — I'm analyzing what topics resonate with this creator's audience."}],"resultDescription":"Returns a structured JSON object containing the first page of public comments for the specified post, along with the platform name, a provider field ('machine.market'), the response type ('comments'), and freshness metadata including whether the result was cached and the ISO 8601 timestamp it was observed.","failureModes":["Invalid or private post URL returns an error or empty data","Unsupported platform value causes validation failure","Post has comments disabled — returns empty comments array","Upstream platform rate limits or blocks the request — may return stale or unavailable data","Malformed URL for target param causes a 400-level error"],"whenToPreferThis":"Choose this endpoint when you need to read the public comment thread on a specific TikTok or Instagram post and want structured, normalized output with freshness control. It is ideal for sentiment monitoring, audience research, or content analysis pipelines that need comments without scraping the platform directly.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T00:31:38.537Z","isFirstParty":false,"canonicalSlug":"machine-market-social-fetch-post-comments-d501dcee"}