# GEDX402 Social – TikTok Keyword Search

> GEDX402 Social – TikTok Keyword Search is a paid API for AI agents from social.gedx402.com, paid per call via x402, $0.014/call, status unknown (last checked 2026-09-14).

Search TikTok for videos and content matching a keyword query, with optional region, sort, and date filters, via the SociaVault proxy.

## Facts

- Endpoint: GET https://social.gedx402.com/v1/sociavault/tiktok/search/keyword
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gedx402-social-tiktok-keyword-search-1600aa6d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CLbhCasLdmKBUejEBhCo0

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 gedx402-social-tiktok-keyword-search-1600aa6d
```

Example prompt: Search TikTok for videos about 'sustainable fashion' posted this week, sorted by relevance, in the US region — give me the first page of results.

## When to prefer this

Use this endpoint when you need to search TikTok content by keyword and want programmatic access without managing TikTok API credentials directly. Ideal for content research, trend discovery, and social listening tasks where per-call micropayment via x402 is acceptable. Prefer this over scraping or manual search when pagination, region filtering, and date filtering are needed.

## Known failure modes

- Invalid or empty query returns no results or error
- Unsupported region code causes lookup failure
- Invalid sort_by value returns an API error
- Cursor out of range returns empty page or error
- Payment not fulfilled causes 402 rejection before data is returned
- Rate limiting or upstream TikTok API unavailability causes failure

## How this service works

SociaVault API proxy — tiktok-search-keyword. Query/body matches https://docs.sociavault.com/api-reference/openapi.json. GET/POST per route; x402 per call. $0.014 USDC per request.

## Output

A JSON object with a 'data' field containing TikTok search results matching the keyword, a 'success' boolean, and provider attribution ('sociavault'). Results include video metadata and post details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "trim": {
   "type": "boolean"
  },
  "query": {
   "type": "string"
  },
  "cursor": {
   "type": "integer"
  },
  "region": {
   "type": "string"
  },
  "sort_by": {
   "type": "string"
  },
  "date_posted": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "success": true,
  "provider": "sociavault"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gedx402-social-tiktok-keyword-search-1600aa6d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from social.gedx402.com](https://www.zero.xyz/host/social.gedx402.com/llms.txt)