SSpiderIQ
SSpiderIQ

Docs / api-reference/company-intel

Company Intel

2 endpoints from the published OpenAPI import.

POST/api/v1/company-intel

Submit single company intel request

Research a single company through the full intelligence pipeline. Perplexity → SpiderSite → CompanyData → Verify → People. Poll GET /api/v1/jobs/{job_id}/results for results.

Try it

Examples

cURL
curl -X POST 'https://spideriq.ai/api/v1/company-intel' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "company_name": "string",
  "city": "string",
  "country_code": "string",
  "domain": "string",
  "linkedin_url": "string",
  "profile_mode": "short",
  "max_employees": 0,
  "config": {
    "discovery": {
      "enabled": true
    },
    "spidersite": {
      "enabled": true,
      "mode": "leads",
      "max_pages": 25,
      "extract_team": true,
      "extract_company_info": true,
      "product_description": "string",
      "icp_description": "string"
    },
    "spidercompanydata": {
      "enabled": true,
      "country": "auto",
      "include_financials": false
    },
    "spiderverify": {
      "enabled": true,
      "max_emails": 50
    },
    "spiderpeople": {
      "enabled": true,
      "max_employees": 20,
      "profile_mode": "short"
    }
  },
  "test": false
}'
Python
import httpx

resp = httpx.post(
    "https://spideriq.ai/api/v1/company-intel",
    headers={"Authorization": "Bearer <token>", "Content-Type": "application/json"},
    json={"company_name": "string", "city": "string", "country_code": "string", "domain": "string", "linkedin_url": "string", "profile_mode": "short", "max_employees": 0, "config": {"discovery": {"enabled": true}, "spidersite": {"enabled": true, "mode": "leads", "max_pages": 25, "extract_team": true, "extract_company_info": true, "product_description": "string", "icp_description": "string"}, "spidercompanydata": {"enabled": true, "country": "auto", "include_financials": false}, "spiderverify": {"enabled": true, "max_emails": 50}, "spiderpeople": {"enabled": true, "max_employees": 20, "profile_mode": "short"}}, "test": false},
)
resp.raise_for_status()
print(resp.json())
JavaScript
const resp = await fetch("https://spideriq.ai/api/v1/company-intel", {
  method: "POST",
  headers: { "Authorization": "Bearer <token>", "Content-Type": "application/json" },
  body: JSON.stringify({"company_name": "string", "city": "string", "country_code": "string", "domain": "string", "linkedin_url": "string", "profile_mode": "short", "max_employees": 0, "config": {"discovery": {"enabled": true}, "spidersite": {"enabled": true, "mode": "leads", "max_pages": 25, "extract_team": true, "extract_company_info": true, "product_description": "string", "icp_description": "string"}, "spidercompanydata": {"enabled": true, "country": "auto", "include_financials": false}, "spiderverify": {"enabled": true, "max_emails": 50}, "spiderpeople": {"enabled": true, "max_employees": 20, "profile_mode": "short"}}, "test": false})
});
const data = await resp.json();
console.log(data);
Go
package main

import (
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{"company_name": "string", "city": "string", "country_code": "string", "domain": "string", "linkedin_url": "string", "profile_mode": "short", "max_employees": 0, "config": {"discovery": {"enabled": true}, "spidersite": {"enabled": true, "mode": "leads", "max_pages": 25, "extract_team": true, "extract_company_info": true, "product_description": "string", "icp_description": "string"}, "spidercompanydata": {"enabled": true, "country": "auto", "include_financials": false}, "spiderverify": {"enabled": true, "max_emails": 50}, "spiderpeople": {"enabled": true, "max_employees": 20, "profile_mode": "short"}}, "test": false}`)
	req, _ := http.NewRequest("POST", "https://spideriq.ai/api/v1/company-intel", body)
	req.Header.Set("Authorization", "Bearer <token>")
	req.Header.Set("Content-Type", "application/json")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}

Responses

StatusDescription
201Successful Response
422Validation Error
POST/api/v1/company-intel/batch

Submit batch company intel request

Research multiple companies in parallel (up to 50). Poll GET /api/v1/jobs/{job_id}/results for aggregated results.

Try it

Examples

cURL
curl -X POST 'https://spideriq.ai/api/v1/company-intel/batch' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "companies": [
    {
      "company_name": "string",
      "city": "string",
      "country_code": "string",
      "domain": "string",
      "linkedin_url": "string",
      "profile_mode": "short",
      "max_employees": 0,
      "config": {
        "discovery": {
          "enabled": {}
        },
        "spidersite": {
          "enabled": {},
          "mode": {},
          "max_pages": {},
          "extract_team": {},
          "extract_company_info": {},
          "product_description": {},
          "icp_description": {}
        },
        "spidercompanydata": {
          "enabled": {},
          "country": {},
          "include_financials": {}
        },
        "spiderverify": {
          "enabled": {},
          "max_emails": {}
        },
        "spiderpeople": {
          "enabled": {},
          "max_employees": {},
          "profile_mode": {}
        }
      },
      "test": false
    }
  ],
  "profile_mode": "short",
  "max_employees": 0,
  "config": {
    "discovery": {
      "enabled": true
    },
    "spidersite": {
      "enabled": true,
      "mode": "leads",
      "max_pages": 25,
      "extract_team": true,
      "extract_company_info": true,
      "product_description": "string",
      "icp_description": "string"
    },
    "spidercompanydata": {
      "enabled": true,
      "country": "auto",
      "include_financials": false
    },
    "spiderverify": {
      "enabled": true,
      "max_emails": 50
    },
    "spiderpeople": {
      "enabled": true,
      "max_employees": 20,
      "profile_mode": "short"
    }
  },
  "test": false
}'
Python
import httpx

resp = httpx.post(
    "https://spideriq.ai/api/v1/company-intel/batch",
    headers={"Authorization": "Bearer <token>", "Content-Type": "application/json"},
    json={"companies": [{"company_name": "string", "city": "string", "country_code": "string", "domain": "string", "linkedin_url": "string", "profile_mode": "short", "max_employees": 0, "config": {"discovery": {"enabled": {}}, "spidersite": {"enabled": {}, "mode": {}, "max_pages": {}, "extract_team": {}, "extract_company_info": {}, "product_description": {}, "icp_description": {}}, "spidercompanydata": {"enabled": {}, "country": {}, "include_financials": {}}, "spiderverify": {"enabled": {}, "max_emails": {}}, "spiderpeople": {"enabled": {}, "max_employees": {}, "profile_mode": {}}}, "test": false}], "profile_mode": "short", "max_employees": 0, "config": {"discovery": {"enabled": true}, "spidersite": {"enabled": true, "mode": "leads", "max_pages": 25, "extract_team": true, "extract_company_info": true, "product_description": "string", "icp_description": "string"}, "spidercompanydata": {"enabled": true, "country": "auto", "include_financials": false}, "spiderverify": {"enabled": true, "max_emails": 50}, "spiderpeople": {"enabled": true, "max_employees": 20, "profile_mode": "short"}}, "test": false},
)
resp.raise_for_status()
print(resp.json())
JavaScript
const resp = await fetch("https://spideriq.ai/api/v1/company-intel/batch", {
  method: "POST",
  headers: { "Authorization": "Bearer <token>", "Content-Type": "application/json" },
  body: JSON.stringify({"companies": [{"company_name": "string", "city": "string", "country_code": "string", "domain": "string", "linkedin_url": "string", "profile_mode": "short", "max_employees": 0, "config": {"discovery": {"enabled": {}}, "spidersite": {"enabled": {}, "mode": {}, "max_pages": {}, "extract_team": {}, "extract_company_info": {}, "product_description": {}, "icp_description": {}}, "spidercompanydata": {"enabled": {}, "country": {}, "include_financials": {}}, "spiderverify": {"enabled": {}, "max_emails": {}}, "spiderpeople": {"enabled": {}, "max_employees": {}, "profile_mode": {}}}, "test": false}], "profile_mode": "short", "max_employees": 0, "config": {"discovery": {"enabled": true}, "spidersite": {"enabled": true, "mode": "leads", "max_pages": 25, "extract_team": true, "extract_company_info": true, "product_description": "string", "icp_description": "string"}, "spidercompanydata": {"enabled": true, "country": "auto", "include_financials": false}, "spiderverify": {"enabled": true, "max_emails": 50}, "spiderpeople": {"enabled": true, "max_employees": 20, "profile_mode": "short"}}, "test": false})
});
const data = await resp.json();
console.log(data);
Go
package main

import (
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{"companies": [{"company_name": "string", "city": "string", "country_code": "string", "domain": "string", "linkedin_url": "string", "profile_mode": "short", "max_employees": 0, "config": {"discovery": {"enabled": {}}, "spidersite": {"enabled": {}, "mode": {}, "max_pages": {}, "extract_team": {}, "extract_company_info": {}, "product_description": {}, "icp_description": {}}, "spidercompanydata": {"enabled": {}, "country": {}, "include_financials": {}}, "spiderverify": {"enabled": {}, "max_emails": {}}, "spiderpeople": {"enabled": {}, "max_employees": {}, "profile_mode": {}}}, "test": false}], "profile_mode": "short", "max_employees": 0, "config": {"discovery": {"enabled": true}, "spidersite": {"enabled": true, "mode": "leads", "max_pages": 25, "extract_team": true, "extract_company_info": true, "product_description": "string", "icp_description": "string"}, "spidercompanydata": {"enabled": true, "country": "auto", "include_financials": false}, "spiderverify": {"enabled": true, "max_emails": 50}, "spiderpeople": {"enabled": true, "max_employees": 20, "profile_mode": "short"}}, "test": false}`)
	req, _ := http.NewRequest("POST", "https://spideriq.ai/api/v1/company-intel/batch", body)
	req.Header.Set("Authorization", "Bearer <token>")
	req.Header.Set("Content-Type", "application/json")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}

Responses

StatusDescription
201Successful Response
422Validation Error