> ## 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

> Search and read posts, profiles, and comments across Reddit, Instagram, LinkedIn, and Pinterest. Get a LinkedIn profile, company, or its latest posts.

Search and read posts, profiles, and comments across Reddit, Instagram, LinkedIn, and Pinterest. Get a LinkedIn profile, company, or its latest posts. See every field in the [Social reference](/api-reference/endpoint/reddit-search), or try it in the [playground](https://stophy.dev/playground).

## Search Reddit posts, subreddits and users

<CodeGroup>
  ```typescript TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
  import { Stophy } from "stophy";

  const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
  const result = await stophy.reddit.search({ query: "typescript" });
  console.log(result.data.results);
  ```

  ```python Python icon="python" theme={null}
  from stophy import Stophy

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.reddit.search(query="typescript")
  print(result["data"]["results"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/reddit/search \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{"query":"typescript"}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy reddit search typescript
  ```
</CodeGroup>

The response:

```json theme={null}
{
  "success": true,
  "data": {
    "results": [
      {
        "type": "post",
        "postId": "abc123",
        "postUrl": "https://example.com/",
        "title": "Example title",
        "text": "A short, readable summary of the result.",
        "authorId": "abc123",
        "authorUsername": "example",
        "authorUrl": "https://example.com/",
        "subreddit": "example",
        "score": 4.5,
        "upvotePercent": 1,
        "comments": 1,
        "publishedAt": "2026-09-28T12:00:00.000Z",
        "flair": "example",
        "linkUrl": "https://example.com/",
        "thumbnailUrl": "https://example.com/image.jpg",
        "isNsfw": false,
        "isVideo": false,
        "isPinned": false,
        "imageUrls": [
          "https://example.com/image.jpg"
        ],
        "videoUrl": "https://example.com/",
        "videoHlsUrl": "https://example.com/",
        "videoDurationSeconds": 120,
        "pollOptions": [
          {
            "text": "A short, readable summary of the result.",
            "votes": 1
          }
        ],
        "pollTotalVotes": 1234,
        "pollEndsAt": "2026-09-28T12:00:00.000Z",
        "repostOfUrl": "https://example.com/"
      }
    ]
  },
  "creditsUsed": 1,
  "requestId": "88a2ad5a-4f37-426f-896f-bf70f9450877"
}
```

## Endpoints

| Endpoint | Cost |
| - | - |
| [Search Reddit posts, subreddits and users](/api-reference/endpoint/reddit-search) | 1 credit (no key needed) |
| [Read a post and its comment thread, with a cursor for the rest of the comments](/api-reference/endpoint/reddit-post) | 1 credit |
| [Get a subreddit's info and a page of its posts](/api-reference/endpoint/reddit-subreddit) | 1 credit |
| [Get a user's profile and a page of their posts and comments](/api-reference/endpoint/reddit-user) | 1 credit |
| [Get Reddit posts that link to a website](/api-reference/endpoint/reddit-domain) | 1 credit |
| [See where else on Reddit one link was shared, like Reddit's Other discussions](/api-reference/endpoint/reddit-discussions) | 1 credit |
| [List Reddit's popular or newest communities](/api-reference/endpoint/reddit-subreddits) | 1 credit |
| [Get a profile's bio, stats and a page of its posts and reels](/api-reference/endpoint/instagram-profile) | 2 credits |
| [A profile's reels, with play counts](/api-reference/endpoint/instagram-profile-reels) | 1 credit |
| [Get a post or reel, with its top comments](/api-reference/endpoint/instagram-post) | 1 credit |
| [Get a post's comments, or the replies to one comment](/api-reference/endpoint/instagram-comments) | 1 credit |
| [Search Instagram posts and reels](/api-reference/endpoint/instagram-search) | 1 credit |
| [Get a company's profile, size and industry](/api-reference/endpoint/linkedin-company) | 1 credit |
| [Get a person's profile](/api-reference/endpoint/linkedin-profile) | 2 credits |
| [Get a person's or company's latest public posts](/api-reference/endpoint/linkedin-posts) | 1 credit |
| [Search pins](/api-reference/endpoint/pinterest-search) | 1 credit |
| [Get a pin's details](/api-reference/endpoint/pinterest-pin) | 1 credit |
| [Get a board and a page of its pins](/api-reference/endpoint/pinterest-board) | 1 credit |
| [Get a profile and a page of its pins](/api-reference/endpoint/pinterest-profile) | 1 credit |

## More ways to call it

### Get a profile's bio, stats and a page of its posts and reels

<CodeGroup>
  ```typescript TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
  import { Stophy } from "stophy";

  const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
  const result = await stophy.instagram.profile({ username: "natgeo" });
  console.log(result.data.results);
  ```

  ```python Python icon="python" theme={null}
  from stophy import Stophy

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.instagram.profile(username="natgeo")
  print(result["data"]["results"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/instagram/profile \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{"username":"natgeo"}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy instagram profile --username natgeo
  ```
</CodeGroup>

### Get a person's profile

<CodeGroup>
  ```typescript TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
  import { Stophy } from "stophy";

  const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
  const result = await stophy.linkedin.profile({ profileId: "satyanadella" });
  console.log(result.data);
  ```

  ```python Python icon="python" theme={null}
  from stophy import Stophy

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.linkedin.profile(profile_id="satyanadella")
  print(result["data"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/linkedin/profile \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{"profileId":"satyanadella"}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy linkedin profile --profileId satyanadella
  ```
</CodeGroup>

<Tip>Reddit search works without a key. Instagram profile and LinkedIn profile cost 2 credits. Endpoints that return a `cursor` or a `page` page. See [Page through results](/guides/paging).</Tip>


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