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

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

/labor-market-intelligence/by-cip

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

primaryApiKey

X-API-KeystringRequired

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

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.

• State: Use FIPS code (e.g., 06 for California)
• MSA: Use MSA code (e.g., 41860 for San Francisco)

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: true

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.mapademics.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 141

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

{
  "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": 5,
            "factors": [
              "Bright Outlook",
              "In-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

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

/labor-market-intelligence/by-soc

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

primaryApiKey

X-API-KeystringRequired

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

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.

• State: Use FIPS code (e.g., 06 for California)
• MSA: Use MSA code (e.g., 41860 for San Francisco)

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: true

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.mapademics.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 141

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

{
  "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": 5,
            "factors": [
              "Bright Outlook"
            ],
            "growthPercentile": 92,
            "openingsPercentile": 80
          }
        },
        "skillRequirements": {
          "coreSkills": [],
          "relevantSkills": [],
          "transferableSkills": []
        }
      }
    ],
    "warnings": [
      {
        "code": "INVALID_SOC_CODE",
        "message": "SOC code '15-1253' was not found in the database",
        "socCode": "15-1253"
      }
    ]
  },
  "meta": {
    "requestId": "req_def456uvw",
    "timestamp": "2025-01-30T12:05:00Z"
  }
}

List available regions

get

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

/labor-market-intelligence/regions

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

Authorizations

primaryApiKey

X-API-KeystringRequired

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

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.mapademics.com
X-API-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"
  }
}