# GEDX402 Social – TikTok Demographics

> GEDX402 Social – TikTok Demographics 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).

Fetches demographic data for a TikTok account by handle via the SociaVault proxy, billed per call via x402 micropayment.

## Facts

- Endpoint: GET https://social.gedx402.com/v1/sociavault/tiktok/demographics
- 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-demographics-1a7c1ac9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GYAO7P29P_AAeT3rXRnXJ

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-demographics-1a7c1ac9
```

Example prompt: Pull the SociaVault demographic breakdown for the TikTok account @charlidamelio — I want to see the audience demographics for that handle.

## When to prefer this

Use this endpoint when you need TikTok-specific audience demographic data for a creator or brand account by handle, particularly in influencer research, marketing analytics, or audience profiling workflows that accept x402 micropayment billing. Prefer this over general social media APIs when TikTok demographic granularity is required without a full platform OAuth integration.

## Known failure modes

- Invalid or non-existent TikTok handle returns empty data object with success:true but no meaningful content
- Missing handle parameter results in a 400 or unstructured error
- Payment failure via x402 prevents data retrieval entirely
- Rate limits or SociaVault upstream unavailability may return errors
- Private or restricted TikTok accounts may return incomplete demographic data

## How this service works

SociaVault API proxy — tiktok-demographics. 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 demographic data for the specified TikTok handle, including audience composition details such as age, gender, and location breakdowns, wrapped in a success flag and SociaVault provider attribution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "handle": {
   "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-demographics-1a7c1ac9/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)