# TikTok / Hashtag

Fetch public metadata for a TikTok hashtag: id, name, video count, and view count when available.

```
GET /api/v1/tiktok/hashtag
```

Auth: `Authorization: Bearer <SOCIFY_KEY>`  
Credits: 1 credit per request

## Parameters

| Name | Required | Description | Example |
|------|----------|-------------|---------|
| `name` | yes | Hashtag name without #. | `comedy` |

## Example

```bash
curl -s 'https://trysocify.com/api/v1/tiktok/hashtag?name=comedy' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

## Response fields

| Field | Type | Description |
|-------|------|-------------|
| `id` | string | Hashtag id. |
| `name` | string | Hashtag name. |
| `videos` | number | Video count for the hashtag, when available. |
| `views` | number | Total view count for the hashtag, when available. |
| `desc` | string | Hashtag description, when available. |
## Sample response

Successful lookups wrap the payload in `{ ok, platform, resource, params, data, meta }`. `data` is shown below.

```json
{
  "ok": true,
  "platform": "tiktok",
  "resource": "hashtag",
  "params": {
    "name": "comedy"
  },
  "data": {
    "desc": "Comedy on TikTok",
    "id": "1606334392378370",
    "name": "comedy",
    "videos": 28400000,
    "views": 3025000000000
  },
  "meta": {
    "credits_charged": 1,
    "latency_ms": 420,
    "platform": "tiktok",
    "resource": "hashtag",
    "path": "/api/v1/tiktok/hashtag"
  }
}
```

## Links

- HTML docs: https://trysocify.com/docs/api/tiktok/hashtag
- SEO page: https://trysocify.com/tiktok/hashtag
- OpenAPI: https://trysocify.com/openapi.json
- Catalog: https://trysocify.com/catalog.json