Profile fields, tags and categories of a single account

GET https://twitterscore.io/api/v1/get_twitter_info

Resolves the account exactly like get_twitter_score (by username or twitter_id, with slug, previous-username and scored-twin fallbacks) and returns its profile fields plus TwitterScore's manual classification: tags (fine-grained labels such as a specific VC, ecosystem or sector) and categories (the coarse account type such as Founders, Projects, Venture Capitals). Tags and categories exist only on curated accounts (Account); for accounts known solely from the follower graph (Friend) both arrays are empty. The response does not include the Twitter Score or the twitter_id — use get_twitter_score for those.

Required: one of username, twitter_id. Nested fields

tags[].tag_id (integer): Tag id; matches tags[].id from get_tags.
tags[].tag_name (string): Tag name.
categories[].category_id (integer): Category id; matches categories[].id from get_categories.
categories[].category_name (string): Category name.

Parameters

Parameter	Type	Required	Default	Description
`username`	string	no		X/Twitter handle without the leading @ (whitespace/slashes stripped). Also matches the profile slug and previous handles of renamed accounts.
`twitter_id`	integer	no		Numeric X/Twitter user id. Tried before `username` when both are given.

At least one of username, twitter_id is required.

Example request

curl -s "https://twitterscore.io/api/v1/get_twitter_info?username=VitalikButerin" \
  -H "X-API-Key: $TWITTERSCORE_API_KEY" \
  -H "User-Agent: my-app/1.0 ([email protected])"

import os, requests

r = requests.get(
    "https://twitterscore.io/api/v1/get_twitter_info",
    params={"username": "VitalikButerin"},
    headers={"X-API-Key": os.environ["TWITTERSCORE_API_KEY"],
             "User-Agent": "my-app/1.0 ([email protected])"},
    timeout=15,
)
data = r.json()
if not data.get("success", True):      # errors arrive as success=false (see /developers/errors/)
    raise RuntimeError(data["message"])
print(data)

const r = await fetch("https://twitterscore.io/api/v1/get_twitter_info?username=VitalikButerin", {
  headers: { "X-API-Key": process.env.TWITTERSCORE_API_KEY,
             "User-Agent": "my-app/1.0 ([email protected])" },
});
const data = await r.json();
if (data.success === false) throw new Error(data.message);
console.log(data);

Example response

{
  "success": true,
  "username": "VitalikButerin",
  "name": "vitalik.eth",
  "description": "mi pinxe lo crino tcati",
  "followers_count": 5689412,
  "profile_image": "https://twitterscore-media.s3.amazonaws.com/profiles/VitalikButerin.jpg",
  "tags": [
    {
      "tag_id": 6,
      "tag_name": "Ethereum"
    }
  ],
  "categories": [
    {
      "category_id": 2,
      "category_name": "Founders"
    },
    {
      "category_id": 8,
      "category_name": "Influencers"
    }
  ]
}

Errors

Error codes this endpoint can return (see Errors for the body format): api_key_missing, api_key_invalid, api_access_deactivated, api_key_revoked, invalid_params, account_not_found, method_not_allowed, rate_limited, quota_exceeded, server_error.

Authentication: X-API-Key header (or Authorization: Bearer), see Authentication. Limits: per-minute rate and monthly quota by plan, see Rate limits. Machine-readable definition: /openapi.json.

This page as Markdown.