# List of account tags with their tag categories

`GET https://twitterscore.io/api/v1/get_tags`

Returns TwitterScore's fine-grained account tags (e.g. a16z, Coinbase Ventures, Paradigm, Binance, Solana, Ethereum, NFT) together with the tag categories each tag belongs to (e.g. "Tier 1 VC"; a tag can sit in several tag categories). Tag ids are the `tag_id` values returned by get_twitter_info. Tag categories are a separate taxonomy from the account categories returned by get_categories. Only tags linked to at least one tag category are listed. Results are ordered by tag id and paginated with `page`/`size` (default 10, max 25).
**Nested fields**

- `tags[].id` (integer): Tag id (matches `tag_id` in get_twitter_info).
- `tags[].name` (string): Tag name.
- `tags[].tag_categories` (array): Tag categories this tag belongs to (one or more).
- `tags[].tag_categories[].id` (integer): Tag category id.
- `tags[].tag_categories[].name` (string): Tag 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

```bash
curl -s "https://twitterscore.io/api/v1/get_tags?page=1" \
  -H "X-API-Key: $TWITTERSCORE_API_KEY" \
  -H "User-Agent: my-app/1.0 (contact@example.com)"
```

```python
import os, requests

r = requests.get(
    "https://twitterscore.io/api/v1/get_tags",
    params={"page": 1},
    headers={"X-API-Key": os.environ["TWITTERSCORE_API_KEY"],
             "User-Agent": "my-app/1.0 (contact@example.com)"},
    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)
```

```javascript
const r = await fetch("https://twitterscore.io/api/v1/get_tags?page=1", {
  headers: { "X-API-Key": process.env.TWITTERSCORE_API_KEY,
             "User-Agent": "my-app/1.0 (contact@example.com)" },
});
const data = await r.json();
if (data.success === false) throw new Error(data.message);
console.log(data);
```

## Example response

```json
{
  "success": true,
  "total": 56,
  "page": 1,
  "size": 3,
  "pages": 19,
  "tags": [
    {
      "id": 1,
      "name": "a16z",
      "tag_categories": [
        {
          "id": 1,
          "name": "Tier 1 VC"
        }
      ]
    },
    {
      "id": 2,
      "name": "Coinbase Ventures",
      "tag_categories": [
        {
          "id": 1,
          "name": "Tier 1 VC"
        }
      ]
    },
    {
      "id": 3,
      "name": "Paradigm",
      "tag_categories": [
        {
          "id": 1,
          "name": "Tier 1 VC"
        }
      ]
    }
  ]
}
```

## Errors

Error codes this endpoint can return (see [Errors](/developers/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](/developers/authentication/). Limits: per-minute rate and monthly quota by plan, see [Rate limits](/developers/rate-limits/). Machine-readable definition: [/openapi.json](/openapi.json).