> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stophy.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Social

> Parsers for social: reddit-search, reddit-post, reddit-subreddit, reddit-user, reddit-subreddits, instagram-post, instagram-profile, instagram-feed and more.

Send the example URL to [scrape](https://docs.stophy.dev/api-reference/endpoint/scrape.md) with the format `{"type": "json", "parser": "<name>"}`. See [Pre-built parsers](https://docs.stophy.dev/scrape/prebuilt-parsers).

### `reddit-search`

A Reddit search page with a q query, on reddit.com/search or inside a subreddit. Add type=sr to the page for communities or type=user for people. Example: `https://www.reddit.com/search/?q=web+scraping&sort=top&t=year`

Returns `results`, `cursor`, `page`, `total`.

Works without an API key when you send no options.

Options:

* `subreddit`
* `cursor`

### `reddit-post`

A Reddit post page or a redd.it short link. Set options.view to discussions to list the other subreddits where the same link was shared. Example: `https://www.reddit.com/r/programming/comments/1xjiofl/how_curl_was_accidentally_turingcomplete_for_nine/`

Returns `id`, `url`, `title`, `text`, `author`, `community`, `publishedAt`, `likes`, `comments`, `shares`, `views`, `media`, `hashtags`.

Options:

* `view`: `discussions`.
* `comment`: A comment id or link: returns that comment's thread, like Reddit's own link.
* `sort`: Reddit's own comment sort.
* `cursor`

### `reddit-subreddit`

A subreddit page, like reddit.com/r/programming/ or reddit.com/r/programming/top/?t=week. Example: `https://www.reddit.com/r/programming/top/?t=week`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `cursor`

### `reddit-user`

A Reddit user page, like reddit.com/user/spez or reddit.com/user/spez/comments. Example: `https://www.reddit.com/user/spez/`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `tab`
* `sort`: Reddit's own sort.
* `time`: Reddit's own time filter. Leave out for Reddit's default.
* `cursor`

### `reddit-subreddits`

The Reddit list of popular subreddits, reddit.com/subreddits. Example: `https://www.reddit.com/subreddits/`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `cursor`

### `instagram-post`

An Instagram post, reel or share link. Example: `https://www.instagram.com/p/DeuOR-CjKE9/`

Returns `id`, `url`, `title`, `text`, `author`, `community`, `publishedAt`, `likes`, `comments`, `shares`, `views`, `media`, `hashtags`.

### `instagram-profile`

An Instagram profile page, like instagram.com/natgeo. Its reels tab, like instagram.com/natgeo/reels, or options.view set to reels on the profile page, returns the reels. Example: `https://www.instagram.com/natgeo/`

Returns `id`, `url`, `handle`, `name`, `bio`, `avatarUrl`, `isVerified`, `followers`, `following`, `posts`, `website`, `location`, `category`.

Options:

* `view`: `reels`.
* `cursor`

### `instagram-comments`

An Instagram post, reel or share link. Example: `https://www.instagram.com/p/DeuOR-CjKE9/`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `cursor`

### `instagram-feed`

An Instagram hashtag, location or keyword search page, like instagram.com/explore/tags/travel. Example: `https://www.instagram.com/explore/tags/travel/`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `cursor`

### `x-profile`

An X profile page, like x.com/nasa. Set options.view to posts for the profile's posts. Example: `https://x.com/nasa`

Returns `id`, `url`, `handle`, `name`, `bio`, `avatarUrl`, `isVerified`, `followers`, `following`, `posts`, `website`, `location`, `category`.

Works without an API key when you send no options.

Options:

* `view`: `posts`.
* `cursor`, with `view` `posts`: the cursor from the previous response. Send it as is.

### `x-post`

An X post page, like x.com/nasa/status/`<id>`. Example: `https://x.com/NASA/status/2118041009766678695`

Returns `id`, `url`, `title`, `text`, `author`, `community`, `publishedAt`, `likes`, `comments`, `shares`, `views`, `media`, `hashtags`.

Works without an API key when you send no options.

### `x-community`

An X community page, like x.com/i/communities/`<id>`. Set options.view to posts for the community's top posts, with no cursor for more. Example: `https://x.com/i/communities/1699807431709041070`

Returns `id`, `url`, `name`, `description`, `topic`, `memberCount`, `joinPolicy`, `isNsfw`, `createdAt`, `bannerUrl`, `rules`.

Works without an API key when you send no options.

Options:

* `view`: `posts`.
* `limit`, with `view` `posts`: return at most this many posts. You pay \$0.001 for each 10 returned.

### `threads-profile`

A Threads profile page, like threads.com/@nasa. Set options.view to posts for the profile's posts. Example: `https://www.threads.com/@nasa`

Returns `id`, `url`, `handle`, `name`, `bio`, `avatarUrl`, `isVerified`, `followers`, `following`, `posts`, `website`, `location`, `category`.

Options:

* `view`: `posts`.
* `cursor`, with `view` `posts`: the cursor from the previous response. Send it as is.

### `threads-post`

A Threads post page, like threads.com/@nasa/post/`<code>`. Example: `https://www.threads.com/@nasa/post/DfVbdbGAhkX`

Returns `id`, `url`, `title`, `text`, `author`, `community`, `publishedAt`, `likes`, `comments`, `shares`, `views`, `media`, `hashtags`.

Options:

* `cursor`

### `pinterest-search`

A Pinterest pin or video search page with a q query, like pinterest.com/search/pins/?q=kitchen. Example: `https://www.pinterest.com/search/pins/?q=kitchen%20ideas`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `type`
* `cursor`

### `pinterest-pin`

A Pinterest pin page or a pin.it short link. Example: `https://www.pinterest.com/pin/32088216099796013/`

Returns `id`, `url`, `title`, `text`, `author`, `community`, `publishedAt`, `likes`, `comments`, `shares`, `views`, `media`, `hashtags`.

Works without an API key when you send no options.

### `pinterest-board`

A Pinterest board page, like pinterest.com/`<user>`/`<board>`/. Example: `https://www.pinterest.com/TileBar/tiles-backsplashes/`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `cursor`

### `pinterest-profile`

A Pinterest profile page, like pinterest.com/marthastewart/. Example: `https://www.pinterest.com/marthastewart/`

Returns `id`, `url`, `handle`, `name`, `bio`, `avatarUrl`, `isVerified`, `followers`, `following`, `posts`, `website`, `location`, `category`.

Options:

* `cursor`

### `facebook-page`

A Facebook page, like facebook.com/NASA. Set options.view to posts for the page's posts. Example: `https://www.facebook.com/NASA`

Returns `id`, `url`, `handle`, `name`, `bio`, `avatarUrl`, `isVerified`, `followers`, `following`, `posts`, `website`, `location`, `category`.

Options:

* `view`: `posts`.
* `cursor`, with `view` `posts`: the cursor from the previous response. Send it as is.

### `facebook-group`

A public Facebook group, like facebook.com/groups/NASA.SCIENCE. Example: `https://www.facebook.com/groups/NASA.SCIENCE/`

Returns `id`, `url`, `handle`, `name`, `bio`, `avatarUrl`, `isVerified`, `followers`, `following`, `posts`, `website`, `location`, `category`.

### `facebook-post`

A Facebook post, reel or video page, or an fb.watch link. Example: `https://www.facebook.com/NASA/posts/pfbid02gQRwwY2RMZvcRYS9eqkWDBm9idv46oRRVvPFvtsPu9UyoHiukHQ6PjWwfKE4TKXQl`

Returns `id`, `url`, `title`, `text`, `author`, `community`, `publishedAt`, `likes`, `comments`, `shares`, `views`, `media`, `hashtags`.

### `facebook-comments`

A Facebook post, reel or video page, or an fb.watch link. Example: `https://www.facebook.com/NASA/posts/pfbid02gQRwwY2RMZvcRYS9eqkWDBm9idv46oRRVvPFvtsPu9UyoHiukHQ6PjWwfKE4TKXQl`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `cursor`

### `linkedin-company`

A LinkedIn company page. Example: `https://www.linkedin.com/company/microsoft`

Returns `id`, `url`, `handle`, `name`, `bio`, `avatarUrl`, `isVerified`, `followers`, `following`, `posts`, `website`, `location`, `category`.

### `linkedin-profile`

A LinkedIn profile page. Example: `https://www.linkedin.com/in/satyanadella`

Returns `id`, `url`, `handle`, `name`, `bio`, `avatarUrl`, `isVerified`, `followers`, `following`, `posts`, `website`, `location`, `category`.

### `linkedin-posts`

A LinkedIn profile or company page. Example: `https://www.linkedin.com/company/microsoft`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `cursor`

### `bsky-profile`

A Bluesky profile page, like bsky.app/profile/bsky.app. Set options.view to posts for the profile's posts, and options.cursor from the last answer for the next page. A page can be empty with a cursor, so keep paging until the cursor is null. Example: `https://bsky.app/profile/bsky.app`

Returns `id`, `url`, `handle`, `name`, `bio`, `avatarUrl`, `isVerified`, `followers`, `following`, `posts`, `website`, `location`, `category`.

Options:

* `view`: `posts`.
* `limit`, with `view` `posts`: return at most this many posts. You pay \$0.001 for each 10 returned.
* `cursor`, with `view` `posts`: the cursor from the previous response. Send it as is.

### `bsky-post`

A Bluesky post page, like bsky.app/profile/bsky.app/post/3n27yge3hys24. Example: `https://bsky.app/profile/bsky.app/post/3n27yge3hys24`

Returns `id`, `url`, `title`, `text`, `author`, `community`, `publishedAt`, `likes`, `comments`, `shares`, `views`, `media`, `hashtags`.

### `link-in-bio`

A Linktree, Komi, Linkbio or Linkme page, like linktr.ee/name, name.komi.io, linkbio.co/name, linkme.bio/name or link.me/name. Example: `https://linktr.ee/selenagomez`

Returns `id`, `url`, `handle`, `name`, `bio`, `avatarUrl`, `isVerified`, `followers`, `following`, `posts`, `website`, `location`, `category`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.