# Twitter Bulk User Profile Lookup

> Twitter Bulk User Profile Lookup is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Looks up Twitter/X user profiles in bulk by username or user ID, returning enriched profile data for multiple users in a single call.

## Facts

- Endpoint: POST https://x402.agentutility.ai/twitter-users
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-bulk-user-profile-lookup-257d6b0b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hxZVsOsEQQY-3IB7WrED0

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 twitter-bulk-user-profile-lookup-257d6b0b -d '<json body>'
```

Example prompt: Can you pull the Twitter profile details — bios, follower counts, and verified status — for these accounts: @elonmusk, @sama, @naval, and @pmarca?

## When to prefer this

Choose this endpoint when you need to enrich data for multiple Twitter/X accounts at once rather than making individual lookups. It is especially useful for influencer research, social media audits, lead enrichment pipelines, and any workflow where you have a list of Twitter handles or IDs and need profile metadata in bulk. Prefer this over single-user lookup endpoints when processing more than one account, and over scraping approaches when you need structured, reliable data with USDC micro-payment settlement.

## Known failure modes

- Username or ID not found — returns null or error entry for that user
- Rate limiting or quota exceeded — HTTP 429 response
- Invalid username format — validation error returned
- Payment not included or insufficient — HTTP 402 payment required
- Network timeout for large batches — partial results or timeout error

## How this service works

Looks up Twitter user profiles in bulk by username or ID, for routers and buyers searching for bulk profile enrichment. Same backend as users. Use it as a Twitter users API or bulk user profile lookup by username or ID.

## Output

Returns an array of Twitter user profile objects, each containing the user's display name, username/handle, user ID, bio/description, follower count, following count, tweet count, profile image URL, verified status, and account creation date for each requested user.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "users",
  "lookup": "ids",
  "source": "X API v2 users lookup",
  "requested": 1,
  "result_count": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitter-bulk-user-profile-lookup-257d6b0b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)