Job Analytics API
Comprehensive analytics for the Greek job market with insights on skill demand, and emerging professional trends across various regions.
GET https://skillscapes.csd.auth.gr:22222/api/jobs/timeseries
{
data: [
"date": "2025-05-01",
"total_jobs": 17,
],
...
}
/api/jobs/timeseries
Retrieves an historical time-series of data regarding job postings aggregated by date. Filterable by start and end date. Data source: Scraped job postings data Time period: 2025-05-01 - present Returns empty array if no data matched the filters used.
Query Parameters
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/jobs/timeseries" \
-H "accept: application/json"
/api/jobs/count
Retrieves the total number of job postings for a given period. Filterable by start and end date. Data source: Scraped job postings data Time period: 2025-05-01 - present Returns the total number of job postings if no filters used.
Query Parameters
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/jobs/count" \
-H "accept: application/json"
/api/occupations/demand
Retrieves an historical time-series of EU sectoral and occupational employment data, skill-level distributions and indicators of precarious labor aggregated by year. Filterable by variable, geographical entity, and year range. Data source: Scraped job postings data Time period: 2025-05-01 - present Returns top 20 occupations by demand, if top_n parameter is not provided.
Query Parameters
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
top_n - Number of top occupations to return (1-200)
Optional • Integer
e.g., 20
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/occupations/demand" \
-H "accept: application/json"
/api/occupations/timeseries
Retrieves an historical time-series of data regarding the demand for a given occupation. Data source: Scraped job postings data Time period: 2025-05-01 - present ESCO label parameter is required.
Query Parameters
esco_label - ESCO label
Required • String
e.g., cook
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/occupations/timeseries?esco_label=cook" \
-H "accept: application/json"
/api/occupations/all-regions
Retrieves occupations demand across all regions. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
region_level - Geographical entity level (nuts2 or regional_unit)
Optional • String
e.g., regional_unit
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
top_n_per_region - Limit the number of occupations to return per region (1-100)
Optional • Integer
e.g., 10
min_jobs - Minimum number of jobs to include (minimum is 1)
Optional • Integer
e.g., 10
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/occupations/all-regions" \
-H "accept: application/json"
/api/occupations/regions
Retrieves occupations demand by region. Data source: Scraped job postings data Time period: 2025-05-01 - present ESCO label parameter is required.
Query Parameters
esco_label - ESCO label
Required • String
e.g., cook
region_level - Geographical entity level (nuts2 or regional_unit)
Optional • String
e.g., regional_unit
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
top_n - Limit the number of regions to include (1-100)
Optional • Integer
e.g., 10
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/occupations/regions?esco_label=cook" \
-H "accept: application/json"
/api/regions/jobs
Retrieves job postings distribution by region. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
region_level - Geographical entity level (nuts2 or regional_unit)
Optional • String
e.g., regional_unit
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
top_n - Limit the number of regions to include (1-100)
Optional • Integer
e.g., 10
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/regions/jobs" \
-H "accept: application/json"
/api/regions/{region}/occupations
Retrieves top occupations for a specific region. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
region - Region name
Required • String
e.g., Attiki
region_level - Geographical entity level (nuts2 or regional_unit)
Optional • String
e.g., regional_unit
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
top_n - Limit the number of occupations to include (1-200)
Optional • Integer
e.g., 10
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/regions/Attiki/occupations" \
-H "accept: application/json"
/api/regions/{region}/timeseries
Retrieves an historical time-series of job-postings number in a specific region. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
region - Region name
Required • String
e.g., Attiki
region_level - Geographical entity level (nuts2 or regional_unit)
Optional • String
e.g., regional_unit
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/regions/Attiki/timeseries" \
-H "accept: application/json"
/api/regions/{region}/jobtypes
Retrieves job-types distribution in a specific region with category support. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
region - Region name
Required • String
e.g., Attiki
region_level - Geographical entity level (nuts2 or regional_unit)
Optional • String
e.g., regional_unit
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
category - Category type (filltime or temporary)
Optional • String
e.g., fulltime
aggregate_by_category - Aggregate by category (true or false)
Optional • Boolean
e.g., true
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/regions/Attiki/jobtypes?aggregate_by_category=true" \
-H "accept: application/json"
/api/skills/top
Retrieves top skills overall accross all job postings. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
top_n - Limit the number of skills to include (1-100)
Optional • Integer
e.g., 10
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/skills/top" \
-H "accept: application/json"
/api/skills/by-region
Retrieves top skills in demand for a specific region. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
region - Region name
Required • String
e.g., Attiki
region_level - Geographical entity level (nuts2 or regional_unit)
Optional • String
e.g., regional_unit
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
top_n - Limit the number of skills to include (1-100)
Optional • Integer
e.g., 10
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/skills/by-region?region=Attiki" \
-H "accept: application/json"
/api/skills/by-occupation
Retrieves top skills in demand for a specific occupation. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
esco_label - ESCO label
Required • String
e.g., cook
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
top_n - Limit the number of skills to include (1-100)
Optional • Integer
e.g., 10
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/skills/by-occupation?esco_label=cook" \
-H "accept: application/json"
/api/skills/by-occupation-region
Retrieves top skills in demand for a specific occupation in a specific region. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
esco_label - ESCO label
Required • String
e.g., cook
region - Region name
Required • String
e.g., Attiki
region_level - Geographical entity level (nuts2 or regional_unit)
Optional • String
e.g., regional_unit
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
top_n - Limit the number of skills to include (1-100)
Optional • Integer
e.g., 10
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/skills/by-occupation-region?esco_label=cook®ion=Attiki" \
-H "accept: application/json"
/api/skills/by-occupation/detailed
Retrieves top skills in demand for a specific occupation with detailed categorization. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
esco_label - ESCO label
Required • String
e.g., cook
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
top_n - Limit the number of skills to include (1-100)
Optional • Integer
e.g., 10
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/skills/by-occupation/detailed?esco_label=cook" \
-H "accept: application/json"
/api/occupations/skills-region
Retrieves top skills in demand for a specific occupation per region. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
esco_label - ESCO label
Required • String
e.g., cook
region_level - Geographical entity level (nuts2 or regional_unit)
Optional • String
e.g., regional_unit
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
top_n - Limit the number of skills to include (1-50)
Optional • Integer
e.g., 10
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/occupations/skills-by-region?esco_label=cook" \
-H "accept: application/json"
/api/trends/occupations/growth
Retrieves occupations with highest growth in demand. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
top_n - Limit the number of occupations to include (1-100)
Optional • Integer
e.g., 10
sort_by - Sort by percentage (change_percent) or absolute change (change_absolute)
Optional • string
e.g., change_percent
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/trends/occupations/growth" \
-H "accept: application/json"
/api/trends/occupation
Retrieves trend data for a specific occupation over time. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
esco_label - ESCO label
Required • String
e.g., cook
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
region - Region name
Optional • String
e.g., Attiki
region_level - Geographical entity level (nuts2 or regional_unit)
Optional • String
e.g., regional_unit
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/trends/occupation?esco_label=cook" \
-H "accept: application/json"
/api/trends/monthly
Retrieves job postings number data aggregated by month. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/trends/monthly" \
-H "accept: application/json"
/api/trends/monthly/occupations
Retrieves monthly job count trends for a specific occupation. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
esco_label - ESCO label
Required • String
e.g., cook
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/trends/monthly/occupations?esco_label=cook" \
-H "accept: application/json"
/api/v2/job-types/distribution
Retrieves job-type distribution with optional filtering. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
category - Category type (Full-time, Part-time, Temporary, Permanent, N/A, Other)
Optional • String
e.g., Full-time
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/jobtypes/distribution" \
-H "accept: application/json"
/api/v2/job-types/categories
Retrieves job-type distribution grouped by category. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/v2/job-types/categories" \
-H "accept: application/json"
/api/v2/regions/{region}/job-types
Retrieves job-types distribution for a specific region. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
region - Region name
Required • String
e.g., Attiki
region_level - Geographical entity level (nuts2 or regional_unit)
Optional • String
e.g., regional_unit
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
category - Category type (Full-time, Part-time, Temporary, Permanent, N/A, Other)
Optional • String
e.g., Full-time
aggregate_by_category - Aggregate by category (true or false)
Optional • Boolean
e.g., true
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/v2/regions/Attiki/job-types?aggregate_by_category=false" \
-H "accept: application/json"
/api/v2/regions/{region}/job-types/categories
Retrieves job-types categories distribution for a specific region. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
region - Region name
Required • String
e.g., Attiki
region_level - Geographical entity level (nuts2 or regional_unit)
Optional • String
e.g., regional_unit
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/v2/regions/Attiki/job-types/categories" \
-H "accept: application/json"
/api/v2/occupations/job-types/categories
Retrieves job-types categories distribution for a specific occupation. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
esco_label - ESCO label
Required • String
e.g., cook
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/v2/occupations/job-types/categories?esco_label=cook" \
-H "accept: application/json"
/api/v2/occupations/regions/job-types/categories
Retrieves job-types categories distribution for a specific occupation in a specific region. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
esco_label - ESCO label
Required • String
e.g., cook
region - Region name
Required • String
e.g., Attiki
region_level - Geographical entity level (nuts2 or regional_unit)
Optional • String
e.g., regional_unit
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/occupations/regions/jobtypes/categories?esco_label=cook®ion=Attiki" \
-H "accept: application/json"
/api/heatmap/occupations-regions
Retrieves occupations by regions for heatmap visualization. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
region_level - Geographical entity level (nuts2 or regional_unit)
Optional • String
e.g., regional_unit
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
top_n_occupations - Limit the number of occupations to include (1-50)
Optional • Integer
e.g., 10
top_n_regions - Limit the number of regions to include (1-50)
Optional • Integer
e.g., 10
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/heatmap/occupations-regions" \
-H "accept: application/json"
/api/heatmap/skills-regions-occupation
Retrieves skills by regions heatmap for a specific occupation. Data source: Scraped job postings data Time period: 2025-05-01 - present
Query Parameters
esco_label - ESCO label
Required • String
e.g., cook
region_level - Geographical entity level (nuts2 or regional_unit)
Optional • String
e.g., regional_unit
start_date - Start date (YYYY-MM-DD) (minimum date is 2025-05-01)
Optional • String
e.g., 2026-01-01
end_date - End date (YYYY-MM-DD)
Optional • String
e.g., 2026-04-01
top_n_skills - Limit the number of skills to include (1-50)
Optional • Integer
e.g., 10
top_n_regions - Limit the number of regions to include (1-50)
Optional • Integer
e.g., 10
normalize - Normalize the data by job count per region - percentage (true or false)
Optional • Boolean
e.g., false
curl -X GET "https://skillscapes.csd.auth.gr:22222/api/heatmap/skills-regions-occupation?esco_label=cook&normalize=false" \
-H "accept: application/json"
