Submit SpiderPeople Job

POST/api/v1/jobs/spiderPeople/submit

info

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

payloadobjectrequired

LinkedIn research parameters

payload.modestringrequired

Operation mode: profile, search, or research

payload.linkedin_urlstring

LinkedIn profile URL. Required for profile and research modes.

payload.search_querystring

Natural language search query. Required for search mode.

payload.search_limitintegerdefault: 10

Maximum number of search results (1-20)

payload.generate_summarybooleandefault: false

Generate AI summary of profile (profile mode only)

payload.extract_insightsbooleandefault: false

Extract AI-powered insights (profile mode only)

payload.product_descriptionstring

Your product description for CHAMP lead scoring

payload.icp_descriptionstring

Ideal customer profile for CHAMP lead scoring

payload.testbooleandefault: false

Route to test queue for development

payload.fuzziq_enabledboolean

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_onlyboolean

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)

priorityintegerdefault: 5

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

Profile Mode

Fetch a full LinkedIn profile by URL.

cURL

curl -X POST https://spideriq.ai/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
  }'

Python

import requests

headers = {
    "Authorization": "Bearer <your_token>",
    "Content-Type": "application/json"
}

data = {
    "payload": {
        "mode": "profile",
        "linkedin_url": "https://linkedin.com/in/williamhgates"
    },
    "priority": 5
}

response = requests.post(
    "https://spideriq.ai/api/v1/jobs/spiderPeople/submit",
    headers=headers,
    json=data
)

print(response.json())

JavaScript

const response = await fetch(
  'https://spideriq.ai/api/v1/jobs/spiderPeople/submit',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer <your_token>',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      payload: {
        mode: 'profile',
        linkedin_url: 'https://linkedin.com/in/williamhgates'
      },
      priority: 5
    })
  }
);

const data = await response.json();
console.log(data);

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

curl -X POST https://spideriq.ai/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
  }'

Python

import requests

headers = {
    "Authorization": "Bearer <your_token>",
    "Content-Type": "application/json"
}

data = {
    "payload": {
        "mode": "search",
        "search_query": "CEO tech Israel",
        "search_limit": 5
    },
    "priority": 5
}

response = requests.post(
    "https://spideriq.ai/api/v1/jobs/spiderPeople/submit",
    headers=headers,
    json=data
)

print(response.json())

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

curl -X POST https://spideriq.ai/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

1. Use Search Mode First: Find relevant profiles before fetching full details
2. Cache Results: Store profiles locally to reduce API calls
3. Handle Private Profiles: Some profiles are private and return limited data
4. 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