Skip to content
Examples

Get Results

Retrieve scraped data from Twitter Followers & Following Scraper

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your Twitter Followers & Following Scraper runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

runstringquery

Hash of a specific run (optional)

pageintegerquery

Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:

internal_unique_idstring

Unique identifier combining user_id and relationship_type. Example: 769922298715537408_following

user_idstring

Unique Twitter/X identifier for the account. Example: 769922298715537408

namestring

Display name of the Twitter/X account. Example: Elon Musk

screen_namestring

Twitter/X handle of the account (without the @ symbol). Example: elonmusk

profile_urlstring

Direct URL to the Twitter/X profile. Example: https://x.com/elonmusk

biostring

Profile bio/description text. Example: Tech entrepreneur

locationstring

Location shown on the Twitter/X profile. Example: San Francisco, CA

websitestring

Website URL linked on the Twitter/X profile. Example: https://example.com

followers_countinteger

Total number of followers of this Twitter/X account. Example: 180000000

following_countinteger

Total number of accounts this profile follows. Example: 500

tweets_countinteger

Total number of tweets/posts published by this account. Example: 50000

media_countinteger

Total number of media items (photos and videos) posted by this account. Example: 1200

likes_countinteger

Total number of tweets this account has liked. Example: 30000

listed_countinteger

Number of public Twitter/X lists this account is included in. Example: 5000

created_atdatetime

Date the Twitter/X account was created. Example: 2016-08-24T10:00:00+00:00

profile_image_urlstring

URL of the account's profile picture. Example: https://pbs.twimg.com/profile_images/12345/photo_normal.jpg

profile_banner_urlstring

URL of the account's profile banner/header image. Example: https://pbs.twimg.com/profile_banners/12345/1234567890

is_blue_verifiedboolean

Whether the account has a Twitter Blue (X Premium) verified checkmark. Example: false

is_verifiedboolean

Whether the account has a legacy verified checkmark. Example: false

is_protectedboolean

Whether the account's tweets are protected (private). Example: false

possibly_sensitiveboolean

Whether the account's content is flagged as possibly sensitive. Example: false

profile_image_shapestring

Shape of the profile image displayed on Twitter/X (e.g. Circle, Square). Example: Circle

professional_typestring

Professional account type (e.g. Creator, Business). Example: Creator

professional_categorystring

Professional category label shown on the profile. Example: Author

relationship_typestring

Whether this user is a 'follower' or 'following' of the scraped account. Example: following

_jsonjson

Raw JSON user data returned by the Twitter/X API

Response

200
{
  "total_results": 1,
  "limit": 50,
  "page": 1,
  "total_pages": 1,
  "result_from": 1,
  "result_to": 1,
  "data": [
    {
      "id": 55956,
      "object": "result",
      "squid": "8f10fa2b9b3429006afaecebd572624f",
      "run": "d5316f954b21c55e87579ac984497a1f",
      "internal_unique_id": "769922298715537408_following",
      "user_id": "769922298715537408",
      "name": "Elon Musk",
      "screen_name": "elonmusk",
      "profile_url": "https://x.com/elonmusk",
      "bio": "Tech entrepreneur",
      "location": "San Francisco, CA",
      "website": "https://example.com",
      "followers_count": 180000000,
      "following_count": 500,
      "tweets_count": 50000,
      "media_count": 1200,
      "likes_count": 30000,
      "listed_count": 5000,
      "created_at": "2016-08-24T10:00:00+00:00",
      "profile_image_url": "https://pbs.twimg.com/profile_images/12345/photo_normal.jpg",
      "profile_banner_url": "https://pbs.twimg.com/profile_banners/12345/1234567890",
      "is_blue_verified": false,
      "is_verified": false,
      "is_protected": false,
      "possibly_sensitive": false,
      "profile_image_shape": "Circle",
      "professional_type": "Creator",
      "professional_category": "Author",
      "relationship_type": "following",
      "_json": null,
      "functions": null,
      "native_id": 55956
    }
  ],
  "next": null,
  "previous": null
}