Retrieve a Twitter user profile and top-level account metadata by handle. Includes bio, follower/following counts, join date, and verification status.

POST /user-profile-details Profile

https://api.fetchlayer.dev/twitter/user-profile-details

OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

handle string required

Twitter handle without @.

Response Fields

user-profile-details

Fetch a user profile by handle

handle string

Twitter handle.

displayName string

Display name.

description string

Bio text.

isVerified boolean

Verification status.

followersCount number

Follower count.

followingCount number

Following count.

tweetsCount number

Total tweet count.

joinedAt string

Account creation timestamp (ISO 8601).

location string

Profile location (optional).

website string

Profile website URL (optional).

avatarUrl string

Profile image URL.

bannerUrl string

Header banner URL (optional).

Request

curl -X POST "https://api.fetchlayer.dev/twitter/user-profile-details" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"handle":"openai"}'

import { FetchLayer } from '@fetchlayer/twitter';

const client = new FetchLayer({ apiKey: 'ss-your-key' });

const result = await client.userProfileDetails({
  "handle": "openai"
});

Response

{
  "handle": "OpenAI",
  "displayName": "OpenAI",
  "description": "AI research and deployment company. Creators of ChatGPT, GPT-4, DALL·E, and Sora.",
  "isVerified": true,
  "followersCount": 4300000,
  "followingCount": 82,
  "tweetsCount": 3400,
  "joinedAt": "2015-12-11T00:00:00.000Z",
  "location": "San Francisco, CA",
  "website": "https://openai.com",
  "avatarUrl": "https://pbs.twimg.com/profile_images/openai_normal.jpg",
  "bannerUrl": "https://pbs.twimg.com/profile_banners/openai_header.jpg"
}

{
  "error": "Invalid API key"
}