API reference · Lookups

Find skills by prefix

GEThttps://trawle.com/v1/skills

Bundled skill names, slugs and aliases; exact matches precede prefix matches. Skill slugs describe JobDetail.skills and taxonomy terms; JobQuery does not currently support a skills filter.

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

prefixstringrequired
Skill name or alias prefix.
Limits
1 to 100 characters
Example
react
limitintegeroptional
Default
8
Limits
1 to 20

Responses

200Matching skill names, slugs and kinds.SkillLookup

itemsarray<object> · Skillrequired
3 propertiesper item
- slugstringrequired
- namestringrequired
- kindstringrequired
  One of
  languageframeworklibrarydatabasecloudplatformtoolmethodologycertificationdomainsoftother

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

PreviousResolve occupations and classification codes NextDiscover job families and allowed filter values

GET /v1/skills

curl "https://trawle.com/v1/skills?prefix=react" \
  -H "x-api-key: $TRAWLE_API_KEY"

Response

{
  "items": [
    {
      "slug": "string",
      "name": "string",
      "kind": "language"
    }
  ]
}