gooseworks-ai/person-lookup

Person Lookup

Cost Warning

Nyne /person/search uses PeopleDataLabs under the hood — $0.30 per record returned. For a single person lookup this is fine ($0.30), but avoid large result sets.

Cheaper alternatives for multi-result searches:

• Apollo mixed_people/search: $0.01 flat per call → $GOOSEWORKS_API_BASE/v1/proxy/apollo/mixed_people/search
• Fiber /v1/natural-language-search/profiles: $0.02/record → $GOOSEWORKS_API_BASE/v1/proxy/fiber/v1/natural-language-search/profiles

Use Nyne only when you need to look up a specific individual by name + company.

Setup

Read your credentials from ~/.gooseworks/credentials.json:

export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")

If ~/.gooseworks/credentials.json does not exist, tell the user to run: npx gooseworks login

All endpoints use Bearer auth: -H "Authorization: Bearer $GOOSEWORKS_API_KEY"

Find detailed information about a person including work history, education, social profiles, and contact information.

When to Use

• User asks about a specific person
• User wants to find someone's background
• User asks "who is [name]?"
• Research on a professional
• Finding contact information

How It Works

Uses the Nyne API to search person databases and aggregate professional information.

Usage

Search for a Person

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"nyne","path":"/person/search","body":{"query":"Dario Amodei Anthropic"}}'

<details> <summary>curl equivalent</summary>

curl -X POST "https://api.orth.sh/v1/run" \

  -H "Content-Type: application/json" \
  -d '{"api":"nyne","path":"/person/search","body":{"query":"Dario Amodei Anthropic"}}'

</details>

Parameters

• query (required) - Search query combining name, company, or other identifiers
  • Examples: "Sam Altman OpenAI", "Dario Amodei CEO Anthropic", "Jensen Huang NVIDIA"

Response

Returns comprehensive person data:

• Full name and current title
• Current employer and role
• Work history (previous companies, roles)
• Education (schools, degrees)
• Location
• Social profiles (LinkedIn, Twitter, etc.)
• Skills and expertise
• Contact information (when available)

Note: Nyne searches are async - the POST returns a request_id. Poll with GET /person/search?request_id=<id> until status is complete. Results may take a few seconds.

Examples

User: "Who is Dario Amodei?"

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"nyne","path":"/person/search","body":{"query":"Dario Amodei Anthropic CEO"}}'

User: "Look up Sam Altman"

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"nyne","path":"/person/search","body":{"query":"Sam Altman OpenAI"}}'

User: "Find info about Jensen Huang"

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"nyne","path":"/person/search","body":{"query":"Jensen Huang NVIDIA CEO"}}'

Error Handling

• Nyne searches are async — if the initial POST doesn't return results, poll with GET using the request_id
• 404 — Person not found; try different name spellings or add company context
• 429 — Rate limit exceeded; wait and retry
• Multiple results for common names — add company or title to narrow down

Tips

• Include company name for more accurate results
• Add job title for disambiguation
• Results are cached - same queries are faster
• Multiple results may be returned for common names