trawledevelopers
API reference · Signals

Search recent company hiring signals and their supporting jobs

GEThttps://trawle.com/v1/signals/search

Evidence-backed observations from available daily snapshots in the last seven UTC dates. Filter by company slug, kind, text or inclusive since date. Missing observation days are not zero activity. Counts describe recorded postings, not net headcount. Closed listings do not prove a hire; new job locations do not prove market entry. Product/project inference is not included. Data by Trawle: https://trawle.com/radar

Authentication

Header x-api-key: Read-only API key from https://trawle.com/account#api-keys. 1,000 requests per daily window. Anonymous requests are also supported with a per-IP limit.

Parameters

Query

  • qstringoptional
    Limits
    at most 120 characters
  • kindstring · SignalKindoptional
    One of
    department_scalingfirst_in_familymarket_entryleadership_openedleadership_filledhard_to_fillhiring_slowdown
  • companystringoptional
    Limits
    pattern ^[a-z0-9][a-z0-9-]{0,79}$
  • sincestring<date>optional
  • cursorstringoptional
    Limits
    at most 1500 characters
  • limitintegeroptional
    Default
    25
    Limits
    1 to 50

Responses

200Newest observations first, with coverage and pagination.SignalSearchResult
  • statusstringrequired
    One of
    readycollectingnot_configured
  • dataDatestring<date> | nullrequired
  • windowStartstring<date>required
  • windowEndstring<date>required
  • observedDaysarray<string>required
  • legacyEventsSkippedintegerrequired

    Pre-UUID events excluded because their historical ids cannot safely resolve to current postings.

    Limits
    at least 0
  • itemsarray<object> · HiringSignalrequired
    10 propertiesper item
    • keystringrequired

      Stable event key, not a job or company id.

    • daystring<date>required
    • kindstring · SignalKindrequired
      One of
      department_scalingfirst_in_familymarket_entryleadership_openedleadership_filledhard_to_fillhiring_slowdown
    • companyobjectrequired
      3 properties
      • slugstringrequired
      • namestringrequired
      • domainstring | nullrequired
    • familyobject | nullrequired
      2 properties
      • slugstringrequired
      • namestringrequired
    • countryobject | nullrequired
      2 properties
      • codestringrequired
      • namestringrequired
    • titlestringrequired
    • observationstringrequired
    • interpretationstringrequired
    • evidencearray<object>required
      5 propertiesper item
      • idstring<uuid>required
      • titlestringrequired
      • urlstring<uri>required
      • sourceUrlstring<uri>required
      • closedAtstring<date-time> | nullrequired
  • totalintegerrequired
    Limits
    at least 0
  • nextCursorstring | nullrequired
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
401Invalid, expired or revoked API key.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
429Rate limit reached. Respect Retry-After and cache results.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
503Signal storage is temporarily unavailable or contains malformed current-format data.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
PreviousFind companies by name or domain