Skip to main content
These endpoints are async. You POST a request, get back a request_id, and poll /v1/requests/{request_id} until the job finishes.

​
Deep Research Person

Get a full background report on someone — career history, social presence, interests, and how they’re connected.
​
email
string
Person’s email address
​
social_media_url
string
LinkedIn, Twitter, or other social profile URL
​
name
string
Person’s full name
​
company
string
Company name (helps disambiguate)
At least one of email, social_media_url, or name is required. 
curl -X POST https://win.oneshotagent.com/v1/tools/research/person \
  -H "Content-Type: application/json" \
  -H "X-Payment-Proof: <signature>" \
  -d '{
    "email": "[email protected]",
    "name": "Satya Nadella",
    "company": "Microsoft"
  }'
Price: $0.50 per request. Takes 2-5 minutes.

​
Social Profiles

Find someone’s accounts across platforms — LinkedIn, Twitter, GitHub, YouTube, and others.
​
email
string
Person’s email address
​
social_media_url
string
Known social profile URL to start from
At least one of email or social_media_url is required. 
curl -X POST https://win.oneshotagent.com/v1/tools/research/social \
  -H "Content-Type: application/json" \
  -H "X-Payment-Proof: <signature>" \
  -d '{ "email": "[email protected]" }'
Price: $0.05 per request.

​
Article Search

Find articles and interviews mentioning a person.
​
name
string
required
Person’s full name
​
company
string
required
Company name or domain
​
sort
string
default:"recent"
Sort order: recent or popular
​
limit
number
default:"5"
Max results, 1-20
curl -X POST https://win.oneshotagent.com/v1/tools/research/articles \
  -H "Content-Type: application/json" \
  -H "X-Payment-Proof: <signature>" \
  -d '{
    "name": "Satya Nadella",
    "company": "Microsoft",
    "sort": "recent",
    "limit": 5
  }'
Price: $0.10 per request.

​
Person Newsfeed

Pull someone’s recent social posts along with likes, replies, and shares.
​
social_media_url
string
required
Social profile URL (Twitter, LinkedIn, etc)
curl -X POST https://win.oneshotagent.com/v1/tools/research/newsfeed \
  -H "Content-Type: application/json" \
  -H "X-Payment-Proof: <signature>" \
  -d '{ "social_media_url": "https://twitter.com/sataborasu" }'
Price: $0.05 per request.

​
Person Interests

Figure out what someone cares about — sports, politics, tech, entertainment, and so on.
​
email
string
Person’s email address
​
phone
string
Person’s phone number
​
social_media_url
string
Social profile URL
At least one of email, phone, or social_media_url is required. 
curl -X POST https://win.oneshotagent.com/v1/tools/research/interests \
  -H "Content-Type: application/json" \
  -H "X-Payment-Proof: <signature>" \
  -d '{ "email": "[email protected]" }'
Price: $0.05 per request.

​
Person Interactions

See who someone follows, who follows them, and who they reply to.
​
social_media_url
string
required
Social profile or post URL (Twitter/X or Instagram)
​
type
string
default:"followers,following"
Interaction type: replies, followers, following, or followers,following
​
max_results
number
default:"100"
Max results, 1-1000
curl -X POST https://win.oneshotagent.com/v1/tools/research/interactions \
  -H "Content-Type: application/json" \
  -H "X-Payment-Proof: <signature>" \
  -d '{
    "social_media_url": "https://twitter.com/sataborasu",
    "type": "followers,following",
    "max_results": 50
  }'
Price: $0.10 per request.

​
SDK Usage

All six endpoints have SDK methods. The SDK signs payments and polls for results, so you just call the method and get data back. 
const agent = new OneShot({ privateKey: process.env.AGENT_PRIVATE_KEY });

await agent.deepResearchPerson({ email: "[email protected]" });
await agent.socialProfiles({ email: "[email protected]" });
await agent.articleSearch({ name: "Satya Nadella", company: "Microsoft" });
await agent.personNewsfeed({ social_media_url: "https://twitter.com/sataborasu" });
await agent.personInterests({ email: "[email protected]" });
await agent.personInteractions({ social_media_url: "https://twitter.com/sataborasu" });