SocialData API

https://docs.socialdata.tools/
Admin
SocialData API is a scalable and reliable API that simplifies fetching data from social media...
Tokens:113,623
Snippets:640
Trust Score:7.1
Update:1 month ago
Show doc for...
Tokens:
Raw
### Example response 200 for get list members

Source: https://docs.socialdata.tools/reference/get-list-members.md

Successful response containing a next_cursor for pagination and an array of user objects with profile details.

```json
{
    "next_cursor": "4611686018541662731|1741080922217775060",
    "users": [
        {
            "id": 1547124452596523008,
            "id_str": "1547124452596523008",
            "name": "Gwendal Brossard",
            "screen_name": "GwendalBrossard",
            "location": "Building",
            "url": "https:\/\/t.co\/6o4TTYu7LQ",
            "description": "I'm an indie maker building products \ud83d\udc68\u200d\ud83d\udcbb @PaletteBrain\u2506https:\/\/t.co\/BEadk6UDlz \u2728",
            "protected": false,
            "verified": false,
            "followers_count": 3557,
            "friends_count": 149,
            "listed_count": 41,
            "favourites_count": 12425,
            "statuses_count": 6778,
            "created_at": "2022-07-13T07:43:56.000000Z",
            "profile_banner_url": "https:\/\/pbs.twimg.com\/profile_banners\/1547124452596523008\/1672736091",
            "profile_image_url_https": "https:\/\/pbs.twimg.com\/profile_images\/1572151372455313409\/qq1yH56d_normal.jpg",
            "can_dm": true
        },
        ...
    ]
}
```

--------------------------------

### PHP Example

Source: https://docs.socialdata.tools/reference/get-list-tweets.md

Example PHP call to the Get List Tweets endpoint.

```APIDOC
### PHP

```php
$list_id = '1625802236571033602';
$API_KEY = 'YOUR_API_KEY_HERE';

$url = "https://api.socialdata.tools/twitter/list/{$list_id}/tweets";

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $API_KEY",
        "Accept: application/json"
    ]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);

curl_close($ch);
```
```

--------------------------------

### Get a user's similar profiles using PHP and cURL

Source: https://docs.socialdata.tools/reference/get-user-similar-profiles.md

PHP example using the cURL library to send a GET request and print the response. The API key is set in the Authorization header.

```php
$userId = '44196397';
$API_KEY = 'YOUR_API_KEY_HERE';

$url = "https://api.socialdata.tools/twitter/user/{$userId}/similar";

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $API_KEY",
        "Accept: application/json"
    ]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);

curl_close($ch);
```

--------------------------------

### Python Example

Source: https://docs.socialdata.tools/reference/get-list-tweets.md

Example Python call to the Get List Tweets endpoint.

```APIDOC
### Python

```python
import requests

list_id = '1625802236571033602'
API_KEY = 'YOUR_API_KEY_HERE'

url = f'https://api.socialdata.tools/twitter/list/{list_id}/tweets'

headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Accept': 'application/json'
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Error: {response.status_code}")
    print(response.text)
```
```

--------------------------------

### JavaScript Example

Source: https://docs.socialdata.tools/reference/get-list-tweets.md

Example JavaScript call to the Get List Tweets endpoint.

```APIDOC
### JavaScript

```js
const listId = '1625802236571033602';
const API_KEY = 'YOUR_API_KEY_HERE';

fetch(`https://api.socialdata.tools/twitter/list/${listId}/tweets`, {
    method: 'GET',
    headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Accept': 'application/json'
    }
})
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
```
```

--------------------------------

### Get event details - Example Response

Source: https://docs.socialdata.tools/monitoring/monitor-event-history.md

Example JSON response from GET /monitors/{monitor_id}/events/{event_id}. Returns a single event including the full webhook payload (request_body) and the body your server responded with (response_body). The request_body contains the exact JSON posted to your webhook URL; parse it to replay the event as if it had been delivered normally.

```json
{
    "data": {
        "id": "MTAwMDAwMDk4NzY1NDMyMQ==",
        "created_at": "2026-08-01T14:22:31.000000Z",
        "url": "https://my-website.com/webhook",
        "response_code": 502,
        "request_body": "{\"event\":\"new_tweet\",\"data\":{ /* ... full tweet ... */ },\"meta\":{ /* ... */ }}",
        "response_body": "<html><head><title>502 Bad Gateway</title></head></html>"
    }
}
```

--------------------------------

### Get user's lists with JavaScript fetch

Source: https://docs.socialdata.tools/reference/get-user-lists.md

Use this JavaScript example to fetch the user's lists. Note that the user_id should be stored as a String to avoid exceeding the default Integer type limit. Replace API_KEY with your actual key.

```js
const userId = '44196397';
const API_KEY = 'YOUR_API_KEY_HERE';

fetch(`https://api.socialdata.tools/twitter/user/${userId}/lists`, {
    method: 'GET',
    headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Accept': 'application/json'
    }
})
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
```

--------------------------------

### 200 OK Response

Source: https://docs.socialdata.tools/reference/get-user-followers.md

Example success response for the Get User Followers endpoint. Contains a next_cursor for pagination and an array of user objects with profile details. The users array is truncated with a comment placeholder.

```json
{
    "next_cursor": "4611686018541662731|1741080922217775060",
    "users": [
        {
            "id": 1547124452596523008,
            "id_str": "1547124452596523008",
            "name": "Gwendal Brossard",
            "screen_name": "GwendalBrossard",
            "location": "Building",
            "url": "https:\/\/t.co\/6o4TTYu7LQ",
            "description": "I'm an indie maker building products \ud83d\udc68\u200d\ud83d\udcbb @PaletteBrain\u2506https:\/\/t.co\/BEadk6UDlz \u2728",
            "protected": false,
            "verified": false,
            "followers_count": 3557,
            "friends_count": 149,
            "listed_count": 41,
            "favourites_count": 12425,
            "statuses_count": 6778,
            "created_at": "2022-07-13T07:43:56.000000Z",
            "profile_banner_url": "https:\/\/pbs.twimg.com\/profile_banners\/1547124452596523008\/1672736091",
            "profile_image_url_https": "https:\/\/pbs.twimg.com\/profile_images\/1572151372455313409\/qq1yH56d_normal.jpg",
            "can_dm": true
        },
        // ...
    ]
}
```

--------------------------------

### Get user's lists with Python requests

Source: https://docs.socialdata.tools/reference/get-user-lists.md

Use this Python example to retrieve the user's lists. It uses the requests library and prints the JSON response or an error message. Replace API_KEY with your actual key.

```python
import requests

userId = '44196397'
API_KEY = 'YOUR_API_KEY_HERE'

url = f'https://api.socialdata.tools/twitter/user/{userId}/lists'

headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Accept': 'application/json'
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Error: {response.status_code}")
    print(response.text)
```

--------------------------------

### Get user's lists with PHP cURL

Source: https://docs.socialdata.tools/reference/get-user-lists.md

Use this PHP example to fetch the user's lists using cURL. It decodes the JSON response and prints it with print_r. Replace API_KEY with your actual key.

```php
$userId = '44196397';
$API_KEY = 'YOUR_API_KEY_HERE';

$url = "https://api.socialdata.tools/twitter/user/{$userId}/lists";

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $API_KEY",
        "Accept: application/json"
    ]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);

curl_close($ch);
```

--------------------------------

### Example response 404

Source: https://docs.socialdata.tools/monitoring/delete-monitor.md

Example error response when the monitor does not exist.

```json
{
    "status": "error",
    "message": "Not found"
}
```

--------------------------------

### Create User Profile Monitor with JavaScript fetch

Source: https://docs.socialdata.tools/monitoring/create-user-profile-monitor.md

Use this JavaScript fetch example to create a user profile monitor. It sends a POST request with the user_id in the JSON body and logs the response. Replace YOUR_API_KEY_HERE with your actual API key.

```js
const API_KEY = 'YOUR_API_KEY_HERE';
const userId = 1493446837214187523;

fetch('https://api.socialdata.tools/monitors/user-profile', {
    method: 'POST',
    headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json',
        'Accept': 'application/json'
    },
    body: JSON.stringify({ user_id: userId })
})
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
```

--------------------------------

### Create User Profile Monitor with Python requests

Source: https://docs.socialdata.tools/monitoring/create-user-profile-monitor.md

Use this Python requests example to create a user profile monitor. It sends a POST request with the user_id and prints the response data on success, or the error status and text on failure. Replace YOUR_API_KEY_HERE with your actual API key.

```python
import requests

API_KEY = 'YOUR_API_KEY_HERE'
user_id = 1493446837214187523

url = 'https://api.socialdata.tools/monitors/user-profile'

headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Content-Type': 'application/json',
    'Accept': 'application/json'
}

payload = {'user_id': user_id}

response = requests.post(url, json=payload, headers=headers)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Error: {response.status_code}")
    print(response.text)
```

--------------------------------

### Get Tweet Comments - 200 Response Example

Source: https://docs.socialdata.tools/reference/get-tweet-comments.md

Example 200 response from the get tweet comments endpoint. Shows two tweet objects with fields such as tweet_created_at, id, full_text, user details, and engagement metrics. The response includes nested user and entities objects.

```json
{
  "tweets": [
    {
      "tweet_created_at": "2025-02-14T12:01:25.000000Z",
      "id": 1890370761136668854,
      "id_str": "1890370761136668854",
      "conversation_id_str": "1890269299287441612",
          "text": null,
      "full_text": "@elonmusk We can’t thank you enough.",
      "source": "<a href=\"https:\/\/mobile.twitter.com\" rel=\"nofollow\">Twitter Web App<\/a>",
      "truncated": false,
      "in_reply_to_status_id": 1890269299287441612,
      "in_reply_to_status_id_str": "1890269299287441612",
      "in_reply_to_user_id": 44196397,
      "in_reply_to_user_id_str": "44196397",
      "in_reply_to_screen_name": "elonmusk",
      "user": {
        "id": 1366385465096630276,
        "id_str": "1366385465096630276",
        "name": "MYPOTUSTRUMP",
        "screen_name": "11Pythagorean",
        "location": "",
        "url": null,
        "description": "Shorten the refractory period of your emotional reactions-go confidently in the direction of your dreams—live the life you’ve imagined! Catholic #IDONOTCONSENT",
        "protected": false,
        "verified": false,
        "followers_count": 2400,
        "friends_count": 1460,
        "listed_count": 3,
        "favourites_count": 243414,
        "statuses_count": 211500,
        "created_at": "2021-03-01T13:51:11.000000Z",
        "profile_banner_url": "https:\/\/pbs.twimg.com\/profile_banners\/1366385465096630276\/1681663176",
        "profile_image_url_https": "https:\/\/pbs.twimg.com\/profile_images\/1854480101385125894\/uYkO23Fn_normal.jpg",
        "can_dm": true
      },
      "quoted_status_id": null,
      "quoted_status_id_str": null,
      "is_quote_status": false,
      "quoted_status": null,
      "retweeted_status": null,
      "quote_count": 0,
      "reply_count": 0,
      "retweet_count": 0,
      "favorite_count": 0,
      "views_count": 1,
      "bookmark_count": 0,
      "lang": "en",
      "entities": {
        "hashtags": [],
        "symbols": [],
        "timestamps": [],
        "urls": [],
        "user_mentions": [
          {
            "id_str": "44196397",
            "name": "Elon Musk",
            "screen_name": "elonmusk",
            "indices": [
              0,
              9
            ]
          }
        ]
      },
      "is_pinned": false
    },
    {
      "tweet_created_at": "2025-02-14T12:01:08.000000Z",
      "id": 1890370687853879456,
      "id_str": "1890370687853879456",
      "conversation_id_str": "1890269299287441612",
      "text": null,
      "full_text": "@elonmusk 😂👍 https:\/\/t.co\/VqqcUkYlAp",
      "source": "<a href=\"http:\/\/twitter.com\/download\/iphone\" rel=\"nofollow\">Twitter for iPhone<\/a>",
      "truncated": false,
      "in_reply_to_status_id": 1890269299287441612,
      "in_reply_to_status_id_str": "1890269299287441612",
      "in_reply_to_user_id": 44196397,
      "in_reply_to_user_id_str": "44196397",
      "in_reply_to_screen_name": "elonmusk",
      "user": {
        "id": 1837832148230733824,
        "id_str": "1837832148230733824",
        "name": "Brainey☓Genius✞✨🤍",
        "screen_name": "Braineygenius1",
        "location": "Now you see me",
        "url": "https:\/\/t.me\/braineygeniuss",
        "description": "(Daily Empowerment) The best you can see🤍GOD FIRST🤍 | Positive vibes only | Let’s have fun with #motivation $Crypto",
        "protected": false,
        "verified": false,
        "followers_count": 2081,
        "friends_count": 2836,
        "listed_count": 1,
        "favourites_count": 11569,
        "statuses_count": 12045,
        "created_at": "2024-09-22T12:32:47.000000Z",
        "profile_banner_url": "https:\/\/pbs.twimg.com\/profile_banners\/1837832148230733824\/1735860697",
        "profile_image_url_https": "https:\/\/pbs.twimg.com\/profile_images\/1847964293054054400\/QvCdMzEe_normal.jpg",
        "can_dm": true
      },
      "quoted_status_id": null,
      "quoted_status_id_str": null,
      "is_quote_status": false,
      "quoted_status": null,
      "retweeted_status": null,
      "quote_count": 0,
      "reply_count": 0,
      "retweet_count": 0,
      "favorite_count": 0,
      "views_count": 1,
      "bookmark_count": 0,
      "lang": "en",
      "entities": {
        "hashtags": [],
        "symbols": [],
        "timestamps": [],
        "urls": [],
        "user_mentions": [
          {
            "id_str": "44196397",
            "name": "Elon Musk",
            "screen_name": "elonmusk",
            "indices": [
              0,
              9
            ]
          }
        ]
      },
      "is_pinned": false
    }
  ]
}
```

--------------------------------

### Example response 200

Source: https://docs.socialdata.tools/monitoring/delete-monitor.md

Example successful response when the monitor is deleted.

```json
{
  "status": "success"
}
```

--------------------------------

### 200 OK Response for Creating User Following Monitor

Source: https://docs.socialdata.tools/monitoring/create-user-following-monitor.md

Example response for a successful request (HTTP 200) when creating a user following monitor. Shows the monitor object with its id, creation timestamp, monitor_type, status, webhook_url, and parameters including the target user's screen name, name, and id string.

```json
{
    "status": "success",
    "data": {
        "id": "01jm2569nf8jnn50zd8302vnpr",
        "created_at": "2025-02-14T11:58:33.000000Z",
        "monitor_type": "user_following",
        "status": "active",
        "webhook_url": null,
        "parameters": {
            "user_screen_name": "MarioNawfal",
            "user_name": "Mario Nawfal",
            "user_id_str": "1319287761048723458"
        }
    }
}
```

--------------------------------

### 200 Response JSON for Get User Likes

Source: https://docs.socialdata.tools/reference/get-user-likes.md

Example 200 response from the Get User Likes endpoint. Contains a next_cursor for pagination and a tweets array with tweet details such as tweet_created_at, id_str, full_text, user object, and engagement metrics.

```json
{
    "next_cursor": "DAACCgACGC12FhmAJxAKAAMYLXYWGX_Y8AgABAAAAAILAAUAAADoRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUJNWUxTNkQyQmFoUXhndFRReS9Ga0NOR0MwZG9yS1hzU2NZTFFwYm0xY1I0aGd0YmhZc1drQ3FHQzBjUXNSV1lSZ1lMVml5V3BxQU9CZ3RMbUhUV2tDb0dDMVFuVW1YMEFzWUxKYURhOVpob3hndFZtaklGakNNR0MxWGdlT1dZSE1ZTFRYNFNwZUEraGd0Y2h2bEYxRkxHQzFNMi83V1VGc1lMTTZwemhZQWt4Z3RWMkJKbDNGN0dDMWFGTXBYUUY4WUxUUERuRlp3UVE9PQgABgAAAAAIAAcAAAAADAAICgABGCyWg2vWYaMAAAA",
    "tweets": [
        {
            "tweet_created_at": "2023-12-13T05:39:09.000000Z",
            "id_str": "1734810168053956719",
            "text": null,
            "full_text": "@TeslaHype Pace of Progress",
            "source": "<a href=\"http:\/\/twitter.com\/download\/iphone\" rel=\"nofollow\">Twitter for iPhone<\/a>",
            "truncated": false,
            "in_reply_to_status_id_str": "1734777084268920960",
            "in_reply_to_user_id_str": "1311506622821400581",
            "in_reply_to_screen_name": "TeslaHype",
            "user": {
                "id_str": "44196397",
                "name": "Elon Musk",
                "screen_name": "elonmusk",
                "location": "\ud835\udd4f\u00d0",
                "url": null,
                "description": "",
                "protected": false,
                "verified": false,
                "followers_count": 166213349,
                "friends_count": 506,
                "listed_count": 149586,
                "favourites_count": 37958,
                "statuses_count": 34934,
                "created_at": "2009-06-02T20:12:29.000000Z",
                "profile_banner_url": "https:\/\/pbs.twimg.com\/profile_banners\/44196397\/1690621312",
                "profile_image_url_https": "https:\/\/pbs.twimg.com\/profile_images\/1683325380441128960\/yRsRRjGO_normal.jpg",
                "can_dm": false
            },
            "quoted_status_id_str": null,
            "is_quote_status": false,
            "quoted_status": null,
            "retweeted_status": null,
            "quote_count": 11,
            "reply_count": 156,
            "retweet_count": 78,
            "favorite_count": 977,
            "lang": "en",
            "entities": {
                "user_mentions": [
                    {
                        "id_str": "1311506622821400581",
                        "name": "Tesla Hype",
                        "screen_name": "TeslaHype",
                        "indices": [
                            0,
                            10
                        ]
                    }
                ],
                "urls": [],
                "hashtags": [],
                "symbols": []
            },
            "views_count": 32377,
            "bookmark_count": 19
        },
        {
            "tweet_created_at": "2023-12-13T05:38:26.000000Z",
            "id_str": "1734809984674693446",
            "text": null,
            "full_text": "@anammostarac Yeah",
            "source": "<a href=\"http:\/\/twitter.com\/download\/iphone\" rel=\"nofollow\">Twitter for iPhone<\/a>",
            "truncated": false,
            "in_reply_to_status_id_str": "1734809562258276654",
            "in_reply_to_user_id_str": "2852570664",
            "in_reply_to_screen_name": "anammostarac",
            "user": {
                "id_str": "44196397",
                "name": "Elon Musk",
                "screen_name": "elonmusk",
                "location": "\ud835\udd4f\u00d0",
                "url": null,
                "description": "",
                "protected": false,
                "verified": false,
                "followers_count": 166213349,
                "friends_count": 506,
                "listed_count": 149586,
                "favourites_count": 37958,
                "statuses_count": 34934,
                "created_at": "2009-06-02T20:12:29.000000Z",
                "profile_banner_url": "https:\/\/pbs.twimg.com\/profile_banners\/44196397\/1690621312",
                "profile_image_url_https": "https:\/\/pbs.twimg.com\/profile_images\/1683325380441128960\/yRsRRjGO_normal.jpg",
                "can_dm": false
            },
            "quoted_status_id_str": null,
            "is_quote_status": false,
            "quoted_status": null,
            "retweeted_status": null,
            "quote_count": 4,
            "reply_count": 64,
            "retweet_count": 30,
            "favorite_count": 513,
            "lang": "en",
            "entities": {
                "user_mentions": [
                    {
                        "id_str": "2852570664",
                        "name": "Ana Mostarac",
                        "screen_name": "anammostarac",
                        "indices": [
                            0,
                            13
                        ]
                    }
                ],
                "urls": [],
                "hashtags": [],
                "symbols": []
            },
            "views_count": 32377,
            "bookmark_count": 19
        }
    ]
}
```

--------------------------------

### Example Response: 200 OK

Source: https://docs.socialdata.tools/reference/get-community-details.md

Example response for a successful request (HTTP 200). Contains community details such as name, description, member count, and rules.

```json
{
  "id_str": "1493446837214187523",
  "created_at": "2022-02-15T04:47:27.551000Z",
  "name": "Build in Public",
  "description": "Share what you're working on. Get feedback. Help each other move forward. – Sponsors: @iamfra5er @freemius @RaulOnRails @indexsy @create_xyz",
  "creator_is_blue_verified": true,
  "creator_screen_name": "marckohlbrugge",
  "join_policy": "Open",
  "rules": [
    "Share what you're working on",
    "Screenshots, screencasts, drafts, etc",
    "No self-promotion",
    "Stay on-topic",
    "No engagement farming",
    "Use a personal account"
  ],
  "banner_url": "https:\/\/pbs.twimg.com\/community_banner_img\/1901004865490313216\/FVEYARpF?format=png&name=orig",
  "banner_width": 1200,
  "banner_height": 480,
  "member_count": 111247,
  "is_nsfw": false
}
```

--------------------------------

### Get user affiliates with PHP cURL

Source: https://docs.socialdata.tools/reference/get-user-affiliates.md

Use this PHP example to retrieve user affiliates using cURL. It sends a GET request with the Authorization header and prints the decoded response. Replace API_KEY with your SocialData API key.

```php
$userId = '783214';
$API_KEY = 'YOUR_API_KEY_HERE';

$url = "https://api.socialdata.tools/twitter/user/{$userId}/affiliates";

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $API_KEY",
        "Accept: application/json"
    ]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);

curl_close($ch);
```

--------------------------------

### Search Query Example

Source: https://docs.socialdata.tools/reference/get-search-results.md

Demonstrates how to combine search operators within the query parameter to filter by user and timestamp.

```text
keyword from:elonmusk since_time:1738381166
```

--------------------------------

### Get Tweet Quotes with JavaScript fetch

Source: https://docs.socialdata.tools/reference/get-tweet-quotes.md

JavaScript example using fetch to get tweet quotes. Store the tweet ID as a string because it may exceed JavaScript's default integer limit. Replace YOUR_API_KEY_HERE with your API key.

```js
const tweetId = '1890269299287441612';
const API_KEY = 'YOUR_API_KEY_HERE';

fetch(`https://api.socialdata.tools/twitter/tweets/${tweetId}/quotes`, {
    method: 'GET',
    headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Accept': 'application/json'
    }
})
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
```

--------------------------------

### Create User Following Monitor with JavaScript

Source: https://docs.socialdata.tools/monitoring/create-user-following-monitor.md

Use the fetch API to send a POST request to the monitor endpoint.

```js
const API_KEY = 'YOUR_API_KEY_HERE';
const userId = 1493446837214187523;

fetch('https://api.socialdata.tools/monitors/user-following', {
    method: 'POST',
    headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json',
        'Accept': 'application/json'
    },
    body: JSON.stringify({ user_id: userId })
})
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
```

--------------------------------

### 200 OK Response for Creating Search Query Monitor

Source: https://docs.socialdata.tools/monitoring/create-search-query-monitor.md

Example successful response when creating a search query monitor. Returns monitor details including id, monitor_type, status, webhook_url, parameters, and refresh_frequency.

```json
{
    "status": "success",
    "data": {
        "id": "01jqty3m3dhg9xpsj373x12ck7",
        "created_at": "2025-04-02T09:42:51.000000Z",
        "monitor_type": "search_keyword",
        "status": "active",
        "webhook_url": "...",
        "parameters": {
            "query": "from:elonmusk"
        },
        "refresh_frequency": "30"
    }
}
```

--------------------------------

### Sample response with tweet data

Source: https://docs.socialdata.tools/reference/get-article-v2.md

Example response from the Get Article v2 endpoint containing tweet details such as user profile, media, entities, and markdown content.

```json
{
    "profile_image_url_https": "https://pbs.twimg.com/profile_images/1719446730091962368/Bl01sQsB_normal.png",
    "can_dm": false,
    "affiliation_label": null,
    "verification_info": {
      "type": "Business"
    }
  },
  "quoted_status_id": null,
  "quoted_status_id_str": null,
  "is_quote_status": false,
  "quoted_status": null,
  "retweeted_status": null,
  "quote_count": 12,
  "reply_count": 73,
  "retweet_count": 133,
  "favorite_count": 573,
  "views_count": 39649,
  "bookmark_count": 17,
  "lang": "en",
  "entities": {
    "media": [
      {
        "display_url": "pic.x.com/6uMmARTRRj",
        "expanded_url": "https://x.com/circle/status/2069043150891663371/photo/1",
        "ext_media_availability": {
          "status": "Available"
        },
        "features": {
          "large": {
            "faces": []
          },
          "medium": {
            "faces": []
          },
          "orig": {
            "faces": []
          },
          "small": {
            "faces": []
          }
        },
        "id_str": "2069043147724959744",
        "indices": [
          277,
          300
        ],
        "media_key": "3_2069043147724959744",
        "media_results": {
          "result": {
            "media_key": "3_2069043147724959744"
          }
        },
        "media_url_https": "https://pbs.twimg.com/media/HLa3x9UaMAA9Jpa.jpg",
        "original_info": {
          "focus_rects": [
            {
              "h": 630,
              "w": 1125,
              "x": 0,
              "y": 0
            },
            {
              "h": 630,
              "w": 630,
              "x": 0,
              "y": 0
            },
            {
              "h": 630,
              "w": 553,
              "x": 0,
              "y": 0
            },
            {
              "h": 630,
              "w": 315,
              "x": 53,
              "y": 0
            },
            {
              "h": 630,
              "w": 1200,
              "x": 0,
              "y": 0
            }
          ],
          "height": 630,
          "width": 1200
        },
        "sizes": {
          "large": {
            "h": 630,
            "resize": "fit",
            "w": 1200
          },
          "medium": {
            "h": 630,
            "resize": "fit",
            "w": 1200
          },
          "small": {
            "h": 357,
            "resize": "fit",
            "w": 680
          },
          "thumb": {
            "h": 150,
            "resize": "crop",
            "w": 150
          }
        },
        "type": "photo",
        "url": "https://t.co/6uMmARTRRj"
      }
    ],
    "user_mentions": [
      {
        "id_str": "1411867326828335107",
        "indices": [
          47,
          57
        ],
        "name": "Cronos",
        "screen_name": "Cronosapp"
      },
      {
        "id_str": "1819490209643270144",
        "indices": [
          248,
          253
        ],
        "name": "USDC",
        "screen_name": "USDC"
      }
    ],
    "hashtags": [],
    "symbols": [],
    "urls": [
      {
        "display_url": "circle.com/blog/usdc-eurc…",
        "expanded_url": "http://www.circle.com/blog/usdc-eurc-and-cctp-are-coming-soon-to-cronos-what-you-need-to-know",
        "indices": [
          704,
          727
        ],
        "url": "https://t.co/oAx2yQBW2K"
      }
    ],
    "display_text_range": [
      0,
      276
    ]
  },
  "is_pinned": false,
  "article": null,
  "markdown": "Native USDC, EURC, and CCTP are coming soon to [@Cronosapp](https://x.com/Cronosapp).\n\nWe’re bringing the leading stablecoins, CCTP, and Circle Mint to Cronos to power prediction markets, trading, payments, treasury management, and agentic workflows.\n\nKey benefits of native [@USDC](https://x.com/USDC) and EURC:\n→ Redeem 1:1 for USD and EUR, respectively\n→ MiCA-compliant and fully reserved\n→ Integrate seamlessly with Cronos apps and DeFi protocols\n→ Unlock dollar- and euro-denominated crosschain infrastructure on Cronos\n\nCCTP enables smooth USDC crosschain transfers without third-party bridges while Circle Mint adds institutional access to fiat on/offramps, deposits, withdrawals, transfers, and API connectivity for eligible users.\n\nLearn more:\n[circle.com/blog/usdc-eurc…](http://www.circle.com/blog/usdc-eurc-and-cctp-are-coming-soon-to-cronos-what-you-need-to-know)",
  "markdown_source": "tweet_text"
}
```

--------------------------------

### Create User Profile Monitor with PHP cURL

Source: https://docs.socialdata.tools/monitoring/create-user-profile-monitor.md

Use this PHP cURL example to create a user profile monitor. It initializes a cURL session, sets the POST fields and headers, executes the request, and prints the decoded response. Replace YOUR_API_KEY_HERE with your actual API key.

```php
$API_KEY = 'YOUR_API_KEY_HERE';
$user_id = 1493446837214187523;

$url = "https://api.socialdata.tools/monitors/user-profile";

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(['user_id' => $user_id]),
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $API_KEY",
        "Content-Type: application/json",
        "Accept: application/json"
    ]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);

curl_close($ch);
```

--------------------------------

### Create User Following Monitor with Python

Source: https://docs.socialdata.tools/monitoring/create-user-following-monitor.md

Use the requests library to create a monitor, including error handling for the response.

```python
import requests

API_KEY = 'YOUR_API_KEY_HERE'
user_id = 1493446837214187523

url = 'https://api.socialdata.tools/monitors/user-following'

headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Content-Type': 'application/json',
    'Accept': 'application/json'
}

payload = {'user_id': user_id}

response = requests.post(url, json=payload, headers=headers)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Error: {response.status_code}")
    print(response.text)
```

--------------------------------

### JavaScript: Get Twitter Community Details

Source: https://docs.socialdata.tools/reference/get-community-details.md

Use this JavaScript fetch example to retrieve community details. Replace YOUR_API_KEY_HERE with your API key. The response is logged to the console.

```javascript
const communityId = '1493446837214187523';
const API_KEY = 'YOUR_API_KEY_HERE';

fetch(`https://api.socialdata.tools/twitter/community/${communityId}`, {
    method: 'GET',
    headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Accept': 'application/json'
    }
})
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
```

--------------------------------

### PHP: Get Tweet Comments

Source: https://docs.socialdata.tools/reference/get-tweet-comments.md

Use this PHP cURL example to retrieve comments for a tweet. Replace YOUR_API_KEY_HERE with your API key. The script prints the decoded JSON response.

```php
$tweet_id = '1890269299287441612';
$API_KEY = 'YOUR_API_KEY_HERE';

$url = "https://api.socialdata.tools/twitter/tweets/{$tweet_id}/comments";

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $API_KEY",
        "Accept: application/json"
    ]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);

curl_close($ch);
```

--------------------------------

### Create User Profile Monitor - 404 User Not Found

Source: https://docs.socialdata.tools/monitoring/create-user-profile-monitor.md

Example of a 404 error response. Indicates that the specified user could not be found.

```json
{
    "status": "error",
    "message": "User not found"
}
```

--------------------------------

### JavaScript fetch to get list members

Source: https://docs.socialdata.tools/reference/get-list-members.md

Use this JavaScript example to call the API. Note that list_id is stored as a string to avoid integer overflow. Replace API_KEY with your key.

```javascript
const listId = '1625802236571033602';
const API_KEY = 'YOUR_API_KEY_HERE';

fetch(`https://api.socialdata.tools/twitter/list/${listId}/members`, {
    method: 'GET',
    headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Accept': 'application/json'
    }
})
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
```

--------------------------------

### PHP: Get Twitter Community Details

Source: https://docs.socialdata.tools/reference/get-community-details.md

Use this PHP cURL example to retrieve community details. Replace YOUR_API_KEY_HERE with your API key. Prints the decoded JSON response.

```php
$communityId = '1493446837214187523';
$API_KEY = 'YOUR_API_KEY_HERE';

$url = "https://api.socialdata.tools/twitter/community/{$communityId}";

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $API_KEY",
        "Accept: application/json"
    ]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);

curl_close($ch);
```

--------------------------------

### JavaScript: List monitors with fetch

Source: https://docs.socialdata.tools/monitoring/list-active-monitors.md

Use this JavaScript code to list monitors using the fetch API. Replace YOUR_API_KEY_HERE with your actual API key. The response is logged to the console.

```js
const API_KEY = 'YOUR_API_KEY_HERE';

fetch('https://api.socialdata.tools/monitors', {
    method: 'GET',
    headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Accept': 'application/json'
    }
})
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
```

--------------------------------

### Get Twitter User Followers with PHP cURL

Source: https://docs.socialdata.tools/reference/get-user-followers.md

Use this PHP example with cURL to fetch followers. It decodes the JSON response and prints it with print_r. Replace YOUR_API_KEY_HERE with your API key.

```php
$userId = '44196397';
$API_KEY = 'YOUR_API_KEY_HERE';

$url = "https://api.socialdata.tools/twitter/user/{$userId}/followers";

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $API_KEY",
        "Accept: application/json"
    ]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);

curl_close($ch);
```

--------------------------------

### Create User Following Monitor with PHP

Source: https://docs.socialdata.tools/monitoring/create-user-following-monitor.md

Use the cURL extension in PHP to perform the POST request.

```php
$API_KEY = 'YOUR_API_KEY_HERE';
$user_id = 1493446837214187523;

$url = "https://api.socialdata.tools/monitors/user-following";

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(['user_id' => $user_id]),
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $API_KEY",
        "Content-Type: application/json",
        "Accept: application/json"
    ]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);

curl_close($ch);
```

--------------------------------

### PHP: Get Twitter List Details

Source: https://docs.socialdata.tools/reference/get-list-details.md

Use this PHP cURL example to retrieve list details. Replace YOUR_API_KEY_HERE with your API key. The script prints the decoded JSON response.

```php
$listId = '1625802236571033602';
$API_KEY = 'YOUR_API_KEY_HERE';

$url = "https://api.socialdata.tools/twitter/list/{$listId}";

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $API_KEY",
        "Accept: application/json"
    ]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);

curl_close($ch);
```

--------------------------------

### Cursor configuration (.cursor/mcp.json)

Source: https://docs.socialdata.tools/mcp/connecting

Create or edit .cursor/mcp.json in your project (or ~/.cursor/mcp.json for global availability). Replace YOUR_API_KEY with your actual API key.

```json
{
  "mcpServers": {
    "socialdata": {
      "url": "https://api.socialdata.tools/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

--------------------------------

### Python: Get Tweet Comments

Source: https://docs.socialdata.tools/reference/get-tweet-comments.md

Use this Python requests example to retrieve comments for a tweet. Replace YOUR_API_KEY_HERE with your API key. The script prints the JSON response or an error message.

```python
import requests

tweet_id = '1890269299287441612'
API_KEY = 'YOUR_API_KEY_HERE'

url = f'https://api.socialdata.tools/twitter/tweets/{tweet_id}/comments'

headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Accept': 'application/json'
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Error: {response.status_code}")
    print(response.text)
```

--------------------------------

### Create Search Query Monitor with Python

Source: https://docs.socialdata.tools/monitoring/create-search-query-monitor.md

Use the requests library to create a search query monitor in Python.

```python
import requests

API_KEY = 'YOUR_API_KEY_HERE'

url = 'https://api.socialdata.tools/monitors/search-query'

headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Content-Type': 'application/json',
    'Accept': 'application/json'
}

payload = {
    'refresh_frequency': 30,
    'query': 'from:elonmusk'
}

response = requests.post(url, headers=headers, json=payload)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Error: {response.status_code}")
    print(response.text)
```

--------------------------------

### Get Tweet Quotes with PHP cURL

Source: https://docs.socialdata.tools/reference/get-tweet-quotes.md

PHP example using cURL to fetch tweet quotes. Decodes the JSON response and prints it with print_r. Replace YOUR_API_KEY_HERE with your API key.

```php
$tweet_id = '1890269299287441612';
$API_KEY = 'YOUR_API_KEY_HERE';

$url = "https://api.socialdata.tools/twitter/tweets/{$tweet_id}/quotes";

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $API_KEY",
        "Accept: application/json"
    ]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);

curl_close($ch);
```

--------------------------------

### Get List Tweets with PHP cURL

Source: https://docs.socialdata.tools/reference/get-list-tweets.md

Use this PHP example with cURL to retrieve list tweets. It decodes the JSON response and prints it with print_r. Replace YOUR_API_KEY_HERE with your API key.

```php
$list_id = '1625802236571033602';
$API_KEY = 'YOUR_API_KEY_HERE';

$url = "https://api.socialdata.tools/twitter/list/{$list_id}/tweets";

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $API_KEY",
        "Accept: application/json"
    ]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);

curl_close($ch);
```
Tokens:
Raw