Skip to main content
GET
/
v1
/
users
/
by
/
username
/
{username}
curl --request GET \
  --url https://api.corebot.app/v1/users/by/username/elonmusk \
  --header 'X-API-Key: your_api_key_here'
{
  "id": "44196397",
  "username": "elonmusk",
  "name": "Elon Musk",
  "description": "CEO of SpaceX and Tesla",
  "profile_image_url": "https://pbs.twimg.com/profile_images/123/456_normal.jpg",
  "profile_banner_url": "https://pbs.twimg.com/profile_banners/44196397/123456789",
  "followers_count": 170234567,
  "following_count": 543,
  "tweet_count": 28943,
  "listed_count": 100000,
  "verified": true,
  "created_at": "Tue Jun 02 20:12:29 +0000 2009",
  "location": "Texas",
  "url": "https://t.co/abc123",
  "protected": false,
  "pinned_tweet_ids": ["1234567890"]
}

Request

username
string
required
The username of the user (without @ symbol)

Headers

X-API-Key
string
required
Your API key for authentication

Response

id
string
User ID as string
username
string
Username without @ symbol
name
string
Display name of the user
description
string
User’s bio/description
profile_image_url
string
URL to profile picture
profile_banner_url
string
URL to profile banner
followers_count
number
Number of followers
following_count
number
Number of users they follow
tweet_count
number
Total number of tweets
listed_count
number
Number of lists the user is on
verified
boolean
Whether the account is verified
created_at
string
Account creation date
location
string
User’s location
url
string
User’s website URL
protected
boolean
Whether tweets are protected
pinned_tweet_ids
array
Array of pinned tweet IDs
curl --request GET \
  --url https://api.corebot.app/v1/users/by/username/elonmusk \
  --header 'X-API-Key: your_api_key_here'
{
  "id": "44196397",
  "username": "elonmusk",
  "name": "Elon Musk",
  "description": "CEO of SpaceX and Tesla",
  "profile_image_url": "https://pbs.twimg.com/profile_images/123/456_normal.jpg",
  "profile_banner_url": "https://pbs.twimg.com/profile_banners/44196397/123456789",
  "followers_count": 170234567,
  "following_count": 543,
  "tweet_count": 28943,
  "listed_count": 100000,
  "verified": true,
  "created_at": "Tue Jun 02 20:12:29 +0000 2009",
  "location": "Texas",
  "url": "https://t.co/abc123",
  "protected": false,
  "pinned_tweet_ids": ["1234567890"]
}