{"uid":"cap_2Mm5N1NLwJHtvSLpYJmxD","slug":"vaaya-person-interactions-d37c6ca6","name":"Vaaya Person Interactions","description":"Give an AI agent a credit account. Set a limit and a spending policy, and the agent makes approved, metered purchases from providers that accept Vaaya.","url":"https://vaaya.ai/api/run/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","$schema":"http://json-schema.org/draft-07/schema#","required":["social_media_url","type"],"properties":{"type":{"enum":["replies","followers","following","followers,following"],"type":"string"},"tweet_id":{"type":"string","maxLength":25},"username":{"type":"string","maxLength":100},"max_results":{"type":"integer","maximum":1000,"minimum":10},"social_media_url":{"type":"string","format":"uri"}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"pathParams":{"type":"object"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.3","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.3/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.3","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.3","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WAe-yealqr8ay0p7i-dVe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.3","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches social media interactions for a person — replies, followers, or following — given a profile URL or username","exampleAgentPrompt":"Can you pull the followers and following for the Twitter profile at https://twitter.com/elonmusk — get up to 100 results?","exampleUseCases":[{"title":"Audience research for outreach campaign","prompt":"Fetch up to 500 followers for the Twitter account at https://twitter.com/hubspot so I can identify potential prospects to reach out to."},{"title":"Competitive network mapping","prompt":"Get the list of accounts that https://twitter.com/salesforce is following — up to 200 results — so I can map out their partner and influencer network."},{"title":"Conversation thread analysis","prompt":"Retrieve the replies to tweet ID 1234567890123456789 from https://twitter.com/techcrunch, up to 50 results, so I can analyze the audience reaction."}],"resultDescription":"Returns a structured list of social media interactions — followers, accounts being followed, or tweet replies — associated with the given profile URL or tweet. Each result typically includes user profile data such as usernames, display names, and profile metadata for followers/following, or reply content for tweet replies.","failureModes":["Invalid or inaccessible social_media_url returns an error","Tweet ID not found or deleted returns empty or error response","max_results below minimum (10) or above maximum (1000) causes validation failure","Rate limits on the underlying social platform may throttle or block responses","Private or protected accounts may return no data","Malformed URL format causes schema validation rejection"],"whenToPreferThis":"Use this endpoint when you need to programmatically retrieve social interaction data — followers, following, or replies — for a specific social media profile or tweet, without managing your own Twitter API credentials or OAuth flows. It is ideal for agent-driven contact enrichment, audience research, competitive analysis, and outreach automation workflows where social graph data is needed on demand.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:32:39.586Z","isFirstParty":false}