# Trending Hashtags

Get the top 3 trending TikTok hashtags for a country. This is a country-level hashtag ranking, not the trending video feed: for hashtag video results use the [Challenge Posts API](/docs/tiktok/tiktok_challenges_posts).

- **Documentation:** [https://scrappa.co/docs/tiktok/tiktok_trending_hashtags](https://scrappa.co/docs/tiktok/tiktok_trending_hashtags)
- **API group:** TikTok API
- **Endpoint:** `GET https://scrappa.co/api/tiktok/trending/hashtags`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `country_code` | string | Yes | ISO 3166 alpha-2 country code, for example US. |
| `time_range` | integer | No | Trend window in days. Accepts 7 or 30. Defaults to 7. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/tiktok/trending/hashtags?country_code=US&time_range=7"
```

## Example response

```json
{
    "code": 0,
    "BaseResp": {
        "StatusCode": 0,
        "StatusMessage": ""
    },
    "items": [
        {
            "hashtagID": "220389",
            "hashtagName": "reggie",
            "industryIDs": [
                23000000000
            ],
            "publishCnt": 79067,
            "rankIndex": 1,
            "vv": 890542254,
            "topCreators": [
                {
                    "handleName": "khaby.lame",
                    "nickname": "Khabane lame",
                    "countryCode": "IT",
                    "creatorRank": 1,
                    "followedCnt": 162300000
                }
            ]
        }
    ],
    "pagination": {
        "hasMore": false,
        "limit": 3,
        "page": 1,
        "totalCount": 3
    }
}
```

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)