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

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 About scopes

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.

Example request

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"}'

Parameters

Headers

NameTypeRequiredDescription
access-token string Required The OAuth access token of the user.

Response

Example response (illustrative values)

{
    "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. See How the API works for response codes and rate limits.