List of account categories

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

Returns TwitterScore's account categories — the coarse classification of an account (Venture Capitals, Founders, Projects, Exchanges, Auditors, Media, Influencers, Angels) — ordered by id. These ids are the category_id values returned by get_twitter_info. The list is small and static; it is paginated with page/size (default 10, max 25). There are no filter parameters. Nested fields

categories[].id (integer): Category id (matches category_id in get_twitter_info).
categories[].name (string): Category name.

Parameters

Parameter	Type	Required	Default	Description
`page`	integer	no	`1`	1-based page number. Non-integer or 0 falls back to 1, negatives are floored to 1; a page past the end returns an empty list with the same total/pages.
`size`	integer	no	`10`	Items per page; values above 25 are capped to 25, non-integer values fall back to 10, values below 1 are floored to 1.

Example request

curl -s "https://twitterscore.io/api/v1/get_categories?page=1" \
  -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_categories",
    params={"page": 1},
    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_categories?page=1", {
  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,
  "total": 8,
  "page": 1,
  "size": 8,
  "pages": 1,
  "categories": [
    {
      "id": 1,
      "name": "Venture Capitals"
    },
    {
      "id": 2,
      "name": "Founders"
    },
    {
      "id": 3,
      "name": "Projects"
    },
    {
      "id": 4,
      "name": "Exchanges"
    },
    {
      "id": 5,
      "name": "Auditors"
    },
    {
      "id": 7,
      "name": "Media"
    },
    {
      "id": 8,
      "name": "Influencers"
    },
    {
      "id": 9,
      "name": "Angels"
    }
  ]
}

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, 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.