# StableSocial TikTok Hashtag Search

> StableSocial TikTok Hashtag Search is a paid API for AI agents from StableSocial at stablesocial.dev, paid per call via MPP or x402, $0.06/call, status unknown (last checked 2026-10-11, last successful call 2026-05-13).

Search TikTok posts by hashtag, returning paginated results for a given tag

## Facts

- Endpoint: POST https://stablesocial.dev/api/tiktok/search-hashtag?utm_source=zero.xyz
- Price: $0.06/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-10-11
- Last successful call: 2026-05-13
- Success rate: 50% of calls made through Zero
- Rating: 1.7 / 5 from 1 review
- Activations on Zero: 2
- Provider: StableSocial
- Docs: https://stablesocial.dev
- Website: https://stablesocial.dev
- Tags: tiktok, instagram, facebook, reddit, scraping, social, data, x402
- Canonical page: https://www.zero.xyz/c/stablesocial-search-hashtag-e5f78b54
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IQ0B2_Q7ypHcZbwcBJdI_

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stablesocial-search-hashtag-e5f78b54 -d '<json body>'
```

Example prompt: Search TikTok for posts tagged with 'fitnessmotivation' and give me up to 30 results.

## When to prefer this

Use this endpoint when you need to discover or collect TikTok posts by hashtag rather than by keyword search or user profile. Prefer this over keyword search when the user specifically wants content tagged with a topic, for trend monitoring, hashtag analytics, or content aggregation pipelines.

## Known failure modes

- Hashtag not found or no posts exist — empty results returned
- Missing required 'hashtag' field — validation error
- Invalid cursor value — pagination error or unexpected results
- Rate limiting or payment failure — 402 or 429 response
- TikTok platform changes causing scraper failure — 500 or partial results

## How this service works

Pay-per-request access to social media data from TikTok, Instagram, Facebook, Reddit, and LinkedIn. No auth, no subscriptions.

## Output

A paginated list of TikTok posts matching the given hashtag, including post metadata and a cursor for fetching the next page of results.

## Example request

```json
{
 "hashtag": "artificialintelligence",
 "max_page_size": 30
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cursor": {
   "type": "string",
   "description": "Pagination cursor"
  },
  "hashtag": {
   "type": "string",
   "minLength": 1,
   "description": "Hashtag to search (without #)"
  },
  "max_page_size": {
   "type": "integer",
   "default": 50,
   "maximum": 9007199254740991,
   "minimum": -9007199254740991,
   "description": "Results per page"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "jobId": "clx0000000000000000000000",
  "token": "eyJ...",
  "status": "pending",
  "pollUrl": "https://stablesocial.dev/api/jobs/clx0000000000000000000000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablesocial-search-hashtag-e5f78b54/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablesocial.dev](https://www.zero.xyz/host/stablesocial.dev/llms.txt)