API ReferenceLead FinderSearch companies
POST/v2/campaigns/lead-finder/search-company

Search companies

Searches the same licensed database for companies instead of people — by domain, name, industry, size, or location.

Stablescope: write API KeyLearn about API scopes →

Costs 1 credit per page, refunded on zero results

Same charging model as Search people.

Request

AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Parameters

FieldTypeRequiredDescription
domainstringOptionalCompany domain.
companyNamestringOptionalCompany name (fuzzy-matched).
industrystring[]OptionalUp to 20 industry values.
headcountRangestring[]OptionalUp to 20 company-size bucket values.
locationstring[]OptionalUp to 20 HQ location values.
pagenumberOptional1–1000. Defaults to 1.
curl -X POST "https://api.stynar.com/v2/campaigns/lead-finder/search-company" \
  -H "Authorization: Bearer esk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"industry":["Software"],"headcountRange":["51-200"]}'

Response

✓ 200 OK
200 response
{
  "results": [
    {
      "companyId": "cmp_prs_9f8e7d",
      "name": "Acme Inc",
      "domain": "acme.com",
      "website": "https://acme.com",
      "logoUrl": null,
      "industry": "Software",
      "employeeCount": 120,
      "employeeRange": "51-200",
      "location": "Austin, United States",
      "linkedinUrl": "https://linkedin.com/company/acme",
      "founded": 2015,
      "revenuePrinted": "10M-50M",
      "type": "Private"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 3,
    "totalCount": 54
  }
}

Response fields

Errors

StatusCodeMeaning
✕ 402 INSUFFICIENT_CREDITSNot enough credits for this search.
✕ 503 SERVICE_UNAVAILABLELead search isn't configured, or the monthly provider budget is exhausted.
✕ 401 UnauthorizedUNAUTHORIZEDMissing, malformed, unknown, revoked, or expired key.
✕ 403 ForbiddenAPI_ACCESS_DISABLEDAPI access is turned off for your account.
✕ 403 ForbiddenINSUFFICIENT_SCOPEThe key doesn't have the scope this endpoint requires.
✕ 404 Not FoundNOT_FOUNDUnknown route, or a resource that doesn't exist / isn't yours.
✕ 409 ConflictCONFLICTThe action can't be applied to the resource's current state.
✕ 429 Too Many RequestsRATE_LIMIT_EXCEEDEDPer-minute or per-second limit hit.
✕ 429 Too Many RequestsQUOTA_EXCEEDEDMonthly quota exhausted.
✕ 500 Internal Server ErrorINTERNAL_ERRORSomething broke on Stynar's end.
Full error reference →