Skills Database — searchable skill reference data

Skills Database API

What it does

Skills Database lets you search a skills catalog by name and page through results. Send a name query to filter matches, per_page to control how many records you receive, and include_related when you want related skills included in the response.

Each result includes a skill id, name, slug, and a related_skills array. Related skills are returned with their own id, name, slug, and weight, which makes it useful when you need to build skill taxonomies, autocomplete, or internal matching logic for hiring and learning products.

The response is paginated and includes data, meta, and links, so you can move through large skill lists without guessing at offsets. meta gives you the current page, total count, page size, and range information, while links provides first, last, previous, and next page URLs.

Use Skills Database when you need structured skill reference data for search, filtering, profile enrichment, or recommendation features.

{ "data": [ { "id": "df0d4541-2a03-49ba-aefc-6cb46f6cc26c", "name": "PHP", "slug": "php", "related_skills": [ { "id": "064887a2-1dc1-4523-9dc1-a7fa68d85f07", "name": "API Development", "slug": "api-development", "weight": 6 } ] } ], "links": { "first": "https://apyhub.com/api/v1/utilities/skills_list?name=PHP&include_related=true&page=1", "last": "https://apyhub.com/api/v1/utilities/skills_list?name=PHP&include_related=true&page=2", "prev": null, "next": "https://apyhub.com/api/v1/utilities/skills_list?name=PHP&include_related=true&page=2" }, "meta": { "current_page": 1, "from": 1, "last_page": 2, "links": [], "path": "https://apyhub.com/api/v1/utilities/skills_list", "per_page": 15, "to": 15, "total": 25 } }

About this endpoint

What it does

Retrieves a paginated list of skills from the skills database, optionally filtered by name and controlled with query parameters. The response returns skill records in data along with pagination information in links and meta.

Query Parameter(s)

Attribute	Type	Mandatory	Description
name	String	No	Filters skills by name.
per_page	String	No	Controls the number of items returned per page.
include_related	String	No	Controls whether related skills are included in each skill record.

Response

Returns a JSON object with required data, links, and meta fields. data is an array of skill objects, links is an object with pagination URLs, and meta is an object with pagination details.

Parameter	Type	Mandatory	Description
data	Object Array	Yes	Array of skill objects. Each item includes `id`, `name`, `slug`, and `related_skills`.
data[].id	String	Yes	Skill identifier.
data[].name	String	Yes	Skill name.
data[].slug	String	Yes	Skill slug.
data[].related_skills	Object Array	Yes	Array of related skill objects. Each item includes `id`, `name`, `slug`, and `weight`.
data[].related_skills[].id	String	Yes	Related skill identifier.
data[].related_skills[].name	String	Yes	Related skill name.
data[].related_skills[].slug	String	Yes	Related skill slug.
data[].related_skills[].weight	Integer	Yes	Related skill weight.
meta	Object	Yes	Pagination metadata object containing `current_page`, `from`, `last_page`, `links`, `path`, `per_page`, `to`, and `total`.
meta.current_page	Integer	Yes	Current page number.
meta.from	Integer	Yes	Starting item number for the current page.
meta.last_page	Integer	Yes	Last available page number.
meta.links	Object Array	Yes	Array of pagination link objects. Each item includes `url`, `label`, and `active`.
meta.links[].url	String	Yes	Pagination link URL. Can be null.
meta.links[].label	String	Yes	Pagination link label.
meta.links[].active	Boolean	Yes	Whether the link is active.
meta.path	String	Yes	Base path for the paginated resource.
meta.per_page	Integer	Yes	Number of items per page.
meta.to	Integer	Yes	Ending item number for the current page.
meta.total	Integer	Yes	Total number of items.
links	Object	Yes	Pagination navigation object containing `first`, `last`, `prev`, and `next`.
links.first	String	Yes	URL for the first page.
links.last	String	Yes	URL for the last page.
links.prev	String	Yes	URL for the previous page. Can be null.
links.next	String	Yes	URL for the next page.

Query parameters

Name

Type

Description

nameOPTIONAL

string

—

per_pageOPTIONAL

string

—

include_relatedOPTIONAL

string

—

Skills Database API

What it does

QUICKSTART

Quickstart

What you'll get back

About this endpoint

What it does

Query Parameter(s)

Response

Query parameters

Errors any endpoint can return