# Threads Hashtag Posts

Return public Threads posts carrying a hashtag, using the same post shape as post search. Pass the bare hashtag name without the leading #. A hashtag that has no posts returns a 404 and is not billed. Responses cover page 1 only.

- **Documentation:** [https://scrappa.co/docs/threads-api/threads_tag](https://scrappa.co/docs/threads-api/threads_tag)
- **API group:** Threads API
- **Endpoint:** `GET https://scrappa.co/api/threads/tag`

## 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 |
| --- | --- | --- | --- |
| `name` | string | Yes | Hashtag name without the leading #. |

## Example response

```json
{
    "meta": {
        "attempts": 1,
        "duration_ms": 1500,
        "endpoint_family": "threads_tag"
    },
    "posts": [],
    "search_parameters": {
        "name": "nature",
        "engine": "threads_tag"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | Returned, and not billed, when the handle, post code or hashtag does not exist or is not publicly available. |
| 422 | Validation Error | Returned, and not billed, when a parameter is missing or outside its allowed range. |
| 503 | Service Unavailable | A retryable, non-billable failure. The upstream returned a degraded or unreadable response, or the request budget ran out. |

## 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)