Submit SpiderPeople Job

v2.17.0 Feature - SpiderPeople is available as of December 2025.

Overview

SpiderPeople finds decision makers by searching Google, discovering LinkedIn profiles, and extracting profile data. It supports three modes of operation:

Profile Mode

Fetch full LinkedIn profile by URL

Search Mode

Natural language profile search

Research Mode

AI-powered research reports

Request Body

payload

object

required

LinkedIn research parameters

payload.mode

string

required

Operation mode: profile, search, or research

payload.linkedin_url

string

LinkedIn profile URL. Required for profile and research modes.

payload.search_query

string

Natural language search query. Required for search mode.

payload.search_limit

integer

default:"10"

Maximum number of search results (1-20)

payload.generate_summary

boolean

default:"false"

Generate AI summary of profile (profile mode only)

payload.extract_insights

boolean

default:"false"

Extract AI-powered insights (profile mode only)

payload.product_description

string

Your product description for CHAMP lead scoring

payload.icp_description

string

Ideal customer profile for CHAMP lead scoring

payload.test

boolean

default:"false"

Route to test queue for development

payload.fuzziq_enabled

boolean

Enable FuzzIQ deduplication for this job (v2.18.0+)When enabled, each profile will include a fuzziq_unique flag indicating whether it’s a new record or duplicate.Default: Uses client-level setting (typically true)

payload.fuzziq_unique_only

boolean

Return only unique profiles, filtering out duplicates (v2.18.0+)When true, profiles that are duplicates of previously researched records will be excluded from the response.Default: Uses client-level setting (typically false)

priority

integer

default:"5"

Job priority (0-10, higher = processed first)

Profile Mode

Fetch a full LinkedIn profile by URL.

curl -X POST https://spideriq.di-atomic.com/api/v1/jobs/spiderPeople/submit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <client_id>:<api_key>:<api_secret>" \
  -d '{
    "payload": {
      "mode": "profile",
      "linkedin_url": "https://linkedin.com/in/williamhgates"
    },
    "priority": 5
  }'

Profile Response

{
  "success": true,
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "spiderPeople",
  "status": "completed",
  "processing_time_seconds": 9.27,
  "worker_id": "spider-people-main-1",
  "completed_at": "2025-12-25T10:30:00Z",
  "data": {
    "mode": "profile",
    "profile": {
      "linkedin_url": "https://linkedin.com/in/williamhgates",
      "linkedin_id": "williamhgates",
      "linkedin_num_id": "251749025",
      "first_name": "Bill",
      "last_name": "Gates",
      "full_name": "Bill Gates",
      "headline": "Co-chair, Bill & Melinda Gates Foundation",
      "about": "Bill Gates is a technologist, business leader, and philanthropist...",
      "location": "Seattle, Washington, United States",
      "city": "Seattle",
      "country_code": "US",
      "profile_pic_url": "https://media.licdn.com/...",
      "banner_image": "https://media.licdn.com/...",
      "connections": 500,
      "followers": 35000000,
      "current_company": "Bill & Melinda Gates Foundation",
      "experience": [
        {
          "company": "Bill & Melinda Gates Foundation",
          "company_logo_url": "https://media.licdn.com/...",
          "title": "Co-chair",
          "description_html": "...",
          "duration": "Jan 2000 - Present"
        },
        {
          "company": "Microsoft",
          "title": "Co-founder",
          "duration": "Apr 1975 - Jan 2020"
        }
      ],
      "education": [
        {
          "title": "Harvard University",
          "description": "Computer Science",
          "start_year": "1973",
          "end_year": "1975"
        }
      ],
      "languages": [
        {
          "name": "English",
          "proficiency": "Native"
        }
      ]
    },
    "cached": false,
    "source": "api"
  }
}

Search Mode

Find profiles using natural language queries.

curl -X POST https://spideriq.di-atomic.com/api/v1/jobs/spiderPeople/submit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <client_id>:<api_key>:<api_secret>" \
  -d '{
    "payload": {
      "mode": "search",
      "search_query": "CEO tech Israel",
      "search_limit": 5
    },
    "priority": 5
  }'

Search Response

{
  "success": true,
  "job_id": "660e9511-f39c-52e5-b827-557766551111",
  "type": "spiderPeople",
  "status": "completed",
  "processing_time_seconds": 5.66,
  "worker_id": "spider-people-main-1",
  "completed_at": "2025-12-25T10:35:00Z",
  "data": {
    "mode": "search",
    "query": "CEO tech Israel",
    "results_count": 5,
    "profiles": [
      {
        "linkedin_url": "https://linkedin.com/in/johndoe",
        "linkedin_id": "johndoe",
        "title": "John Doe | CEO at TechStartup | LinkedIn",
        "snippet": "CEO building the future of AI in Israel...",
        "name": "John Doe",
        "headline": "CEO at TechStartup Israel",
        "location": "Tel Aviv, Israel"
      },
      {
        "linkedin_url": "https://linkedin.com/in/janedoe",
        "linkedin_id": "janedoe",
        "name": "Jane Doe",
        "headline": "CEO & Co-founder at AICompany",
        "location": "Herzliya, Israel"
      }
    ],
    "parsed_query": {
      "google_query": "site:linkedin.com/in CEO tech Israel",
      "count": 5,
      "role": "CEO",
      "location": "Israel",
      "keywords": ["tech"]
    },
    "cached": false
  }
}

Research Mode

Generate AI-powered research reports with insights.

curl -X POST https://spideriq.di-atomic.com/api/v1/jobs/spiderPeople/submit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <client_id>:<api_key>:<api_secret>" \
  -d '{
    "payload": {
      "mode": "research",
      "linkedin_url": "https://linkedin.com/in/satyanadella"
    },
    "priority": 5
  }'

Research Response

{
  "success": true,
  "job_id": "770f0622-g40d-63f6-c938-668877662222",
  "type": "spiderPeople",
  "status": "completed",
  "processing_time_seconds": 24.5,
  "worker_id": "spider-people-main-1",
  "completed_at": "2025-12-25T10:40:00Z",
  "data": {
    "mode": "research",
    "person_name": "Satya Nadella",
    "linkedin_url": "https://linkedin.com/in/satyanadella",
    "report": "# Satya Nadella - Research Report\n\n## Executive Summary\n\nSatya Nadella is the Chairman and CEO of Microsoft Corporation...\n\n## Career Highlights\n\n- Joined Microsoft in 1992\n- Led Cloud and Enterprise group\n- Appointed CEO in February 2014\n\n## Leadership Style\n\n...",
    "sources": [
      "linkedin.com",
      "microsoft.com",
      "wikipedia.org",
      "forbes.com"
    ],
    "metadata": {
      "research_id": "res_abc123def456",
      "created_at": "2025-12-25T10:39:00Z",
      "updated_at": "2025-12-25T10:40:00Z"
    }
  }
}

Processing Times

Mode	Typical Time	Notes
Profile	3-10 seconds	Faster if cached
Search	5-15 seconds	Depends on result count
Research	10-30 seconds	AI analysis required

Rate Limits

5,000 jobs maximum queue depth
Standard client rate limits apply (100/min)

Best Practices

Use Search Mode First: Find relevant profiles before fetching full details
Cache Results: Store profiles locally to reduce API calls
Handle Private Profiles: Some profiles are private and return limited data
Use Test Mode: Add "test": true for development to avoid affecting production

Common Use Cases

Talent Sourcing: Find candidates matching specific criteria
Competitor Analysis: Research key people at competitor companies
Lead Enrichment: Add LinkedIn data to existing lead records
Market Research: Understand industry hiring patterns
Sales Intelligence: Research prospects before outreach

API Reference

​Overview

Profile Mode

Search Mode

Research Mode

​Request Body

​Profile Mode

​Profile Response

​Search Mode

​Search Response

​Research Mode

​Research Response

​Processing Times

​Rate Limits

Overview

Request Body

Profile Mode

Profile Response

Search Mode

Search Response

Research Mode

Research Response

Processing Times

Rate Limits