{"slug":"social","domain":"web","title":"What a person or company said in public","summary":"One surface over X, LinkedIn, 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: LinkedIn costs twenty times what X\n  does, because the upstream does. `linkedin company-by-domain` exists because a\n  website domain is the join you usually have, and a LinkedIn url is not.\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  linkedin member-profile       \u003clinkedin_url\u003e\n      a person's profile as LinkedIn shows it\n  linkedin profile-posts        \u003clinkedin_url\u003e\n      what a person has posted\n  linkedin profile-comments     \u003clinkedin_url\u003e\n      what a person has commented on other posts\n  linkedin profile-reactions    \u003clinkedin_url\u003e\n      what a person has reacted to, which is the cheapest signal of what they read\n  linkedin post-comments        \u003curn\u003e\n      what was said back to one post — give it the post's urn\n  linkedin company-by-url       \u003clinkedin_url\u003e\n      a company page\n  linkedin company-by-domain    \u003cdomain\u003e\n      a company page, found from its website domain — the join you actually have\n  linkedin search-posts-member  \u003cmember_urn\u003e\n      posts by one member within a window\n  linkedin search-posts-company \u003ccompany_id\u003e\n      posts by one company within a window\n  linkedin search-posts-keyword \u003ckeyword\u003e\n      posts mentioning a keyword within a window\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 linkedin company-by-domain stripe.com","example_output":"","cost_class":"upstream-fetch","tier":"metered","billing_items":["x_twitter","linkedin","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":"linkedin member-profile","about":"a person's profile as LinkedIn shows it","args":[{"name":"linkedin_url","positional":true,"list":false,"hint":""}]},{"call":"linkedin profile-posts","about":"what a person has posted","args":[{"name":"linkedin_url","positional":true,"list":false,"hint":""}]},{"call":"linkedin profile-comments","about":"what a person has commented on other posts","args":[{"name":"linkedin_url","positional":true,"list":false,"hint":""}]},{"call":"linkedin profile-reactions","about":"what a person has reacted to, which is the cheapest signal of what they read","args":[{"name":"linkedin_url","positional":true,"list":false,"hint":""}]},{"call":"linkedin post-comments","about":"what was said back to one post — give it the post's urn","args":[{"name":"urn","positional":true,"list":false,"hint":""}]},{"call":"linkedin company-by-url","about":"a company page","args":[{"name":"linkedin_url","positional":true,"list":false,"hint":""}]},{"call":"linkedin company-by-domain","about":"a company page, found from its website domain — the join you actually have","args":[{"name":"domain","positional":true,"list":false,"hint":""}]},{"call":"linkedin search-posts-member","about":"posts by one member within a window","args":[{"name":"member_urn","positional":true,"list":false,"hint":""},{"name":"date_posted","positional":false,"list":false,"hint":"past-24h | past-week | past-month"}]},{"call":"linkedin search-posts-company","about":"posts by one company within a window","args":[{"name":"company_id","positional":true,"list":false,"hint":""},{"name":"date_posted","positional":false,"list":false,"hint":"past-24h | past-week | past-month"}]},{"call":"linkedin search-posts-keyword","about":"posts mentioning a keyword within a window","args":[{"name":"keyword","positional":true,"list":false,"hint":""},{"name":"date_posted","positional":false,"list":false,"hint":"past-24h | past-week | past-month"}]},{"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}