trawledevelopers
API reference · Jobs

Get a job

GEThttps://trawle.com/v1/jobs/{id}

One job, open or closed, with the company's hiring activity. Closed jobs have closedAt set.

Parameters

Path

  • idstringrequired
    Limits
    1 to 20 characters
    Example
    1234567

Responses

200The job.JobDetail
  • idstringrequired

    Stable public id; never changes across scans.

    Example
    1234567
  • titlestringrequired
  • companyobjectrequired
    6 properties
    • slugstringrequired
      Example
      stripe
    • namestringrequired
      Example
      Stripe
    • domainstring | nullrequired
      Example
      stripe.com
    • openJobsintegerrequired
    • newLast30integerrequired
    • trendarray<integer>required

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

  • roleobject | null · Refrequired
    2 properties
    • slugstringrequired
    • namestringrequired
  • familyobject | null · Refrequired
    2 properties
    • slugstringrequired
    • namestringrequired
  • locationsarray<object> · PlaceRefrequired

    Where the job is located (or, for remote jobs, who may apply), most specific first.

    3 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
  • workplacestring | nullrequired
    One of
    remotehybridonsite
  • remoteScopestring | nullrequired

    For remote jobs: who may apply, in words ("Anywhere", "United States only").

  • senioritystring | nullrequired
    One of
    internentrymidseniorleadprincipaldirectorvpexecutive
  • employmentTypestring | nullrequired
    One of
    full_timepart_timecontracttemporaryinternshipapprenticeshipseasonalvolunteer
  • salaryobject | null · Salaryrequired

    Pay as the employer listed it (not converted).

    4 properties
    • mininteger | nullrequired
    • maxinteger | nullrequired
    • currencystring | nullrequired

      ISO 4217 code.

      Example
      EUR
    • periodstringrequired
      One of
      yearmonthweekdayhour
  • firstSeenAtstring<date-time>required

    First seen by Trawle under this id.

    Example
    2026-10-31T06:12:00.000Z
  • lastSeenAtstring<date-time>required

    Last time a daily scan saw it open on the employer's site.

    Example
    2026-10-31T06:12:00.000Z
  • postedAtstring<date-time> | nullrequired

    "Date posted" from the employer's ATS, when it has one. Often unreliable.

    Example
    2026-10-31T06:12:00.000Z
  • openSincestring<date-time>required

    First time any posting of this job (reposts included) was seen; days open count from here.

    Example
    2026-10-31T06:12:00.000Z
  • repostCountintegerrequired

    Earlier postings of this job under other ids, plus reopenings. 0 = original.

  • closedAtstring<date-time> | nullrequired

    When it disappeared; null while open.

    Example
    2026-10-31T06:12:00.000Z
  • applyUrlstringrequired

    The employer's own posting (their ATS).

  • urlstringrequired

    This job on Trawle.

  • departmentstring | nullrequired
  • summarystring | nullrequired

    One-paragraph summary (generated).

  • skillsarray<string>required
  • experienceYearsobject | nullrequired
    2 properties
    • mininteger | nullrequired
    • maxinteger | nullrequired
  • visaSponsorshipstring | nullrequired
    One of
    yesno
  • educationstring | nullrequired

    Minimum required degree, if stated.

    One of
    nonehigh_schoolvocationalassociatebachelormasterdoctorate
  • managesPeopleboolean | nullrequired

    Has direct reports (true), individual contributor (false), or not stated.

  • relocationboolean | nullrequired

    Relocation support offered (true), explicitly not (false), or not stated.

  • clearanceRequiredboolean | nullrequired

    A government security clearance is required (true), explicitly not (false), or not stated.

  • equityOfferedboolean | nullrequired

    Equity (stock options, RSUs) offered (true), explicitly not (false), or not stated.

  • languagesarray<string>required

    Required languages, ISO 639-1.

  • postingLanguagestring | nullrequired

    Language the posting is written in, ISO 639-1 (detected).

    Example
    en
  • sourcestringrequired

    The ATS the job was read from ("greenhouse").

    Example
    greenhouse
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
PreviousCheck whether jobs are still openNextIndex size and freshness