# GEDX402 Social – TikTok Hashtag Videos Lookup

> GEDX402 Social – TikTok Hashtag Videos Lookup is a paid API for AI agents from social.gedx402.com, paid per call via x402, $0.014/call, status unknown (last checked 2026-10-31).

Fetches a paginated list of TikTok videos associated with a given hashtag ID via the SociaVault data proxy, billed per call via x402 micropayment.

## Facts

- Endpoint: GET https://social.gedx402.com/v1/sociavault/tiktok/hashtag/videos?utm_source=zero.xyz
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gedx402-social-tiktok-hashtag-videos-lookup-2d1c321f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qhWqeJHIqOmUX_1vu8B2y

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-hashtag-videos-lookup-2d1c321f
```

Example prompt: Pull the list of TikTok videos for hashtag ID '1234567890' using SociaVault — start from the beginning (no cursor) and show me what comes back.

## When to prefer this

Use this endpoint when you need programmatic, paginated access to TikTok videos by hashtag ID and are operating in an x402 micropayment environment. Prefer it over direct TikTok API access when you lack official TikTok developer credentials or want a unified social data proxy that also covers other platforms. Best suited for analytics, research, and content monitoring workflows.

## Known failure modes

- Missing or invalid hashtag_id returns an error or empty data set
- Invalid cursor value may cause unexpected pagination results
- Rate limiting or payment failure (x402) returns 402 Payment Required
- SociaVault upstream unavailability may return a failed success flag or empty data
- Hashtag with no associated videos returns an empty data object

## How this service works

SociaVault social data ingest — profile, posts, transcript, and full API proxy. One x402 payment per outcome.

## Output

Returns a JSON object with a 'data' field containing TikTok video records associated with the requested hashtag, a 'success' boolean, and a 'provider' field identifying SociaVault. Pagination is handled via cursor values for subsequent requests.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "hashtag_id"
     ],
     "properties": {
      "cursor": {
       "type": "integer"
      },
      "hashtag_id": {
       "type": "string"
      }
     },
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## 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-hashtag-videos-lookup-2d1c321f/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)