POST
https://search.linkd.inc
/
api
/
search
/
deep_research
curl --request POST \
  --url https://search.linkd.inc/api/search/deep_research \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "<string>",
  "limit": 30,
  "school": [
    "<string>"
  ],
  "enrich_emails": true,
  "acceptance_threshold": 85
}'
{
  "job_id": "<string>",
  "status": "pending",
  "message": "<string>"
}

Deep research is an advanced search feature that combines multiple search variations and optional email enrichment to provide comprehensive results. The process is asynchronous and uses a job-based system.

​
Initiate Deep Research

curl -X POST https://search.linkd.inc/api/search/deep_research \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "software engineers in San Francisco",
    "limit": 30,
    "school": ["Stanford University"],
    "enrich_emails": true,
    "acceptance_threshold": 85
  }'

​
Request Parameters

ParameterTypeRequiredDescription
querystringYesThe search query to research
limitintegerNoMaximum number of results to return (default: 30, max: 100)
schoolarrayNoFilter results by school names
enrich_emailsbooleanNoWhether to enrich results with contact information (default: true)
acceptance_thresholdnumberNoAcceptance score threshold (0-100) for a match (default: 85)

​
Response

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "message": "Deep research job initiated"
}

​
Get Research Status

curl https://search.linkd.inc/api/search/deep_research/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response (Processing)

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "message": "Processing search batch 1 of 3. Found 45 profiles so far.",
  "progress": {
    "stage": "batch_processing",
    "batch_number": 1,
    "total_batches": 3,
    "total_variations_generated": 15,
    "current_enriched_count": 0,
    "target_limit": 30,
    "profiles_found_so_far": 45,
    "current_stage_description": "Searching with query: 'software engineers in San Francisco'"
  },
  "created_at": 1679012345
}

​
Response (Completed)

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "message": "Deep research completed successfully. Found 30 profiles with 25 enriched with contact information.",
  "results": [...],
  "total": 30,
  "query": "software engineers in San Francisco",
  "enrichment_stats": {
    "enrichment_enabled": true,
    "total_profiles": 45,
    "profiles_with_contacts": 25,
    "enrichment_success_rate": "55.6%",
    "profiles_returned": 30,
    "profiles_skipped": 15,
    "total_variations_generated": 15
  },
  "created_at": 1679012345
}

​
Response (Error)

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "error",
  "message": "Error processing deep research: Example error message",
  "error": "Example error message",
  "created_at": 1679012345
}

​
Error Responses

Status CodeDescription
401Unauthorized - API key missing or invalid
402Payment Required - Insufficient credits
403Forbidden - Not authorized to access this job
404Not Found - Job not found

​
Notes

  • Deep research jobs can take several minutes to complete
  • The process involves:
    1. Generating multiple query variations
    2. Running parallel searches with each variation
    3. Deduplicating results
    4. Optionally enriching profiles with contact information
  • Results are cached for future similar queries
  • Each result costs 1 credit
  • Email enrichment is performed using the contact information endpoint

Authorizations

​
Authorization
string
header
required

API key must be provided as a Bearer token in the Authorization header

Body

application/json

Response

200
application/json

Deep research job initiated successfully

The response is of type object.