Pricing

Pay per usage

BLS Wage Data Scraper - Salary by Occupation API

Search official BLS OEWS wage and salary data by occupation, state, metro area, and industry. Use this scraper/API for HR compensation benchmarking, recruiter salary research, labor-market analysis, workforce planning, and salary-data products. No API key needed for standard lookups.

Pricing

Pay per usage

Rating

0.0

(0)

Developer

Ava Torres

Actor stats

Bookmarked

Total users

Monthly active users

6 days ago

Last modified

Categories

Business

Developer tools

You can access the BLS Wage Data Scraper - Salary by Occupation API programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.1",
    "x-build-id": "ChwvHiZTO8afqiytm"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/pink_comic~bls-oews-wage-salary-data/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-pink_comic-bls-oews-wage-salary-data",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/pink_comic~bls-oews-wage-salary-data/runs": {
      "post": {
        "operationId": "runs-sync-pink_comic-bls-oews-wage-salary-data",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/pink_comic~bls-oews-wage-salary-data/run-sync": {
      "post": {
        "operationId": "run-sync-pink_comic-bls-oews-wage-salary-data",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "occupationCode": {
            "title": "Occupation Code (SOC)",
            "type": "string",
            "description": "6-digit Standard Occupational Classification (SOC) code. Hyphens are optional (e.g. '15-1252' or '151252' for Software Developers). Use '000000' for all occupations combined. See the README for a full code list.",
            "default": "151252"
          },
          "occupationTitle": {
            "title": "Occupation Title (optional label)",
            "type": "string",
            "description": "Human-readable occupation name. Used to label output records. If blank, the actor looks up the title from a built-in SOC code table.",
            "default": ""
          },
          "areaCode": {
            "title": "Area Code",
            "type": "string",
            "description": "7-character BLS OES area code. Use '0000000' for national data, 'S0600000' for California, etc. See the README for a state/MSA code reference.",
            "default": "0000000"
          },
          "areaTitle": {
            "title": "Area Title (optional label)",
            "type": "string",
            "description": "Human-readable area name. Used to label output records. If blank, the actor looks up the title from a built-in area code table.",
            "default": ""
          },
          "industryCode": {
            "title": "Industry Code (NAICS-based)",
            "type": "string",
            "description": "6-character BLS OES industry code. Use '000000' for all industries combined, '540000' for Professional/Scientific/Technical Services, '620000' for Healthcare, etc.",
            "default": "000000"
          },
          "industryTitle": {
            "title": "Industry Title (optional label)",
            "type": "string",
            "description": "Human-readable industry name. Used to label output records.",
            "default": ""
          },
          "year": {
            "title": "Data Year",
            "minimum": 2014,
            "maximum": 2024,
            "type": "integer",
            "description": "The BLS OEWS data year to retrieve. OES publishes annual data each May for the prior year. The most recent release is 2024 data (published May 2025). Valid range: 2014-2024.",
            "default": 2024
          },
          "apiKey": {
            "title": "BLS API Registration Key (optional)",
            "type": "string",
            "description": "Optional BLS API key from https://data.bls.gov/registrationEngine/. Without a key, the actor is limited to 25 series per day. With a key, you get 500 series per day and can query longer date ranges."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

BLS Salary & Wage Data Scraper - OEWS Occupation API OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for BLS Wage Data Scraper - Salary by Occupation API from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

BLS Wage Data Scraper - Salary by Occupation API API in Python

BLS Wage Data Scraper - Salary by Occupation API API in JavaScript

BLS Wage Data Scraper - Salary by Occupation API API through CLI

BLS Wage Data Scraper - Salary by Occupation API API

BLS Salary & Employment Data Scraper

lulzasaur/bls-scraper

Scrape Bureau of Labor Statistics for salary, employment, and wage data. Uses BLS Public Data API for OES occupational stats by area and industry.

lulz bot

Bureau of Labor Statistics Scraper

fortuitous_pirate/bls-scraper

Extract employment and wage data from BLS. Get occupational statistics, salary ranges, job growth projections, and industry data. Essential for HR and workforce analysis.

Fortuitous Pirate

BLS Labor Statistics Scraper

crawlerbros/osha-inspection-violation-scraper

Scrape US Bureau of Labor Statistics (BLS) employment, unemployment, and wage data by industry sector and state. Free government API, no authentication required.

Crawler Bros

BLS API - Bureau of Labor Statistics Data

alizarin_refrigerator-owner/bls-api---bureau-of-labor-statistics-data

Access Bureau of Labor Statistics data for employment, wages, prices, and productivity. Get unemployment rates, CPI inflation, job openings, wage data by industry and occupation.

The Howlers

💵 Salary Search — Compensation by Role

nexgendata/salary-data-search

Search salary data across industries, roles & locations. Levels.fyi, Payscale, Glassdoor & BLS alternative for HR benchmarking, comp planning and recruiting intelligence. Get ranges, bonuses, equity & benefits. Pay per search.

NexGenData

BLS Labor Statistics Scraper

crawlerbros/bls-labor-statistics-scraper

Fetch U.S. Bureau of Labor Statistics (BLS) time-series data - employment, unemployment, inflation (CPI), wages, and more - via the free BLS public API v1. No API key required.

Crawler Bros

Bls Scraper

flamboyant_liner/bls-scraper

Extract employment statistics, CPI, unemployment rates, and wage data from Bureau of Labor Statistics API. Time series data with calculations.

Khrystyna Skotte

BLS Data Scraper | Bureau of Labor Statistics API

parseforge/bls-scraper

Scrape US Bureau of Labor Statistics time series data via the official BLS API v2. Export CPI, unemployment rate, employment, PPI and any BLS series to CSV, Excel, JSON or XML.

ParseForge

BLS US Economic Data Search

ryanclinton/bls-economic-data

BLS US Economic Data Search is an Apify actor that connects directly to the official Bureau of Labor Statistics (BLS) Public Data API v2 and retrieves time series data for US economic indicators.

Ryan Clinton

💼 Indeed Salary Scraper - Jobs, Descriptions & Companies

renzomacar/indeed-jobs

Scrape Indeed jobs & salary data across 7 countries with no API key — titles, companies, locations, salary ranges, full descriptions, dates and benefits in clean JSON or Excel. Filter by date, type and location. For recruiters and salary research. Pay only per job scraped.