Search skills

Search the Fribl skills taxonomy by keyword. Filter by skill type and control the number of results returned. Use the Accept-Language header to receive skill names in a specific language. This endpoint does not require authentication.

GET /skills/search

Search skills

cURL

curl --request GET \
  --url https://api-service.fribl.co/api/v1/skills/search

200

{
  "query": "<string>",
  "language": "<string>",
  "results": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "skill": "JavaScript",
      "explanation": "Candidate demonstrates strong JavaScript proficiency"
    }
  ],
  "total": 123
}

Headers

Accept-Language · string

Language code for skill name translation (e.g., en, fr, it). Use the /skills/languages endpoint to retrieve available language codes.

Query Parameters

query · string · required

Search query string. Must be at least 2 characters.

Minimum string length: 2

type · enum<string>

Filter results by skill type.

Available options: hard-skill, soft-skill

limit · integer · default: 50

Maximum number of results to return.

Required range: 1 <= x <= 200

Response

200

application/json

Matching skills.

query · string · required

The search query that was executed.

language · string · required

The language used for skill name translation.

results · object[] · required

Show child attributes

total · integer · required

Total number of matching skills.