# GEDX402 Social – TikTok Top Search

> GEDX402 Social – TikTok Top 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 top results matching a query, with optional region, sort order, publish time filter, and pagination cursor, via the SociaVault proxy.

## Facts

- Endpoint: GET https://social.gedx402.com/v1/sociavault/tiktok/search/top
- 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-top-search-982ad9eb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OnRFVD9ahYGjgTK3iMd6I

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-top-search-982ad9eb
```

Example prompt: Search TikTok for the top videos about 'sustainable fashion' in the US region, sorted by relevance, published in the last month — start from the beginning of results.

## When to prefer this

Use this endpoint when you need to retrieve top-ranked TikTok search results for a keyword or topic, especially when you want to filter by region, sort order, or recency. Prefer this over general web search when the goal is specifically TikTok video discovery via SociaVault's proxy with per-call micropayment pricing.

## Known failure modes

- Invalid or missing query parameter returns empty or error response
- Unsupported region code may return no results or an error
- Invalid sort_by or publish_time enum values may cause a bad request
- Cursor out of range returns empty result set
- x402 payment failure results in 402 response before data is returned
- Rate limiting or quota exceeded returns error from underlying SociaVault provider

## How this service works

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

## Output

Returns a JSON object with a 'data' field containing TikTok top search results matching the query, a 'success' boolean, and 'provider' field set to 'sociavault'. The data payload includes video metadata and ranking information for top results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string"
  },
  "cursor": {
   "type": "integer"
  },
  "region": {
   "type": "string"
  },
  "sort_by": {
   "type": "string"
  },
  "publish_time": {
   "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-top-search-982ad9eb/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)