Labor Market Intelligence

Access occupation data, salary information, employment projections, and skills requirements based on CIP (Classification of Instructional Programs) codes or SOC (Standard Occupational Classification) codes.

Get matched occupations for CIP codes

post

Returns occupation data for one or more CIP (Classification of Instructional Programs) codes. Includes labor market data (salary, employment, projections) and skill requirements for each matched occupation.

Authorizations

bearerAuth & customerKey

AuthorizationstringRequired

Platform API key passed as a Bearer token in the Authorization header. Use your test key for the testing environment and your production key for production.

X-Customer-KeystringRequired

End-customer API key identifying which customer is making the request. Required for all production calls. Not required for the testing environment. Provision these in the Embedded API Portal.

Body

application/json

cipCodesstring[]Required

One or more CIP codes. Use 6-digit format with period (e.g., 11.0701). Maximum 25 codes per request.

Example: ["11.0701","11.0101"]

regionTypestring · enumOptional

Type of geographic region for labor market data

Default: nationalPossible values:

regionstringOptional

Region code. Required when regionType is state or msa. Returns 400 INVALID_INPUT if the code does not match a known region for the given regionType.

• State: Use FIPS code (e.g., 6 for California)
• MSA: Use MSA code (e.g., 41860 for San Francisco) Use GET /v1/labor-market-intelligence/regions to list valid codes.

fieldsstring[]Optional

Sparse fieldsets - list of fields to include. Reduces response size when you only need specific data.

Example: ["name","socCode","laborMarketData"]

includeSkillsbooleanOptional

Whether to include skill requirements in the response

Default: false

fallbackFromMsaToStatebooleanOptional

When regionType is "msa" and MSA-level employment projection data is unavailable, fall back to state-level data. When true, a MSA_TO_STATE_PROJECTION_FALLBACK warning is included for each occupation where fallback was used. Has no effect for national or state queries.

Default: false

Responses

200

Successful response with matched occupations

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

404

Resource not found

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

post

/labor-market-intelligence/by-cip

HTTPcURLJavaScriptPython

POST /v1/labor-market-intelligence/by-cip HTTP/1.1
Host: embedded-api-sandbox.mapademics.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Customer-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 173

{
  "cipCodes": [
    "11.0701",
    "11.0101"
  ],
  "regionType": "national",
  "region": "text",
  "fields": [
    "name",
    "socCode",
    "laborMarketData"
  ],
  "includeSkills": false,
  "fallbackFromMsaToState": false
}

{
  "object": "cip_labor_market",
  "data": {
    "cipCodes": [
      "11.0701"
    ],
    "regionType": "national",
    "region": "United States",
    "matchedOccupations": [
      {
        "name": "Software Developers",
        "description": "Research, design, and develop computer and network software or specialized utility programs.",
        "socCode": "15-1252",
        "alternativeTitles": [
          "Software Engineer",
          "Application Developer",
          "Backend Developer"
        ],
        "laborMarketData": {
          "medianAnnualSalary": 127260,
          "totalEmployment": 1795300,
          "forecastedEmploymentGrowth": 0.252,
          "averageAnnualOpenings": 0.174,
          "typicalDegreeLevel": "Bachelor's degree",
          "typicalWorkExperience": "None",
          "demand": {
            "score": 2,
            "factors": [
              "Rapid Growth",
              "High Hiring Demand"
            ],
            "growthPercentile": 95,
            "openingsPercentile": 85
          }
        },
        "skillRequirements": {
          "coreSkills": [
            {
              "mslSkillId": "msl_skill_0127",
              "mslSkillName": "Software Development",
              "mslSkillDescription": "Design, code, test, and maintain software applications."
            }
          ],
          "relevantSkills": [
            {
              "mslSkillId": "msl_skill_0134",
              "mslSkillName": "Database Management",
              "mslSkillDescription": "Design and manage database systems."
            }
          ],
          "transferableSkills": [
            {
              "mslSkillId": "msl_skill_0412",
              "mslSkillName": "Problem Solving",
              "mslSkillDescription": "Identify problems and determine effective solutions."
            }
          ]
        }
      }
    ]
  },
  "meta": {
    "requestId": "req_abc123xyz",
    "timestamp": "2025-01-30T12:00:00Z"
  }
}

Get occupation data for SOC codes

post

Returns occupation data for one or more SOC (Standard Occupational Classification) codes. Includes labor market data (salary, employment, projections) and skill requirements.

Use this endpoint when you already know the specific occupation codes you want data for.

Authorizations

bearerAuth & customerKey

AuthorizationstringRequired

Platform API key passed as a Bearer token in the Authorization header. Use your test key for the testing environment and your production key for production.

X-Customer-KeystringRequired

End-customer API key identifying which customer is making the request. Required for all production calls. Not required for the testing environment. Provision these in the Embedded API Portal.

Body

application/json

socCodesstring[]Required

One or more SOC codes. Use 6-digit format (e.g., 15-1252). Maximum 25 codes per request.

Example: ["15-1252","15-1253"]

regionTypestring · enumOptional

Type of geographic region for labor market data

Default: nationalPossible values:

regionstringOptional

Region code. Required when regionType is state or msa. Returns 400 INVALID_INPUT if the code does not match a known region for the given regionType.

• State: Use FIPS code (e.g., 6 for California)
• MSA: Use MSA code (e.g., 41860 for San Francisco) Use GET /v1/labor-market-intelligence/regions to list valid codes.

fieldsstring[]Optional

Sparse fieldsets - list of fields to include. Reduces response size when you only need specific data.

Example: ["name","socCode","laborMarketData"]

includeSkillsbooleanOptional

Whether to include skill requirements in the response

Default: false

fallbackFromMsaToStatebooleanOptional

When regionType is "msa" and MSA-level employment projection data is unavailable, fall back to state-level data. When true, a MSA_TO_STATE_PROJECTION_FALLBACK warning is included for each occupation where fallback was used. Has no effect for national or state queries.

Default: false

Responses

200

Successful response with occupation data

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

post

/labor-market-intelligence/by-soc

HTTPcURLJavaScriptPython

POST /v1/labor-market-intelligence/by-soc HTTP/1.1
Host: embedded-api-sandbox.mapademics.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Customer-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 173

{
  "socCodes": [
    "15-1252",
    "15-1253"
  ],
  "regionType": "national",
  "region": "text",
  "fields": [
    "name",
    "socCode",
    "laborMarketData"
  ],
  "includeSkills": false,
  "fallbackFromMsaToState": false
}

{
  "object": "soc_labor_market",
  "data": {
    "socCodes": [
      "15-1252",
      "15-1253"
    ],
    "regionType": "state",
    "region": "California",
    "matchedOccupations": [
      {
        "name": "Software Developers",
        "description": "Research, design, and develop computer and network software.",
        "socCode": "15-1252",
        "alternativeTitles": [
          "Software Engineer"
        ],
        "laborMarketData": {
          "medianAnnualSalary": 146770,
          "totalEmployment": 282100,
          "forecastedEmploymentGrowth": 0.185,
          "averageAnnualOpenings": 0.162,
          "typicalDegreeLevel": "Bachelor's degree",
          "typicalWorkExperience": "None",
          "demand": {
            "score": 1,
            "factors": [
              "Rapid Growth"
            ],
            "growthPercentile": 92,
            "openingsPercentile": 80
          }
        },
        "skillRequirements": {
          "coreSkills": [],
          "relevantSkills": [],
          "transferableSkills": []
        }
      }
    ],
    "warnings": [
      {
        "code": "INVALID_SOC_CODE",
        "message": "SOC code '15-1253' was not found in the database",
        "value": "15-1253"
      }
    ]
  },
  "meta": {
    "requestId": "req_def456uvw",
    "timestamp": "2025-01-30T12:05:00Z"
  }
}

List available regions

get

Returns a list of all available geographic regions for labor market data queries. Includes national, state, and metropolitan statistical area (MSA) options.

Authorizations

bearerAuth & customerKey

AuthorizationstringRequired

Platform API key passed as a Bearer token in the Authorization header. Use your test key for the testing environment and your production key for production.

X-Customer-KeystringRequired

End-customer API key identifying which customer is making the request. Required for all production calls. Not required for the testing environment. Provision these in the Embedded API Portal.

Query parameters

typestring · enumOptional

Filter regions by type

Possible values:

Responses

200

List of available regions

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

/labor-market-intelligence/regions

HTTPcURLJavaScriptPython

GET /v1/labor-market-intelligence/regions HTTP/1.1
Host: embedded-api-sandbox.mapademics.com
Authorization: Bearer YOUR_SECRET_TOKEN
X-Customer-Key: YOUR_API_KEY
Accept: */*

{
  "object": "list",
  "data": [
    {
      "type": "national",
      "code": "99",
      "label": "United States"
    },
    {
      "type": "state",
      "code": "06",
      "label": "California"
    },
    {
      "type": "state",
      "code": "48",
      "label": "Texas"
    },
    {
      "type": "msa",
      "code": "41860",
      "label": "San Francisco-Oakland-Berkeley, CA"
    }
  ],
  "meta": {
    "requestId": "req_ghi789rst",
    "timestamp": "2025-01-30T12:10:00Z"
  }
}