BeameryBeamery

Skills Management

Skills inventory, analysis, and optimization

All endpoints require authentication. Include your access token in the Authorization header: Authorization: Bearer your_access_token

InternalGET/v1/ja/skills

Get all skills

Retrieve all skills within a company with comprehensive filtering options

Query Parameters

  • Name
    group
    Type
    string
    Description

    Filter skills by group name

  • Name
    type
    Type
    string
    Description

    Filter skills by type (Topic, Behavioral, Software Tool, etc.)

  • Name
    limit
    Type
    integer
    Description

    Number of skills to return (default: 50, max: 100)

  • Name
    offset
    Type
    integer
    Description

    Number of skills to skip for pagination

Response

  • Name
    success
    Type
    boolean
    Description

    No description

  • Name
    data
    Type
    array<Skill>
    Description

    Array of skill objects

  • Name
    pagination
    Type
    object
    Description

    Pagination information

Request

GET
/v1/ja/skills
curl https://frontier.beamery.com/v1/ja/skills \
  -H "Authorization: Bearer your_access_token"

Response

{
  "success": true,
  "data": [
    {
      "id": "2e813466-3525-46e7-817c-6400f65d6717",
      "name": "Network Design",
      "description": "The planning and structuring of network systems to ensure efficient and secure communication within banking institutions.",
      "type": "Topic",
      "group": {
        "name": "IT Infrastructure Management",
        "type": "Technical"
      }
    }
  ],
  "pagination": {
    "total": 245,
    "limit": 50,
    "offset": 0,
    "hasMore": true
  }
}
InternalGET/v1/ja/skills/{skillId}

Get skill

Retrieve detailed skill information with related roles and tasks

Path Parameters

  • Name
    skillId
    Type
    string
    Description

    Unique identifier for the skill

Response

  • Name
    success
    Type
    boolean
    Description

    No description

  • Name
    data
    Type
    SkillDetails
    Description

    No description

Request

GET
/v1/ja/skills/{skillId}
curl https://frontier.beamery.com/v1/ja/skills/1bdce777-8888-49aa-bbcc-123456789012 \
  -H "Authorization: Bearer your_access_token"

Response

{
  "success": true,
  "entity": {
    "id": "2e813466-3525-46e7-817c-6400f65d6717",
    "name": "Network Design",
    "description": "The planning and structuring of network systems to ensure efficient and secure communication within banking institutions.",
    "type": "Topic",
    "group": {
      "name": "IT Infrastructure Management",
      "type": "Technical"
    }
  }
}
InternalPOST/v1/ja/skills

Create skill

Create a new skill with validation

Request Body

  • Name
    name
    Type
    string
    Description

    Skill name

  • Name
    description
    Type
    string
    Description

    Skill description

  • Name
    type
    Type
    string
    Description

    Skill type (Topic, Behavioral, Software Tool, etc.)

  • Name
    group
    Type
    object
    Description

    Skill group information with name and type

Response

  • Name
    success
    Type
    boolean
    Description

    No description

  • Name
    data
    Type
    Skill
    Description

    No description

Request

POST
/v1/ja/skills
curl https://frontier.beamery.com/v1/ja/skills \
  -X POST \
  -H "Authorization: Bearer your_access_token" \
  -H "Content-Type: application/json" \
  -d '{
        "name": "Network Design",
        "description": "The planning and structuring of network systems to ensure efficient and secure communication within banking institutions.",
        "type": "Topic",
        "group": {
          "name": "IT Infrastructure Management",
          "type": "Technical"
        }
    }'

Response

{
  "success": true,
  "entity": {
    "id": "2e813466-3525-46e7-817c-6400f65d6717",
    "name": "Network Design",
    "description": "The planning and structuring of network systems to ensure efficient and secure communication within banking institutions.",
    "type": "Topic",
    "group": {
      "name": "IT Infrastructure Management",
      "type": "Technical"
    }
  }
}
InternalDELETE/v1/ja/skills/{skillId}

Delete skill

Remove a specific skill permanently

Path Parameters

  • Name
    id
    Type
    string
    Description

    Unique identifier for the company

  • Name
    skillId
    Type
    string
    Description

    No description

Response

  • Name
    success
    Type
    boolean
    Description

    No description

  • Name
    data
    Type
    object
    Description

    Response data containing:

    • message (string): Success message

Request

DELETE
/v1/ja/skills/{skillId}
curl https://frontier.beamery.com/v1/ja/skills/5c752b7a-9999-4ccc-bddd-234567890123 \
  -X DELETE \
  -H "Authorization: Bearer your_access_token"

Response

{
  "success": true,
  "entity": {
    "id": "2e813466-3525-46e7-817c-6400f65d6717",
    "name": "Network Design",
    "description": "The planning and structuring of network systems to ensure efficient and secure communication within banking institutions.",
    "type": "Topic",
    "group": {
      "name": "IT Infrastructure Management",
      "type": "Technical"
    }
  }
}
InternalPATCH/v1/ja/skills/{skillId}

Update skill

Update existing skill with partial data

Path Parameters

  • Name
    id
    Type
    string
    Description

    Unique identifier for the company

  • Name
    skillId
    Type
    string
    Description

    No description

Request Body

  • Name
    name
    Type
    string
    Description

    Updated skill name

  • Name
    description
    Type
    string
    Description

    Updated skill description

  • Name
    type
    Type
    string
    Description

    Updated skill type (Topic, Behavioral, Software Tool, etc.)

  • Name
    group
    Type
    object
    Description

    Updated skill group information with name and type

Response

  • Name
    success
    Type
    boolean
    Description

    No description

  • Name
    data
    Type
    Skill
    Description

    No description

Request

PATCH
/v1/ja/skills/{skillId}
curl https://frontier.beamery.com/v1/ja/skills/68712292-aaaa-4ddd-ceee-345678901234 \
  -X PATCH \
  -H "Authorization: Bearer your_access_token" \
  -H "Content-Type: application/json" \
  -d '{
        "description": "Advanced ability to inspect, clean, and model data using modern tools and techniques for data-driven decision-making."
    }'

Response

{
  "success": true,
  "entity": {
    "id": "2e813466-3525-46e7-817c-6400f65d6717",
    "name": "Network Design",
    "description": "The planning and structuring of network systems to ensure efficient and secure communication within banking institutions.",
    "type": "Topic",
    "group": {
      "name": "IT Infrastructure Management",
      "type": "Technical"
    }
  }
}
InternalGET/v1/ja/skills/{skillId}/market

Skill market analysis

Retrieve comprehensive market analysis for a specific skill powered by Lightcast data. This endpoint provides real-time insights into skill demand, supply, growth trends, and market dynamics across different regions and industries.

This endpoint proxies data from Lightcast enhanced with Beamery intelligence, providing authoritative labor market intelligence including job postings analysis, talent pool insights, salary benchmarks, and growth projections. Data is updated regularly to reflect current market conditions.

Path Parameters

  • Name
    skillId
    Type
    string
    Description

    Unique identifier for the skill

Query Parameters

  • Name
    region
    Type
    string
    Description

    Geographic region code (e.g., "US", "UK", "CA", "AU"). Defaults to "US"

  • Name
    jobFamilyGroup
    Type
    string
    Description

    Filter by job family group (e.g., "technology", "finance", "healthcare")

  • Name
    timeframe
    Type
    string
    Description

    Analysis timeframe: "1y", "2y", "5y". Defaults to "2y"

  • Name
    includeProjections
    Type
    boolean
    Description

    Include 3-year growth projections. Defaults to true

  • Name
    sections
    Type
    string
    Description

    Comma-separated list of data sections to include. Options:

    • demand Current job demand, posting trends, growth projections, and top hiring employers
    • supply Available talent pool, geographic distribution, seniority levels, and supply growth patterns
    • compensation Salary ranges by seniority level, compensation trends, and market drivers
    • relatedSkills Complementary skills that frequently appear together and emerging skills with high growth
    • jobFamilyGroupInsights Job family group specific demand patterns, average salaries, and key employers by sector Defaults to all sections
  • Name
    demandDetails
    Type
    string
    Description

    Comma-separated demand subsections when demand section is included:

    • currentDemand Real-time job postings, monthly averages, unique employers, and growth rates
    • demandTrend Monthly demand patterns, trend direction, strength, and consistency metrics
    • projections 1-year and 3-year growth forecasts with confidence levels
    • topEmployers Leading companies hiring for this skill with posting volumes Defaults to all
  • Name
    supplyDetails
    Type
    string
    Description

    Comma-separated supply subsections when supply section is included:

    • currentSupply Total available professionals, active/passive job seekers, year-over-year growth
    • experienceDistribution Breakdown by seniority levels with counts and percentages
    • geographicDistribution Geographic concentration of talent across states and cities
    • supplyTrend Supply growth patterns, new graduates, and career changers entering the field Defaults to all
  • Name
    limit
    Type
    integer
    Description

    Limit number of items in arrays (e.g., topEmployers, topIndustries). Defaults to 5, max: 20

Response

  • Name
    success
    Type
    boolean
    Description

    Request success status

  • Name
    data
    Type
    SkillMarketAnalysis
    Description

    Comprehensive market analysis data

Request

GET
/v1/ja/skills/{skillId}/market
curl https://frontier.beamery.com/v1/ja/skills/2e813466-3525-46e7-817c-6400f65d6717/market?region=US&jobFamilyGroup=technology&timeframe=2y&sections=demand,compensation&limit=3 \
  -H "Authorization: Bearer your_access_token"

Response

{
  "success": true,
  "skillAnalysis": {
    "skill": {
      "id": "2e813466-3525-46e7-817c-6400f65d6717",
      "name": "Network Design",
      "description": "The planning and structuring of network systems to ensure efficient and secure communication within banking institutions.",
      "type": "Topic",
      "group": {
        "name": "IT Infrastructure Management",
        "type": "Technical"
      }
    },
    "marketOverview": {
      "region": "US",
      "jobFamilyGroup": "technology",
      "timeframe": "2y",
      "lastUpdated": "2024-07-15T10:30:00Z",
      "dataSource": "Lightcast"
    },
    "demand": {
      "currentDemand": {
        "jobPostings": {
          "total": 15420,
          "monthlyAverage": 1285,
          "growthRate": 12.5,
          "percentOfAllTechJobs": 3.2
        },
        "uniqueEmployers": 2847,
        "topEmployers": [
          { "id": "c1a2b3c4-5678-4def-9012-3456789abcde", "name": "Amazon", "postings": 342 },
          { "id": "d2b3c4d5-6789-4ef0-a123-456789abcdef", "name": "Microsoft", "postings": 298 }
        ]
      },
      "demandTrend": {
        "direction": "increasing",
        "strength": "strong",
        "consistency": "high",
        "monthlyData": [
          { "month": "2024-01", "postings": 1156 },
          { "month": "2024-02", "postings": 1278 }
        ]
      },
      "projections": {
        "nextYear": {
          "expectedJobPostings": 17350,
          "growthRate": 12.5,
          "confidence": "high"
        },
        "next3Years": {
          "expectedJobPostings": 22100,
          "compoundGrowthRate": 10.8,
          "confidence": "medium"
        }
      }
    },
    "supply": {
      "currentSupply": {
        "totalProfessionals": 124500,
        "experienceDistribution": {
          "entry": { "count": 18675, "percentage": 15.0 },
          "mid": { "count": 74700, "percentage": 60.0 },
          "senior": { "count": 31125, "percentage": 25.0 }
        },
        "geographicDistribution": {
          "california": { "count": 24900, "percentage": 20.0 },
          "texas": { "count": 14940, "percentage": 12.0 }
        }
      },
      "supplyTrend": {
        "direction": "increasing",
        "strength": "moderate",
        "yearOverYearGrowth": 6.2,
        "newGraduates": 8750,
        "careerChangers": 3200
      }
    },
    "marketDynamics": {
      "supplyDemandRatio": 0.68,
      "competitiveness": "high",
      "timeToFill": {
        "averageDays": 67,
        "trend": "increasing",
        "industryBenchmark": 54
      },
      "skillGap": {
        "severity": "moderate",
        "gapSize": 12400,
        "primaryReasons": [
          "Rapid technology evolution",
          "Specialized expertise requirements",
          "Limited training programs"
        ]
      }
    },
    "compensation": {
      "salaryRanges": {
        "entry": {
          "p25": 75000,
          "p50": 85000,
          "p75": 95000,
          "currency": "USD"
        },
        "mid": {
          "p25": 95000,
          "p50": 115000,
          "p75": 135000,
          "currency": "USD"
        },
        "senior": {
          "p25": 135000,
          "p50": 165000,
          "p75": 195000,
          "currency": "USD"
        }
      },
      "compensationTrend": {
        "direction": "increasing",
        "yearOverYearGrowth": 8.5,
        "driverFactors": [
          "High demand",
          "Skill shortage",
          "Remote work premium"
        ]
      }
    },
    "relatedSkills": {
      "complementary": [
        {
          "skillId": "1bdce777-8888-49aa-bbcc-123456789012",
          "name": "SQL",
          "coOccurrenceRate": 0.78
        }
      ],
      "emerging": [
        {
          "skillId": "4e035688-1111-4bbb-aeee-345678901234",
          "name": "Cloud Security",
          "growthRate": 45.2
        }
      ]
    },
    "jobFamilyGroupInsights": {
      "topJobFamilyGroups": [
        {
          "jobFamilyGroup": "Technology",
          "percentage": 32.5,
          "avgSalary": 125000,
          "growthRate": 15.2
        },
        {
          "jobFamilyGroup": "Financial Services",
          "percentage": 22.8,
          "avgSalary": 118000,
          "growthRate": 11.7
        }
      ]
    }
  }
}
InternalGET/v1/ja/skills/{skillId}/demand/trends

Analyze detailed demand trends for a specific skill over time, including seasonal patterns, growth trajectories, and demand drivers powered by Lightcast job postings data.

This endpoint proxies data from Lightcast enhanced with Beamery intelligence, providing authoritative labor market intelligence including job postings analysis, talent pool insights, salary benchmarks, and growth projections. Data is updated regularly to reflect current market conditions.

Path Parameters

  • Name
    skillId
    Type
    string
    Description

    Unique identifier for the skill

Query Parameters

  • Name
    timeframe
    Type
    string
    Description

    Analysis period: "6m", "1y", "2y", "5y". Defaults to "1y"

  • Name
    region
    Type
    string
    Description

    Geographic region filter (e.g., "US", "UK", "CA")

  • Name
    granularity
    Type
    string
    Description

    Data granularity: "monthly", "quarterly", "yearly". Defaults to "monthly"

  • Name
    includeSeasonality
    Type
    boolean
    Description

    Include seasonal pattern analysis. Defaults to true

  • Name
    sections
    Type
    string
    Description

    Comma-separated list of data sections to include. Options:

    • overallTrend High-level trend analysis including direction, strength, growth rate, and confidence level
    • timeSeriesData Historical demand data points with job postings, employers, and salary trends over time
    • seasonalityAnalysis Seasonal patterns, peak/low months, holiday effects, and cyclical demand insights
    • demandDrivers Primary and emerging factors driving skill demand with impact assessments
    • geographicDistribution Top metropolitan areas with demand concentration, salaries, and growth rates
    • jobFamilyGroupBreakdown Job family group specific demand patterns, growth rates, and key employers by sector Defaults to all sections
  • Name
    limit
    Type
    integer
    Description

    Limit number of items in arrays (e.g., topMetros, keyEmployers). Defaults to 4, max: 20

Response

  • Name
    success
    Type
    boolean
    Description

    Request success status

  • Name
    data
    Type
    SkillDemandTrends
    Description

    Detailed demand trend analysis

Request

GET
/v1/ja/skills/{skillId}/demand/trends
curl https://frontier.beamery.com/v1/ja/skills/2e813466-3525-46e7-817c-6400f65d6717/demand/trends?timeframe=1y&granularity=monthly&sections=overallTrend,timeSeriesData&limit=5 \
  -H "Authorization: Bearer your_access_token"

Response

{
  "success": true,
  "demandTrends": {
    "skill": {
      "id": "2e813466-3525-46e7-817c-6400f65d6717",
      "name": "Network Design"
    },
    "analysisParams": {
      "timeframe": "1y",
      "region": "US",
      "granularity": "monthly",
      "dataSource": "Lightcast"
    },
    "overallTrend": {
      "direction": "increasing",
      "strength": "strong",
      "growthRate": 12.5,
      "confidence": "high",
      "trendStartDate": "2023-07-01",
      "trendEndDate": "2024-07-01"
    },
    "timeSeriesData": [
      {
        "period": "2023-07",
        "jobPostings": 1089,
        "uniqueEmployers": 245,
        "averageSalary": 112000,
        "growthRateVsPreviousMonth": 0.0
      },
      {
        "period": "2023-08",
        "jobPostings": 1156,
        "uniqueEmployers": 267,
        "averageSalary": 114000,
        "growthRateVsPreviousMonth": 6.2
      }
    ],
    "seasonalityAnalysis": {
      "hasSeasonalPattern": true,
      "seasonalityStrength": "moderate",
      "peakMonths": ["March", "April", "September", "October"],
      "lowMonths": ["December", "January"],
      "holidayEffects": {
        "december": -12.0,
        "january": -8.5,
        "july": -3.2
      }
    },
    "demandDrivers": {
      "primary": [
        {
          "factor": "Digital transformation initiatives",
          "impact": "high",
          "description": "Increased enterprise investment in network infrastructure modernization"
        },
        {
          "factor": "Remote work infrastructure",
          "impact": "high",
          "description": "Sustained demand for secure, scalable network solutions"
        }
      ],
      "emerging": [
        {
          "factor": "AI/ML infrastructure requirements",
          "impact": "medium",
          "description": "Growing need for high-performance network designs to support AI workloads"
        }
      ]
    },
    "geographicDistribution": {
      "topMetros": [
        {
          "metro": "San Francisco Bay Area",
          "percentage": 18.2,
          "avgSalary": 145000,
          "growthRate": 15.3
        },
        {
          "metro": "New York City",
          "percentage": 12.8,
          "avgSalary": 125000,
          "growthRate": 11.7
        }
      ]
    },
    "jobFamilyGroupBreakdown": {
      "technology": {
        "percentage": 35.7,
        "growthRate": 16.8,
        "keyEmployers": [
          { "id": "c1a2b3c4-5678-4def-9012-3456789abcde", "name": "Amazon" },
          { "id": "d2b3c4d5-6789-4ef0-a123-456789abcdef", "name": "Microsoft" }
        ]
      },
      "financial_services": {
        "percentage": 24.3,
        "growthRate": 9.2,
        "keyEmployers": [
          { "id": "b6f7a8b9-abcd-4234-e567-89abcdef0123", "name": "JPMorgan Chase" },
          { "id": "c7a8b9ca-bcde-4345-f678-9abcdef01234", "name": "Bank of America" }
        ]
      },
      "healthcare": {
        "percentage": 16.8,
        "growthRate": 21.4,
        "keyEmployers": [
          { "id": "e9cadbec-def0-4567-b89a-bcdef0123456", "name": "Kaiser Permanente" },
          { "id": "f0dbecfd-ef01-4678-c9ab-cdef01234567", "name": "Anthem" }
        ]
      }
    }
  }
}
InternalGET/v1/ja/skills/{skillId}/supply/insights

Skill supply insights

Analyze skill supply patterns, talent availability, and workforce composition using Lightcast professional profile data and educational institution insights.

This endpoint proxies data from Lightcast enhanced with Beamery intelligence, providing authoritative labor market intelligence including job postings analysis, talent pool insights, salary benchmarks, and growth projections. Data is updated regularly to reflect current market conditions.

Path Parameters

  • Name
    skillId
    Type
    string
    Description

    Unique identifier for the skill

Query Parameters

  • Name
    region
    Type
    string
    Description

    Geographic region filter (e.g., "US", "UK", "CA")

  • Name
    includeEducation
    Type
    boolean
    Description

    Include educational pipeline analysis. Defaults to true

  • Name
    includeMobility
    Type
    boolean
    Description

    Include talent mobility patterns. Defaults to true

  • Name
    sections
    Type
    string
    Description

    Comma-separated list of data sections to include. Options:

    • currentSupply Total available professionals, active/passive job seekers, and year-over-year growth trends
    • experienceDistribution Breakdown of talent by seniority levels with salary ranges
    • geographicDistribution Geographic concentration of talent, city-level distribution, and mobility patterns
    • educationalPipeline Relevant degree programs, annual graduates, top schools, and certification programs
    • skillAcquisitionPatterns Primary pathways for skill development and typical time to competency by seniority level
    • talentMobility Industry transitions, career progression paths, and talent flow patterns Defaults to all sections
  • Name
    experienceLevel
    Type
    string
    Description

    Filter by seniority level: "entry", "mid", "senior". Defaults to all levels. See seniority levels for details

  • Name
    limit
    Type
    integer
    Description

    Limit number of items in arrays (e.g., topSchools, inbound/outbound migration). Defaults to 3, max: 10

Response

  • Name
    success
    Type
    boolean
    Description

    Request success status

  • Name
    data
    Type
    SkillSupplyInsights
    Description

    Comprehensive supply analysis

Request

GET
/v1/ja/skills/{skillId}/supply/insights
curl https://frontier.beamery.com/v1/ja/skills/2e813466-3525-46e7-817c-6400f65d6717/supply/insights?region=US&sections=currentSupply,experienceDistribution&experienceLevel=mid&limit=5 \
  -H "Authorization: Bearer your_access_token"

Response

{
  "success": true,
  "supplyInsights": {
    "skill": {
      "id": "2e813466-3525-46e7-817c-6400f65d6717",
      "name": "Network Design"
    },
    "currentSupply": {
      "totalProfessionals": 124500,
      "activeJobSeekers": 8715,
      "passiveJobSeekers": 37350,
      "yearOverYearGrowth": 6.2,
      "lastUpdated": "2024-07-15T10:30:00Z"
    },
    "experienceDistribution": {
      "entry_level": {
        "count": 18675,
        "percentage": 15.0,
        "definition": "0-2 years experience",
        "averageSalary": 85000
      },
      "mid_level": {
        "count": 74700,
        "percentage": 60.0,
        "definition": "3-7 years experience",
        "averageSalary": 115000
      },
      "senior_level": {
        "count": 31125,
        "percentage": 25.0,
        "definition": "8+ years experience",
        "averageSalary": 165000
      }
    },
    "geographicDistribution": {
      "concentration": {
        "california": {
          "count": 24900,
          "percentage": 20.0,
          "cities": {
            "san_francisco": 12450,
            "los_angeles": 7470
          }
        },
        "texas": {
          "count": 14940,
          "percentage": 12.0,
          "cities": {
            "austin": 6225,
            "dallas": 4980
          }
        }
      },
      "mobilityTrends": {
        "inboundMigration": {
          "topSources": [
            { "state": "Pennsylvania", "count": 890 },
            { "state": "Ohio", "count": 745 }
          ]
        },
        "outboundMigration": {
          "topDestinations": [
            { "state": "Florida", "count": 1245 },
            { "state": "North Carolina", "count": 998 }
          ]
        }
      }
    },
    "educationalPipeline": {
      "relevantPrograms": [
        {
          "program": "Computer Science",
          "annualGraduates": 2890,
          "topSchools": [
            { "name": "Stanford University", "graduates": 145 },
            { "name": "MIT", "graduates": 132 }
          ]
        },
        {
          "program": "Network Engineering",
          "annualGraduates": 1567,
          "topSchools": [
            { "name": "Georgia Tech", "graduates": 89 },
            { "name": "University of Texas", "graduates": 76 }
          ]
        }
      ],
      "certificationPrograms": [
        {
          "certification": "CCNA",
          "annualCompletions": 12400,
          "provider": "Cisco",
          "averageTimeToComplete": "6 months"
        },
        {
          "certification": "CCNP",
          "annualCompletions": 4580,
          "provider": "Cisco",
          "averageTimeToComplete": "12 months"
        }
      ]
    },
    "skillAcquisitionPatterns": {
      "primaryPathways": [
        {
          "pathway": "Formal Education",
          "percentage": 45.2,
          "description": "University degree programs in relevant fields"
        },
        {
          "pathway": "Professional Certification",
          "percentage": 32.8,
          "description": "Industry certifications and bootcamps"
        }
      ],
      "timeToCompetency": {
        "entry_level": "6-12 months",
        "mid_level": "3-5 years",
        "senior_level": "8+ years"
      }
    },
    "talentMobility": {
      "industryTransitions": {
        "inbound": [
          {
            "fromIndustry": "Telecommunications",
            "count": 2340,
            "commonRoles": ["Network Engineer", "Systems Administrator"]
          }
        ],
        "outbound": [
          {
            "toIndustry": "Cloud Services",
            "count": 3200,
            "commonRoles": ["Cloud Architect", "Solutions Engineer"]
          }
        ]
      },
      "careerProgression": {
        "typicalPath": [
          "Network Technician",
          "Network Engineer",
          "Senior Network Engineer"
        ],
        "alternativePaths": [
          "Network Security Specialist",
          "Cloud Network Engineer"
        ]
      }
    }
  }
}
InternalGET/v1/ja/skills/groups

Get all skill groups

Retrieve all skill groups (clusters) generated using proprietary graph-based embedding models. These dynamic clusters reduce dimensionality and enable analysis at different levels of abstraction.

In addition to core Skill Types, Beamery employs semantic clustering to create high-resolution groupings of skills. These clusters are generated using proprietary graph-based embedding models and real-world labor data (e.g., Statistical Modeling, Web Frameworks, Cloud Infrastructure Tools). These dynamic clusters reduce dimensionality and enable customers to analyze talent and work at different levels of abstraction — skill, domain, or functional area.

Query Parameters

  • Name
    limit
    Type
    integer
    Description

    Number of skill groups to return (default: 50, max: 100)

  • Name
    offset
    Type
    integer
    Description

    Number of skill groups to skip for pagination

Response

  • Name
    success
    Type
    boolean
    Description

    No description

  • Name
    data
    Type
    array<SkillGroup>
    Description

    Array of skill group objects

  • Name
    pagination
    Type
    object
    Description

    Pagination information

Request

GET
/v1/ja/skills/groups
curl https://frontier.beamery.com/v1/ja/skills/groups \
  -H "Authorization: Bearer your_access_token"

Response

{
  "success": true,
  "skillGroups": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "name": "Statistical Modeling",
      "description": "Skills related to statistical analysis, predictive modeling, and data science techniques used for analyzing and interpreting complex datasets.",
      "skillIds": [
        "2e813466-3525-46e7-817c-6400f65d6717",
        "1bdce777-8888-49aa-bbcc-123456789012",
        "3f924577-9999-4aaa-bddd-234567890123"
      ]
    },
    {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "name": "Web Frameworks",
      "description": "Modern web development frameworks and libraries used for building scalable web applications and user interfaces.",
      "skillIds": [
        "4e035688-1111-4bbb-aeee-345678901234",
        "5f146799-2222-4ccc-afff-456789012345"
      ]
    },
    {
      "id": "6ba7b811-9dad-11d1-80b4-00c04fd430c8",
      "name": "Cloud Infrastructure Tools",
      "description": "Tools and platforms for managing cloud infrastructure, containerization, and DevOps practices in modern software development.",
      "skillIds": [
        "6a257810-3333-4ddd-aggg-567890123456",
        "7b368921-4444-4eee-ahhh-678901234567"
      ]
    }
  ],
  "pagination": {
    "total": 87,
    "limit": 50,
    "offset": 0,
    "hasMore": true
  }
}
InternalGET/v1/ja/skills/groups/{groupId}

Get skill group

Retrieve detailed information about a specific skill group, including all associated skills.

Path Parameters

  • Name
    groupId
    Type
    string
    Description

    Unique identifier for the skill group

Response

  • Name
    success
    Type
    boolean
    Description

    No description

  • Name
    data
    Type
    SkillGroup
    Description

    Detailed skill group object

Request

GET
/v1/ja/skills/groups/{groupId}
curl https://frontier.beamery.com/v1/ja/skills/groups/f47ac10b-58cc-4372-a567-0e02b2c3d479 \
  -H "Authorization: Bearer your_access_token"

Response

{
  "success": true,
  "skillGroup": {
    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "name": "Statistical Modeling",
    "description": "Skills related to statistical analysis, predictive modeling, and data science techniques used for analyzing and interpreting complex datasets.",
    "skillIds": [
      "2e813466-3525-46e7-817c-6400f65d6717",
      "1bdce777-8888-49aa-bbcc-123456789012",
      "3f924577-9999-4aaa-bddd-234567890123",
      "4e035688-1111-4bbb-aeee-345678901234",
      "5f146799-2222-4ccc-afff-456789012345",
      "6a257810-3333-4ddd-aggg-567890123456",
      "7b368921-4444-4eee-ahhh-678901234567",
      "8c479032-5555-4fff-aiii-789012345678"
    ]
  }
}

EOF < /dev/null