Skip to main content
GET
/
v1
/
results
Get Results
curl --request GET \
  --url https://api.lobstr.io/v1/results \
  --header 'Authorization: <authorization>'
{
  "internal_unique_id": "<string>",
  "user_id": "<string>",
  "name": "<string>",
  "screen_name": "<string>",
  "profile_url": "<string>",
  "bio": "<string>",
  "location": "<string>",
  "website": "<string>",
  "followers_count": 123,
  "following_count": 123,
  "tweets_count": 123,
  "media_count": 123,
  "likes_count": 123,
  "listed_count": 123,
  "created_at": {},
  "profile_image_url": "<string>",
  "profile_banner_url": "<string>",
  "is_blue_verified": true,
  "is_verified": true,
  "is_protected": true,
  "possibly_sensitive": true,
  "profile_image_shape": "<string>",
  "professional_type": "<string>",
  "professional_category": "<string>",
  "relationship_type": "<string>",
  "_json": "<any>"
}
Retrieve scraped data from your Twitter Followers & Following Scraper runs.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY

​
Query Parameters

​
squid
string
required
Hash of the squid to get results from
​
run
string
Hash of a specific run (optional)
​
page
integer
Page number (default: 1). Example: 1

​
Result Fields

Each result object contains the following fields:
​
internal_unique_id
string
Unique identifier combining user_id and relationship_type. Example: 769922298715537408_following
​
user_id
string
Unique Twitter/X identifier for the account. Example: 769922298715537408
​
name
string
Display name of the Twitter/X account. Example: Elon Musk
​
screen_name
string
Twitter/X handle of the account (without the @ symbol). Example: elonmusk
​
profile_url
string
Direct URL to the Twitter/X profile. Example: https://x.com/elonmusk
​
bio
string
Profile bio/description text. Example: Tech entrepreneur
​
location
string
Location shown on the Twitter/X profile. Example: San Francisco, CA
​
website
string
Website URL linked on the Twitter/X profile. Example: https://example.com
​
followers_count
integer
Total number of followers of this Twitter/X account. Example: 180000000
​
following_count
integer
Total number of accounts this profile follows. Example: 500
​
tweets_count
integer
Total number of tweets/posts published by this account. Example: 50000
​
media_count
integer
Total number of media items (photos and videos) posted by this account. Example: 1200
​
likes_count
integer
Total number of tweets this account has liked. Example: 30000
​
listed_count
integer
Number of public Twitter/X lists this account is included in. Example: 5000
​
created_at
datetime
Date the Twitter/X account was created. Example: 2016-08-24T10:00:00+00:00
​
profile_image_url
string
URL of the account’s profile picture. Example: https://pbs.twimg.com/profile_images/12345/photo_normal.jpg
​
profile_banner_url
string
URL of the account’s profile banner/header image. Example: https://pbs.twimg.com/profile_banners/12345/1234567890
​
is_blue_verified
boolean
Whether the account has a Twitter Blue (X Premium) verified checkmark. Example: false
​
is_verified
boolean
Whether the account has a legacy verified checkmark. Example: false
​
is_protected
boolean
Whether the account’s tweets are protected (private). Example: false
​
possibly_sensitive
boolean
Whether the account’s content is flagged as possibly sensitive. Example: false
​
profile_image_shape
string
Shape of the profile image displayed on Twitter/X (e.g. Circle, Square). Example: Circle
​
professional_type
string
Professional account type (e.g. Creator, Business). Example: Creator
​
professional_category
string
Professional category label shown on the profile. Example: Author
​
relationship_type
string
Whether this user is a ‘follower’ or ‘following’ of the scraped account. Example: following
​
_json
json
Raw JSON user data returned by the Twitter/X API