# Search social posts, comments and profiles

`POST https://api.cryptohopper.com/v1/social/search`

Part of [Social](https://www.cryptohopper.com/api-documentation/api-reference/social.md) in the Cryptohopper API reference.

Searches the social network for posts, comments or profiles that contain your search text and returns up to 50 results. Content of profiles you blocked is left out.

OAuth scope: `read`

type is posts (default), recent (posts, newest first), media (posts with media), comments or profiles. Unknown types fall back to posts. start is an optional post or comment ID: only results with a lower ID are returned. An empty query returns an empty list. Profile results contain profile_id, profile_name, profile_alias, profile_image, biography, verified, total_followers, following and profile_link.

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |

## Example request

```bash
curl -X POST "https://api.cryptohopper.com/v1/social/search" \
  -H "access-token: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"bitcoin","type":"posts"}'
```

## Response

Example response (illustrative values):

```json
{
    "data": [
        {
            "id": "123456",
            "profile_id": "4567",
            "location": "NL",
            "message": "Watching BTC closely today #bitcoin",
            "media_url": "",
            "created": 1790316000,
            "updated": 1790316000,
            "private_message": "0",
            "profile_image": "https://cdn.example.com/images/social/uploads/avatar_4567.jpg",
            "profile_alias": "trader-jane",
            "profile_name": "Trader Jane",
            "verified": "0",
            "total_likes": "12",
            "total_comments": "3",
            "total_reposts": "1",
            "liked": 0,
            "commented": 0,
            "reposted": 0,
            "following": 0,
            "profile_link": "/social/profile/trader-jane",
            "repost": 0
        }
    ]
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.