trawledevelopers
API reference · Lookups

Find roles for the roles filter

GEThttps://trawle.com/v1/roles

Roles whose name or common job titles match q ("react" finds Frontend Engineer). Use items[].slug in JobQuery.roles.

Parameters

Query

  • qstringrequired

    Role or job title.

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

Responses

200Best matches first.
  • itemsarray<object> · RoleMatchrequired
    4 propertiesper item
    • slugstringrequired
    • namestringrequired
    • familyany · Refrequired

      Same shape as its parent (Ref).

    • 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
PreviousFind places (GeoNames) for the places filterNextList job families for the families filter