Skills Library

Browse and search the Mapademics Skills Library (MSL) containing 585 skills organized into 33 domains.

List skills

get

https://embedded-api.mapademics.com/v1https://embedded-api.testing.mapademics.com/v1

/skills

Returns a paginated list of skills from the Mapademics Skills Library (MSL). Use query parameters to filter and paginate results.

Authorizations

primaryApiKey

X-API-KeystringRequired

Primary API key for authentication. Format: pk_live_xxx (production) or pk_test_xxx (testing).

Query parameters

domainIdstringOptional

Filter skills by domain ID

Example: msl_dom_8

limitinteger · min: 1 · max: 100Optional

Maximum number of skills to return (1-100)

Default: 25

offsetintegerOptional

Number of skills to skip for pagination

Default: 0

Responses

200

List of skills

application/json

401

Missing or invalid API key

application/json

403

Access denied (insufficient permissions or quota exceeded)

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/skills

HTTPcURLJavaScriptPython

GET /v1/skills HTTP/1.1
Host: embedded-api.mapademics.com
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "object": "list",
  "data": [
    {
      "id": "msl_skill_0001",
      "version": "1.0",
      "domainId": "msl_dom_1",
      "name": "Accounting",
      "description": "Apply accounting principles to analyze financial information and prepare reports.",
      "exampleTasks": [
        "Prepare financial statements",
        "Analyze budget variances",
        "Record journal entries"
      ]
    }
  ],
  "meta": {
    "requestId": "req_abc123def",
    "timestamp": "2025-01-30T12:00:00Z"
  },
  "pagination": {
    "total": 585,
    "limit": 25,
    "offset": 0,
    "hasMore": true
  }
}

Get a skill

get

https://embedded-api.mapademics.com/v1https://embedded-api.testing.mapademics.com/v1

/skills/{skillId}

Returns detailed information about a specific skill by ID.

Authorizations

primaryApiKey

X-API-KeystringRequired

Primary API key for authentication. Format: pk_live_xxx (production) or pk_test_xxx (testing).

Path parameters

skillIdstringRequired

The skill ID (e.g., msl_skill_0001)

Example: msl_skill_0127

Responses

200

Skill details

application/json

401

Missing or invalid API key

application/json

403

Access denied (insufficient permissions or quota exceeded)

application/json

404

Resource not found

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/skills/{skillId}

HTTPcURLJavaScriptPython

GET /v1/skills/{skillId} HTTP/1.1
Host: embedded-api.mapademics.com
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "object": "skill",
  "data": {
    "id": "msl_skill_0127",
    "version": "1.0",
    "domainId": "msl_dom_15",
    "name": "Software Development",
    "description": "Design, code, test, and maintain software applications using programming languages and development frameworks.",
    "exampleTasks": [
      "Write clean, maintainable code",
      "Debug and fix software issues",
      "Implement new features from requirements",
      "Conduct code reviews"
    ],
    "domain": {
      "id": "msl_dom_15",
      "name": "Information Technology",
      "version": "1.0"
    }
  },
  "meta": {
    "requestId": "req_def456ghi",
    "timestamp": "2025-01-30T12:00:00Z"
  }
}

Search skills

get

https://embedded-api.mapademics.com/v1https://embedded-api.testing.mapademics.com/v1

/skills/search

Full-text search across skill names, descriptions, and example tasks. Returns skills ranked by relevance to the search query.

Authorizations

primaryApiKey

X-API-KeystringRequired

Primary API key for authentication. Format: pk_live_xxx (production) or pk_test_xxx (testing).

Query parameters

qstring · min: 2Required

Search query string

Example: data analysis

limitinteger · min: 1 · max: 50Optional

Maximum number of results (1-50)

Default: 10

Responses

200

Search results

application/json

400

Invalid request parameters

application/json

401

Missing or invalid API key

application/json

403

Access denied (insufficient permissions or quota exceeded)

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/skills/search

HTTPcURLJavaScriptPython

GET /v1/skills/search?q=text HTTP/1.1
Host: embedded-api.mapademics.com
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "object": "list",
  "data": [
    {
      "id": "msl_skill_0089",
      "version": "1.0",
      "domainId": "msl_dom_8",
      "name": "Data Analysis",
      "description": "Collect, process, and analyze data to identify patterns and insights.",
      "exampleTasks": [
        "Analyze datasets using statistical methods",
        "Create visualizations to communicate findings"
      ],
      "relevanceScore": 0.98
    },
    {
      "id": "msl_skill_0091",
      "version": "1.0",
      "domainId": "msl_dom_8",
      "name": "Statistical Analysis",
      "description": "Apply statistical methods to analyze and interpret data.",
      "exampleTasks": [
        "Perform hypothesis testing",
        "Build regression models"
      ],
      "relevanceScore": 0.85
    }
  ],
  "meta": {
    "requestId": "req_ghi789jkl",
    "timestamp": "2025-01-30T12:00:00Z"
  }
}

List all domains

get

https://embedded-api.mapademics.com/v1https://embedded-api.testing.mapademics.com/v1

/skills/domains

Returns all skill domains in the Mapademics Skills Library.

Authorizations

primaryApiKey

X-API-KeystringRequired

Primary API key for authentication. Format: pk_live_xxx (production) or pk_test_xxx (testing).

Responses

200

List of domains

application/json

401

Missing or invalid API key

application/json

403

Access denied (insufficient permissions or quota exceeded)

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/skills/domains

HTTPcURLJavaScriptPython

GET /v1/skills/domains HTTP/1.1
Host: embedded-api.mapademics.com
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "object": "list",
  "data": [
    {
      "id": "msl_dom_1",
      "name": "Finance & Accounting",
      "version": "1.0",
      "skillCount": 24
    },
    {
      "id": "msl_dom_8",
      "name": "Data & Analytics",
      "version": "1.0",
      "skillCount": 18
    },
    {
      "id": "msl_dom_15",
      "name": "Information Technology",
      "version": "1.0",
      "skillCount": 32
    }
  ],
  "meta": {
    "requestId": "req_jkl012mno",
    "timestamp": "2025-01-30T12:00:00Z"
  }
}

Get a domain with its skills

get

https://embedded-api.mapademics.com/v1https://embedded-api.testing.mapademics.com/v1

/skills/domains/{domainId}

Returns a domain and all skills within that domain.

Authorizations

primaryApiKey

X-API-KeystringRequired

Primary API key for authentication. Format: pk_live_xxx (production) or pk_test_xxx (testing).

Path parameters

domainIdstringRequired

The domain ID (e.g., msl_dom_15)

Example: msl_dom_15

Responses

200

Domain with skills

application/json

401

Missing or invalid API key

application/json

403

Access denied (insufficient permissions or quota exceeded)

application/json

404

Resource not found

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/skills/domains/{domainId}

HTTPcURLJavaScriptPython

GET /v1/skills/domains/{domainId} HTTP/1.1
Host: embedded-api.mapademics.com
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "object": "text",
  "data": {
    "id": "msl_dom_15",
    "name": "Information Technology",
    "version": "1.0",
    "skillCount": 32,
    "skills": [
      {
        "id": "msl_skill_0127",
        "version": "1.0",
        "domainId": "msl_dom_15",
        "name": "Software Development",
        "description": "Design, code, test, and maintain software applications.",
        "exampleTasks": [
          "Write clean, maintainable code",
          "Debug and fix software issues"
        ]
      }
    ]
  },
  "meta": {
    "requestId": "req_abc123xyz",
    "timestamp": "2025-01-30T12:00:00Z"
  }
}

Get complete skill tree

get

https://embedded-api.mapademics.com/v1https://embedded-api.testing.mapademics.com/v1

/skills/tree

Returns the complete skills taxonomy organized by domain. Useful for building skill pickers or displaying the full hierarchy.

Authorizations

primaryApiKey

X-API-KeystringRequired

Primary API key for authentication. Format: pk_live_xxx (production) or pk_test_xxx (testing).

Responses

200

Complete skill tree

application/json

401

Missing or invalid API key

application/json

403

Access denied (insufficient permissions or quota exceeded)

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/skills/tree

HTTPcURLJavaScriptPython

GET /v1/skills/tree HTTP/1.1
Host: embedded-api.mapademics.com
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "object": "text",
  "data": {
    "version": "1.0",
    "totalDomains": 33,
    "totalSkills": 585,
    "domains": [
      {
        "id": "msl_dom_15",
        "name": "Information Technology",
        "version": "1.0",
        "skillCount": 32,
        "skills": [
          {
            "id": "msl_skill_0127",
            "version": "1.0",
            "domainId": "msl_dom_15",
            "name": "Software Development",
            "description": "Design, code, test, and maintain software applications.",
            "exampleTasks": [
              "Write clean, maintainable code",
              "Debug and fix software issues"
            ]
          }
        ]
      }
    ]
  },
  "meta": {
    "requestId": "req_abc123xyz",
    "timestamp": "2025-01-30T12:00:00Z"
  }
}