X Verified Followers API
curl --request POST \
--url https://api.socq.ai/v1/x/verified-followers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"usernames": [
"<string>"
],
"callback_url": "<string>",
"results_limit": 100
}
'import requests
url = "https://api.socq.ai/v1/x/verified-followers"
payload = {
"usernames": ["<string>"],
"callback_url": "<string>",
"results_limit": 100
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({usernames: ['<string>'], callback_url: '<string>', results_limit: 100})
};
fetch('https://api.socq.ai/v1/x/verified-followers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/x/verified-followers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'usernames' => [
'<string>'
],
'callback_url' => '<string>',
'results_limit' => 100
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/x/verified-followers"
payload := strings.NewReader("{\n \"usernames\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\",\n \"results_limit\": 100\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/x/verified-followers")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"usernames\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\",\n \"results_limit\": 100\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/x/verified-followers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"usernames\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\",\n \"results_limit\": 100\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}X
X Verified Followers
Collect the verified accounts that follow an X account.
POST
/
v1
/
x
/
verified-followers
X Verified Followers API
curl --request POST \
--url https://api.socq.ai/v1/x/verified-followers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"usernames": [
"<string>"
],
"callback_url": "<string>",
"results_limit": 100
}
'import requests
url = "https://api.socq.ai/v1/x/verified-followers"
payload = {
"usernames": ["<string>"],
"callback_url": "<string>",
"results_limit": 100
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({usernames: ['<string>'], callback_url: '<string>', results_limit: 100})
};
fetch('https://api.socq.ai/v1/x/verified-followers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/x/verified-followers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'usernames' => [
'<string>'
],
'callback_url' => '<string>',
'results_limit' => 100
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/x/verified-followers"
payload := strings.NewReader("{\n \"usernames\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\",\n \"results_limit\": 100\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/x/verified-followers")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"usernames\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\",\n \"results_limit\": 100\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/x/verified-followers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"usernames\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\",\n \"results_limit\": 100\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}X Verified Followers
Collect the followers of an X account that carry a verified checkmark, the same list X shows under the Verified Followers tab. Every row is a verified account with its ID, username, display name, profile link, avatar and join date, linked back to the account you asked about. Use it to see which creators, brands and paying users already follow a profile, to size the influential part of an audience, or to build an outreach list from the people who pay attention to a competitor.{
"usernames": [
"NASA"
],
"results_limit": 20
}
Standard Result Fields
Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, usefields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | Yes | Unique identifier for this result item. |
platform | string | No | Platform the result belongs to, such as instagram or linkedin. |
resource | string | No | SocQ resource represented by the result, such as videos or comments. |
type | string | No | Category of the result item, such as video, post, or comment. |
url | string | Yes | Public URL of the result item when available. |
published_at | string | Yes | Time the source item was published, in ISO 8601 format when available. |
collected_at | string | No | Time SocQ collected or processed this result, in ISO 8601 format. |
actor | object | Yes | Account at the primary side of the relationship. |
actor.id | string | Yes | Unique identifier of the primary account. |
actor.username | string | Yes | Public username or handle of the account. |
actor.name | string | Yes | Display name of the primary account. |
actor.url | string | Yes | Public URL of the primary account when available. |
actor.avatar_url | string | Yes | URL of the account avatar image. |
actor.is_verified | boolean | Yes | Whether the account is verified on the platform. |
actor.is_private | boolean | Yes | Whether the account is private. |
related_actor | object | Yes | Account related to the primary account. |
related_actor.id | string | Yes | Unique identifier of the related account. |
related_actor.username | string | Yes | Public username or handle of the account. |
related_actor.name | string | Yes | Display name of the related account. |
related_actor.url | string | Yes | Public URL of the related account when available. |
related_actor.avatar_url | string | Yes | URL of the account avatar image. |
related_actor.is_verified | boolean | Yes | Whether the account is verified on the platform. |
related_actor.is_private | boolean | Yes | Whether the account is private. |
relationship | string | Yes | Relationship represented by the item, such as follower, following, or retweeter. |
Completed Task Response
{
"code": 200,
"data": {
"task_id": "example-x-verified-followers",
"status": "succeeded",
"public_id": "x/verified-followers",
"result_count": 2,
"credits_amount": 1.4,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "relationship",
"schema_version": "1.0",
"items": [
{
"id": "1700000000000000001",
"platform": "x",
"resource": "verified-followers",
"type": "profile",
"url": "https://x.com/orbit_watcher",
"published_at": "2023-01-30T21:50:16Z",
"collected_at": "2026-11-13T10:15:28Z",
"actor": {
"id": null,
"username": "NASA",
"name": "NASA",
"url": null,
"avatar_url": null,
"is_verified": null,
"is_private": null
},
"related_actor": {
"id": "1700000000000000001",
"username": "orbit_watcher",
"name": "Orbit Watcher",
"url": "https://x.com/orbit_watcher",
"avatar_url": "https://pbs.twimg.com/profile_images/1700000000000000001/avatar_normal.jpg",
"is_verified": true,
"is_private": null
},
"relationship": "follower"
},
{
"id": "1700000000000000002",
"platform": "x",
"resource": "verified-followers",
"type": "profile",
"url": "https://x.com/launchday_notes",
"published_at": "2022-10-30T07:19:04Z",
"collected_at": "2026-11-13T10:15:28Z",
"actor": {
"id": null,
"username": "NASA",
"name": "NASA",
"url": null,
"avatar_url": null,
"is_verified": null,
"is_private": null
},
"related_actor": {
"id": "1700000000000000002",
"username": "launchday_notes",
"name": "Launch Day Notes",
"url": "https://x.com/launchday_notes",
"avatar_url": "https://pbs.twimg.com/profile_images/1700000000000000002/avatar_normal.jpg",
"is_verified": true,
"is_private": null
},
"relationship": "follower"
}
]
}
}
}
Authorizations
bearerAuthapiKeyAuth
Body
application/json
Provide X usernames in usernames. results_limit applies to each account, defaults to 100, and must be a multiple of 20 between 20 and 2000.

