trawledevelopers
API reference · Companies

Get a company and its hiring activity

GEThttps://trawle.com/v1/companies/{slug}

Open jobs, new and closed jobs, median days open, repost share and a 90-day trend.

Parameters

Path

  • slugstringrequired
    Limits
    1 to 80 characters
    Example
    stripe

Responses

200The company.Company
  • slugstringrequired
    Example
    stripe
  • namestringrequired
    Example
    Stripe
  • domainstring | nullrequired
    Example
    stripe.com
  • descriptionstring | nullrequired
  • industrystring | nullrequired
  • hqobject | null · PlaceRefrequired
    3 properties
    • idintegerrequired

      GeoNames id (regions are negative).

    • namestringrequired
      Example
      Copenhagen
    • countrystring | nullrequired

      ISO 3166-1 alpha-2 country code; null for multi-country regions.

      Example
      DK
  • careersUrlstring | nullrequired
  • urlstringrequired

    This company on Trawle.

  • statsobjectrequired
    6 properties
    • openJobsintegerrequired
    • newLast7integerrequired
    • closedLast30integerrequired
    • medianDaysOpeninteger | nullrequired
    • repostSharenumberrequired

      Share of open jobs that are reposts (0–1).

    • trendarray<integer>required

      Open jobs per day, oldest first, the last 90 days.

  • familiesarray<object>required
    3 propertiesper item
    • slugstringrequired
    • namestringrequired
    • countintegerrequired
  • placesarray<object>required
    4 propertiesper item
    • idintegerrequired

      GeoNames id (regions are negative).

    • namestringrequired
      Example
      Copenhagen
    • countrystring | nullrequired

      ISO 3166-1 alpha-2 country code; null for multi-country regions.

      Example
      DK
    • countintegerrequired
404Not found.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
PreviousIndex size and freshnessNextFind companies by name or domain