{"slug":"social","domain":"web","title":"Posts and profiles: what was said in public","summary":"One surface over X, Instagram and YouTube: profiles, posts, comments, reactions and search.","help":"social: public posts and profiles, as JSON.\n\nRETURNS\n  One JSON object on stdout. `social` with no arguments prints every study and\n  what it takes.\n\nNOTES\n  Each network is billed at its own rate, because the upstream is.\n\nStudies:\n  x profile               \u003cusername\u003e\n      an account and what it looks like from outside\n  x posts                 \u003cusername\u003e\n      what an account has posted\n  x replies               \u003cusername\u003e\n      what an account has said back to other people\n  x comments              \u003cpid\u003e\n      what was said back to one post — give it a post id\n  x search                \u003cquery\u003e\n      search the network, not one account\n  instagram profile       \u003cusername\u003e\n      an account and its counts\n  instagram posts         \u003cusername\u003e\n      what an account has posted\n  instagram followers     \u003cusername\u003e\n      who follows an account\n  instagram following     \u003cusername\u003e\n      who an account follows\n  instagram post-comments \u003cpost\u003e\n      what was said back to one post\n  youtube search          \u003cq\u003e\n      search YouTube\n  youtube video           \u003cid\u003e\n      one video and its statistics\n  youtube channel         \u003cid\u003e\n      one channel and its statistics\n  youtube channel-videos  \u003cchannel_id\u003e\n      what a channel has published\n  youtube comments        \u003cvideo_id\u003e\n      what was said back to one video\n\nJSON to stdout, so it composes: pipe to `jq` to pick a field, or `\u003e /tmp/…` to keep it.\nRun a study with no arguments — `social x profile` — to see what it takes.\n","example_command":"social x profile stripe","example_output":"","cost_class":"upstream-fetch","tier":"metered","billing_items":["x_twitter","instagram","youtube"],"price_per_1k_calls":2,"price_is_from":true,"status":"available","commands":["social"],"studies":[{"call":"x profile","about":"an account and what it looks like from outside","args":[{"name":"username","positional":true,"list":false,"hint":""},{"name":"count","positional":false,"list":false,"hint":"how many to return"}]},{"call":"x posts","about":"what an account has posted","args":[{"name":"username","positional":true,"list":false,"hint":""},{"name":"count","positional":false,"list":false,"hint":"how many to return"}]},{"call":"x replies","about":"what an account has said back to other people","args":[{"name":"username","positional":true,"list":false,"hint":""},{"name":"count","positional":false,"list":false,"hint":"how many to return"}]},{"call":"x comments","about":"what was said back to one post — give it a post id","args":[{"name":"pid","positional":true,"list":false,"hint":""},{"name":"count","positional":false,"list":false,"hint":"how many to return"}]},{"call":"x search","about":"search the network, not one account","args":[{"name":"query","positional":true,"list":false,"hint":""},{"name":"count","positional":false,"list":false,"hint":"how many to return"},{"name":"search_type","positional":false,"list":false,"hint":"Top | Latest | People"}]},{"call":"instagram profile","about":"an account and its counts","args":[{"name":"username","positional":true,"list":false,"hint":""}]},{"call":"instagram posts","about":"what an account has posted","args":[{"name":"username","positional":true,"list":false,"hint":""}]},{"call":"instagram followers","about":"who follows an account","args":[{"name":"username","positional":true,"list":false,"hint":""}]},{"call":"instagram following","about":"who an account follows","args":[{"name":"username","positional":true,"list":false,"hint":""}]},{"call":"instagram post-comments","about":"what was said back to one post","args":[{"name":"post","positional":true,"list":false,"hint":""}]},{"call":"youtube search","about":"search YouTube","args":[{"name":"q","positional":true,"list":false,"hint":""},{"name":"max_results","positional":false,"list":false,"hint":"how many to return"},{"name":"order","positional":false,"list":false,"hint":"relevance | date | viewCount"},{"name":"page_token","positional":false,"list":false,"hint":"continue a previous page"}]},{"call":"youtube video","about":"one video and its statistics","args":[{"name":"id","positional":true,"list":false,"hint":""}]},{"call":"youtube channel","about":"one channel and its statistics","args":[{"name":"id","positional":true,"list":false,"hint":""}]},{"call":"youtube channel-videos","about":"what a channel has published","args":[{"name":"channel_id","positional":true,"list":false,"hint":""},{"name":"max_results","positional":false,"list":false,"hint":"how many to return"},{"name":"order","positional":false,"list":false,"hint":"relevance | date | viewCount"},{"name":"page_token","positional":false,"list":false,"hint":"continue a previous page"}]},{"call":"youtube comments","about":"what was said back to one video","args":[{"name":"video_id","positional":true,"list":false,"hint":""},{"name":"max_results","positional":false,"list":false,"hint":"how many to return"},{"name":"page_token","positional":false,"list":false,"hint":"continue a previous page"}]}],"default_enabled":false,"first_seen":"2026-09-09T04:30:35.160951Z","enabled":false}