GET
/
api
/
search
/
companies
curl --request GET \
  --url https://search.linkd.inc/api/search/companies \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "id": 55,
      "company_name": "Edgewater Markets",
      "company_type": "Privately Held",
      "company_website": "http://www.edgewatermarkets.com",
      "company_website_domain": "edgewatermarkets.com",
      "headquarters": "New York, New York, United States",
      "hq_country": "United States",
      "employee_count_range": "51-200",
      "linkedin_company_description": "Edgewater is a leading trading technology provider...",
      "linkedin_profile_url": "https://www.linkedin.com/company/edgewater-markets",
      "linkedin_logo_url": "https://media.licdn.com/dms/image/example.jpg",
      "criteria": {
        "tech companies": "YES",
        "in New York": "YES",
        "financial industry": "YES"
      }
    }
  ],
  "total": 1,
  "query": "tech companies in New York in the financial industry"
}

Search through company databases using natural language queries. The system evaluates companies against multiple criteria including industry, size, location, and business focus with a customizable acceptance threshold.

​
Search Companies

curl -X GET "https://search.linkd.inc/api/search/companies?query=AI startups in healthcare&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Query Parameters

ParameterTypeRequiredDescription
querystringYesNatural language search query
limitintegerNoMaximum number of results (default: 30, max: 100)
acceptance_thresholdintegerNoMatch score threshold 0-100 (default: 73)

​
Examples

Basic Search:

curl -X GET "https://search.linkd.inc/api/search/companies?query=fintech startups" \
  -H "Authorization: Bearer YOUR_API_KEY"

Search with Custom Threshold:

curl -X GET "https://search.linkd.inc/api/search/companies?query=manufacturing companies&acceptance_threshold=85" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "results": [
    {
      "id": 55,
      "company_name": "TechCorp Solutions",
      "company_type": "Privately Held",
      "company_website": "https://techcorp.com",
      "company_website_domain": "techcorp.com",
      "headquarters": "San Francisco, CA, United States",
      "hq_country": "United States",
      "employee_count_range": "51-200",
      "linkedin_company_description": "Leading provider of AI-powered healthcare solutions...",
      "linkedin_profile_url": "https://www.linkedin.com/company/techcorp-solutions",
      "linkedin_logo_url": "https://media.licdn.com/dms/image/company-logo.jpg",
      "year_founded": "2018",
      "crunchbase_category": "Healthcare Technology",
      "linkedin_industry": "Hospital & Health Care",
      "linkedin_speciality": "Artificial Intelligence, Healthcare, Medical Devices",
      "linkedin_headcount": 125,
      "criteria": {
        "AI technology focus": "YES",
        "Healthcare industry": "YES",
        "Startup/Growth stage": "YES"
      }
    }
  ],
  "total": 1,
  "query": "AI startups in healthcare"
}

​
Query Examples

QueryDescription
”SaaS companies in California”Software-as-a-Service companies in California
”manufacturing companies with 500+ employees”Large manufacturing companies
”fintech startups Series A”Financial technology startups with Series A funding
”e-commerce companies in retail”Online retail and e-commerce businesses
”biotech companies with recent funding”Biotechnology companies with recent investment

​
Company Data Fields

FieldDescription
company_nameOfficial company name
company_typeBusiness type (Public, Private, etc.)
headquartersPrimary business location
employee_count_rangeEmployee size range (e.g., “51-200”)
linkedin_industryIndustry classification from LinkedIn
linkedin_specialityCompany specialties and focus areas
year_foundedYear the company was established
criteriaAI-generated match criteria and confidence

​
Error Responses

Status CodeDescription
400Bad Request - Invalid parameters or limit exceeded
401Unauthorized - API key missing or invalid
402Payment Required - Insufficient credits
422Validation Error - Missing required ‘query’ parameter
500Internal Server Error - Search processing error
503Service Unavailable - Search service temporarily down

​
Notes

  • Each result costs 1 credit
  • Companies are matched using AI-powered criteria evaluation
  • Criteria show match confidence: YES, MAYBE, NO
  • Higher acceptance thresholds return fewer but more relevant results
  • Results include LinkedIn, Crunchbase, and proprietary company data
  • Funding and headcount data updated regularly

Authorizations

​
Authorization
string
header
required

API key must be provided as a Bearer token in the Authorization header. Example: lk_your_api_key_here

Query Parameters

​
query
string
required

The search query string. Examples:

  • Tech companies in California
  • Fintech startups with over 100 employees
  • Manufacturing companies in the automotive industry
  • Healthcare companies with recent funding
  • AI research companies in biotech
​
limit
integer
default:10

Maximum number of results to return.

Required range: x <= 30
​
acceptance_threshold
integer
default:73

Minimum match score threshold (0-100). Defaults to 73.

Required range: 0 <= x <= 100

Response

200
application/json

Successful company search operation

The response is of type object.