Quick Start

SkillsAPI is distributed via RapidAPI. Head to https://rapidapi.com/AETHAR/api/skillsapi-skills-labor-market-intelligence and subscribe to the Free plan — 100 requests per day, no credit card required.

RapidAPI handles billing, key issuance, and usage analytics. Upgrading or downgrading a plan takes effect immediately.

After subscribing, RapidAPI shows your personal X-RapidAPI-Key in the right-hand Code Snippets pane. This is the key you send on every request — keep it secret, never commit it to git, never embed it in client-side code.

If you're calling SkillsAPI directly (not through the RapidAPI gateway) — for enterprise customers with a private contract — you'll receive an Aethar-issued key with the prefix sk_ and use the header X-API-Key instead. This guide assumes the RapidAPI path; swap headers if you're on the direct path.

Fetch the full taxonomy entry for the *Data Scientist* occupation, including skills, abilities, and SOC code:

curl -X GET "https://skillsapi-skills-labor-market-intelligence.p.rapidapi.com/v1/occupations/data-scientist" \
  -H "X-RapidAPI-Key: your_rapidapi_key" \
  -H "X-RapidAPI-Host: skillsapi-skills-labor-market-intelligence.p.rapidapi.com"

You should see a 200 response with the canonical occupation name, SOC code, O*NET ID, ESCO mapping, ranked skill list with importance and proficiency scores, and the upstream source for each field (O*NET, ESCO, Lightcast Open Skills, or BLS SOC).

Browse the full endpoint reference in the left sidebar. The main tags are Occupations (occupation lookup, profile, fuzzy search), Skills (skill taxonomy, related-skills graph, importance ranking), and Career (career path planning, transition feasibility, agent-first endpoints like *what should I learn next?* and *which roles match my skill set?*).

For production workloads, read the Rate Limits and Errors guides to handle non-200 responses gracefully, and the Data Sources guide to understand what your data actually means.