# Social Profile People Search

> Social Profile People Search is a paid API for AI agents from social.duoleads.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-30).

Search public TikTok, Instagram, or Threads profiles by name or keyword, returning handle, bio, follower counts, and verification status.

## Facts

- Endpoint: GET https://social.duoleads.com/v1/social/people?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/social-profile-people-search-fff2ef22
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__O-ZlZ_LjAtl8o3YsbPkV

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 social-profile-people-search-fff2ef22
```

Example prompt: Search TikTok for public profiles matching 'fitness coach' and show me each account's handle, follower count, and whether they're verified.

## When to prefer this

Use this endpoint when you need to search for social media profiles across TikTok, Instagram, or Threads by name or keyword, especially for influencer discovery, brand research, or finding a specific person's public account. Prefer this over the 'Creator & Brand Account Search' sibling if you want unfiltered results across all account types (not just creators/brands). Use this instead of platform-native APIs when you need a unified schema across platforms without platform-specific auth. Prefer over 'Social Search Across Platforms' when you specifically want profile results rather than posts or videos.

## Known failure modes

- Invalid platform enum value — returns error, not charged
- Empty or missing query string — returns error, not charged
- No matching profiles found — returns empty items list, not charged
- TikTok cursor is invalid or expired — may return error or restart from first page
- Rate limiting or upstream platform unavailability — may return 5xx error
- Query too long (>200 chars) — returns validation error

## How this service works

Social Profile People Search: search public TikTok, Instagram or Threads profiles by name or keyword, unfiltered. Per profile the handle, name, bio, followers, following, posts and verification in the shared social schema; next_cursor on TikTok. Bad input is free; not found or no match is not charged.

## Output

Returns a list of matching public profiles, each containing: platform ID, profile URL, handle, display name, follower count, following count, post count, verification status, profile image URL, and lang. Also returns the original query parameters, a request ID, a disclaimer about data provenance, a 'complete' flag, and for TikTok a next_cursor for pagination. Bad or malformed input is not charged; profiles not found are also not charged.

## 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": [
      "platform",
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "maxLength": 200,
       "description": "Name or keyword to search accounts for (1-200 characters)."
      },
      "cursor": {
       "type": "string",
       "maxLength": 512,
       "description": "next_cursor of the previous page (TikTok only)."
      },
      "platform": {
       "enum": [
        "tiktok",
        "instagram",
        "threads"
       ],
       "type": "string",
       "description": "One of tiktok, instagram, threads."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-10-15T12:00:00.000Z",
  "items": [
   {
    "id": "6000000000000000201",
    "url": "https://www.tiktok.com/@synth_big",
    "lang": null,
    "text": null,
    "type": "profile",
    "author": {
     "handle": "synth_big",
     "verified": null,
     "followers": 163953,
     "display_name": "Synthetic Big Creator"
    },
    "metrics": {
     "likes": null,
     "views": null,
     "replies": null,
     "reposts": null
    },
    "profile": {
     "posts": null,
     "following": 63,
     "likes_total": null
    },
    "platform": "tiktok",
    "parent_id": null,
    "created_at": null,
    "media_urls": [
     "https://p16.tiktokcdn.invalid/a/201.jpeg"
    ]
   },
   {
    "id": "6000000000000000202",
    "url": "https://www.tiktok.com/@synth_small",
    "lang": null,
    "text": null,
    "type": "profile",
    "author": {
     "handle": "synth_small",
     "verified": null,
     "followers": 9999,
     "display_name": "Synthetic Small Creator"
    },
    "metrics": {
     "likes": null,
     "views": null,
     "replies": null,
     "reposts": null
    },
    "profile": {
     "posts": null,
     "following": 10,
     "likes_total": null
    },
    "platform": "tiktok",
    "parent_id": null,
    "created_at": null,
    "media_urls": [
     "https://p16.tiktokcdn.invalid/a/202.jpeg"
    ]
   }
  ],
  "query": {
   "q": "synthetic widgets",
   "cursor": null,
   "platform": "tiktok"
  },
  "source": "public data via third-party provider; not affiliated with the platform",
  "complete": true,
  "platform": "tiktok",
  "disclaimer": "Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.",
  "request_id": "01KEXAMPLE0000000000000000",
  "next_cursor": "30"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/social-profile-people-search-fff2ef22/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from social.duoleads.com](https://www.zero.xyz/host/social.duoleads.com/llms.txt)