{"uid":"cap_sm_qpFKxztvYoWrjtk9-u","slug":"social-media-interactions-async-retrieval-01725e05","name":"Social Media Interactions Async Retrieval","description":"Start async retrieval of social media interactions. Requires social_media_url and type.","url":"https://x402.orthogonal.com/nyne/person/interactions","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{"type":{"type":"string","description":"Interaction type: replies, followers, following, or followers,following"},"max_results":{"type":"integer","description":"Maximum results to return (default: 100, max: 1000)"},"callback_url":{"type":"string","description":"URL to receive results via webhook"},"social_media_url":{"type":"string","description":"Twitter/X or Instagram profile or post URL"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.219","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.219/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.219","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.219","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_o2hBhB0zdvI2n4Ny-LVs9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.219","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Asynchronously retrieves social media interactions (e.g., likes, comments, reposts) for a given social media post URL.","exampleAgentPrompt":"Can you pull all the comments and likes on this tweet — https://twitter.com/elonmusk/status/123456789 — using the interactions type 'comments'?","exampleUseCases":[{"title":"Monitor post engagement for a brand","prompt":"Fetch all the interactions on this Instagram post https://instagram.com/p/abc123 — I want to see comments and replies to understand how our campaign is landing."},{"title":"Research viral content reactions","prompt":"Can you retrieve the likes and reposts for this viral tweet at https://twitter.com/user/status/987654321 so I can analyze who's engaging with it?"},{"title":"Track competitor social activity","prompt":"Pull the interaction data for this LinkedIn post from our competitor — https://linkedin.com/posts/competitor-post-456 — specifically the comments so I can see what people are saying."}],"resultDescription":"Returns an async job reference or interaction data including social media engagements such as likes, comments, reposts, and replies associated with the specified post URL, keyed by interaction type.","failureModes":["Invalid or inaccessible social_media_url returns an error","Missing required 'type' parameter causes a validation error","Rate limits or platform blocks may cause retrieval failures","Async job may time out for posts with very high interaction counts","Private or deleted posts return empty or error responses"],"whenToPreferThis":"Use this endpoint when you need to programmatically retrieve interaction data (likes, comments, reposts) from a social media post URL in an async manner, particularly when the volume of interactions is large enough to require background processing. Prefer this over synchronous scrapers when handling high-engagement posts or when you need structured interaction types rather than raw HTML.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:44.088Z","isFirstParty":false}