---
title: "Get estimates by MSAs"
method: POST
path: "/by_msa"
tags: ["Data"]
---

# Get estimates by MSAs

`POST /by_msa`

Takes multiple MSA codes and produces an estimate for each. This is much faster than making many separate calls to `/estimate`. The response format is much more minimal than that of the other estimation endpoints to reduce data size.

## Request body

- object
  - `titles` string[], required — One or more codes from the Emsi Title taxonomy.
  - `socs` string[], required — One or codes from the SOC occupation taxonomy.
  - `msas` integer[] — An array of MSA codes to produce a regionalized estimate for. If left unspecified, an estimate will be produced for all MSAs.
  - `keyword` string — A full-text keyword search, allows fuzzy and boolean text searches (using '+', '-', etc.).
  - `skills` string[] — Skill names from the Skills taxonomy. Note that the name needs to match exactly against the name defined by the taxonomy.
  - `skills_operator` 'Or' | 'And' — Choose one of `Or`, `And`.
  - `experiences` integer[] — Years of experience. Limited to a single value for this endpoint.
  - `industries` string[] — NAICS industry codes to limit the search scope.
  - `companies` string[] — Normalized company names to limit the search scope.
  - `model` string — Advanced feature for changing the weighting model. See the `/models` endpoint.

## Response `200`

OK

- object
  - `by_msa` object[]
    - `msa` string
    - `employment` integer
    - `median_hourly` integer
    - `median_annual` integer

## Other responses

- `400` — bad request

---

[API](https://skmtc.net/lightcast/apis/alumni-pathways-2-0.md) · [All operations](https://skmtc.net/lightcast/apis/alumni-pathways-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightcast/alumni-pathways-2-0/revisions/fc66b9877391/schema)