trawledevelopers
API reference · Companies

Find companies by name or domain

GEThttps://trawle.com/v1/companies

Parameters

Query

  • qstringrequired

    Company name or domain.

    Limits
    1 to 100 characters
    Example
    stripe
  • limitintegeroptional
    Default
    8
    Limits
    1 to 20

Responses

200Best matches first.
  • itemsarray<object> · CompanyMatchrequired
    5 propertiesper item
    • slugstringrequired
      Example
      stripe
    • namestringrequired
      Example
      Stripe
    • domainstring | nullrequired
      Example
      stripe.com
    • industrystring | nullrequired
    • openJobsintegerrequired
400Invalid request: see error.issues and error.hint.Error
  • errorobjectrequired
    4 properties
    • codestringrequired

      Machine-readable: invalid_request, not_found, forbidden, rate_limited, internal.

      Example
      invalid_request
    • messagestringrequired
      Example
      places: expected an array of GeoNames ids
    • hintstringoptional

      What to do next, e.g. which lookup to call first.

      Example
      Resolve place names to ids with GET /v1/places?q=
    • issuesarray<object>optional

      Validation problems, one per invalid field.

      2 propertiesper item
      • pathstringrequired
      • messagestringrequired
PreviousGet a company and its hiring activityNextFind places (GeoNames) for the places filter