{"uid":"cap_4nzKcdEJskNQE_xWz4d3w","slug":"machine-market-social-fetch-public-social-post-9709c09b","name":"Machine Market Social – Fetch Public Social Post","description":"Fetch structured data for one public social post.","url":"https://machine-market-social-mainnet.machine-market.workers.dev/post?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":"post"},"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.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XCto4w0y6QE8YPV3BjRv9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches structured metadata for a single public social media post from TikTok or Instagram.","exampleAgentPrompt":"Can you pull the structured data for this TikTok post — https://www.tiktok.com/@creator/video/123456789 — using live freshness so I get the latest stats?","exampleUseCases":[{"title":"Track viral TikTok post metrics","prompt":"Grab me the latest structured data for this TikTok video — https://www.tiktok.com/@someuser/video/987654321 — I want the current view count, likes, and caption. Use live freshness."},{"title":"Monitor Instagram post engagement","prompt":"Fetch the post details for this Instagram post URL https://www.instagram.com/p/ABC123xyz/ on the instagram platform, with live freshness so I get real-time engagement numbers."},{"title":"Automate content research pipeline","prompt":"I'm building a list of top posts — can you fetch structured data for this TikTok URL https://www.tiktok.com/@brand/video/111222333 using 7d freshness to keep costs low? I need the caption, likes, and shares."}],"resultDescription":"Returns a structured JSON object with success status, platform name, provider (machine.market), post type, freshness info (whether cached and the observed_at ISO 8601 timestamp), and a data object containing post-specific fields such as caption, like count, view count, share count, and other platform-native metadata.","failureModes":["Invalid or private post URL returns an error — post must be public","Unsupported platform (anything other than tiktok or instagram) will be rejected","Post has been deleted or made private since last crawl — stale or missing data","Rate limits or upstream platform blocks may cause fetch failures","Malformed URL in the target parameter causes a validation error"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable data for a single known social post on TikTok or Instagram — especially when you have the direct post URL and want to avoid writing your own scraper. It supports freshness control (live, 24h, 7d) so you can trade off latency and cost. Prefer it over general web scrapers when you need normalized, schema-consistent output with post-level metadata.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:21:36.044Z","isFirstParty":false,"canonicalSlug":"machine-market-social-fetch-public-social-post-9709c09b"}