Nyne Search Skill

Search for people using natural language queries. Find professionals by role, company, location, industry, or any combination. Returns matching profiles with contact info, work history, education, and optional AI relevance scoring.

Important: This API is async. You POST to submit, get a request_id, then poll GET until status: "completed". Light searches complete in 3-40 seconds; premium searches take 30-300 seconds.

Agent Instructions

When presenting search results to the user, show all returned data for each person. Walk through:

1. Result count — total_stored, total_estimate, has_more, credits_charged
2. Each person — displayname, headline, bio, location, gender, estimated_age, total_experience_years, is_decision_maker
3. Contact info — best_business_email, best_personal_email, altemails, fullphone (if show_emails/show_phone_numbers were enabled)
4. Social profiles — LinkedIn URL, username, connections, followers
5. Work history — all organizations with title, dates, company details (industries, num_employees, funding, technologies)
6. Education — schools with degree, major, dates; note is_top_universities flag
7. Interests — work interests and certifications
8. Patents — title, date, reference, URL (if present)
9. Languages — spoken languages
10. Score — AI relevance score 0-1 (if profile_scoring was enabled)
11. Insights — AI-generated match reasoning (if insights were enabled)

If has_more is true, tell the user there are more results available and offer to paginate using the next_cursor.

If a field is missing from the response, it means no data was found — skip it silently.

Setup

Required environment variables:

• NYNE_API_KEY — your Nyne API key
• NYNE_API_SECRET — your Nyne API secret

Get credentials at https://api.nyne.ai.

export NYNE_API_KEY="your-api-key"
export NYNE_API_SECRET="your-api-secret"

Verify they're set:

echo "Key: ${NYNE_API_KEY:0:8}... Secret: ${NYNE_API_SECRET:0:6}..."

Important: JSON Handling

The API response can contain control characters in JSON string values that break jq. All examples use a nyne_parse helper that cleans and re-encodes JSON via python3. Define it once per session:

nyne_parse() {
  python3 -c "
import sys, json, re
raw = sys.stdin.read()
clean = re.sub(r'[\x00-\x1f]+', ' ', raw)
data = json.loads(clean)
json.dump(data, sys.stdout)
"
}

Quick Start

Search for people by natural language query and poll until complete:

nyne_parse() {
  python3 -c "
import sys, json, re
raw = sys.stdin.read()
clean = re.sub(r'[\x00-\x1f]+', ' ', raw)
data = json.loads(clean)
json.dump(data, sys.stdout)
"
}