# OneShot Agent Person Followers Lookup

> OneShot Agent Person Followers Lookup is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-16).

Retrieves a person's social interactions — followers, following, and/or replies — from their Twitter or LinkedIn profile URL

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/person-followers?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-person-followers-lookup-18688647
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Mhpnxc8WciRwsMRsXZxT5

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 oneshot-agent-person-followers-lookup-18688647 -d '<json body>'
```

Example prompt: Can you pull the followers and following list for @elonmusk on Twitter (https://twitter.com/elonmusk), up to 100 results each?

## When to prefer this

Use this endpoint when you need structured social graph data (followers, following, replies) for a specific person identified by their Twitter or LinkedIn URL. Prefer this over general web scraping when you need clean, enumerated social interaction lists with configurable result counts and a simple per-call pricing model.

## Known failure modes

- Invalid or inaccessible social media URL returns an error
- Unsupported platform URL (not Twitter or LinkedIn) results in failure
- Rate limits or platform restrictions may reduce returned results
- Private or suspended accounts may return empty or error responses
- Payment failure via x402 prevents the call from being processed

## How this service works

Get a person's social interactions — followers, following, and replies

## Output

Returns a structured list of social interactions for the specified person — which may include followers (accounts following them), following (accounts they follow), and/or replies — sourced from their Twitter or LinkedIn profile, up to the requested max_results count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "description": "Full name"
  },
  "type": {
   "enum": [
    "replies",
    "followers",
    "following",
    "followers,following"
   ],
   "type": "string"
  },
  "email": {
   "type": "string",
   "format": "email",
   "description": "Email address"
  },
  "phone": {
   "type": "string",
   "description": "Phone number"
  },
  "company": {
   "type": "string",
   "description": "Employer name or domain, e.g. \"Coinbase\" or \"coinbase.com\""
  },
  "max_results": {
   "type": "number"
  },
  "profile_url": {
   "type": "string",
   "format": "uri",
   "description": "Profile URL on LinkedIn, X or GitHub"
  },
  "linkedin_url": {
   "type": "string",
   "format": "uri",
   "description": "Same as profile_url (older name)"
  },
  "social_media_url": {
   "type": "string",
   "format": "uri",
   "description": "Same as profile_url (older name)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-person-followers-lookup-18688647/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)
