# Hashflags

`GET https://api.twittrapi.com/misc/emojis`

X's hashflags: hashtags that show a custom emoji, with image URLs and active dates.

HTML page: https://www.twittrapi.com/docs/reference/misc-emojis

## Parameters

None.

Every read endpoint also accepts `format=simple` (or the header `X-Response-Format: simple`) for compact, flat JSON with a fixed schema. Same price.

## Response

Raw JSON of X's v1.1 hashflags.json.

With `format=simple`: Unchanged inside {data: ...}: X's hashflag list is already small, so the simple format only adds the envelope.

## Errors

| Status | When |
| --- | --- |
| 400 | Any upstream failure ("Error making emoji request."). Refunded. |

Shared errors (401 missing key, 402 no balance, 429 rate limit, 5xx) are listed on https://www.twittrapi.com/docs/helpful-infos/error-handling. Calls that fail with 400, 408, 409 or a 5xx error are refunded.

## Example request

curl:

```bash
curl 'https://api.twittrapi.com/misc/emojis' \
  --header 'X-API-KEY: YOUR_API_KEY'
```

Python:

```python
import httpx

# No SDK method for this endpoint yet, so this is a plain HTTP call.
resp = httpx.get(
    "https://api.twittrapi.com/misc/emojis",
    headers={"X-API-KEY": "YOUR_API_KEY"},
    timeout=60,
)
data = resp.json()
```

Node.js:

```js
import { TwittrAPI } from "twittrapi";

const client = new TwittrAPI({ apiKey: process.env.TWITTRAPI_API_KEY });
// No wrapper method for this endpoint yet; client.get() sends the same authenticated GET.
const data = await client.get({
  path: "/misc/emojis",
});
```

RapidAPI:

```bash
curl 'https://twitter-aio.p.rapidapi.com/misc/emojis' \
  --header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY' \
  --header 'x-rapidapi-host: twitter-aio.p.rapidapi.com'
```

## Example response

Shortened: arrays keep their first items and long strings are cut.

Raw (default):

```json
[
  {
    "hashtag": "13周年大カーン謝祭",
    "starting_timestamp_ms": 1783857600000,
    "ending_timestamp_ms": 1791817140000,
    "asset_url": "https://abs.twimg.com/hashflags/BF-16276_Hashmoji_monst_mmix_13rdAnniv/BF-16276_Hashmoji_monst_mmix_13rdAnniv.png",
    "is_hashfetti_enabled": false
  },
  "… 7 more"
]
```

Simple (`format=simple`):

```json
{
  "data": [
    {
      "hashtag": "13周年大カーン謝祭",
      "starting_timestamp_ms": 1783857600000,
      "ending_timestamp_ms": 1791817140000,
      "asset_url": "https://abs.twimg.com/hashflags/BF-16276_Hashmoji_monst_mmix_13rdAnniv/BF-16276_Hashmoji_monst_mmix_13rdAnniv.png",
      "is_hashfetti_enabled": false
    },
    "… 7 more"
  ]
}
```