curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-jobs-wages \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"area_fips": "26163"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-jobs-wages", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"area_fips": "26163"
}),
});
const result = await agent.tool('lookup/place-jobs-wages', {
area_fips: '26163'
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_jobs_wages",
"result": {
"found": true,
"area_fips": "26163",
"ownership": "total",
"industry": "all",
"quarters": [
{
"period": "2026-Q1",
"year": 2026,
"quarter": 1,
"preliminary": true,
"establishments": 37839,
"employment_month_1": 720803,
"employment_month_2": 716326,
"employment_month_3": 718144,
"total_wages_thousands": 15729948,
"average_weekly_wage": 1684
},
{
"period": "2025-Q4",
"year": 2025,
"quarter": 4,
"preliminary": false,
"establishments": 38398,
"employment_month_1": 723714,
"employment_month_2": 725372,
"employment_month_3": 726125,
"total_wages_thousands": 14760231,
"average_weekly_wage": 1566
}
],
"annual_pay": [
{
"year": 2025,
"average_annual_pay": 79422,
"preliminary": false
},
{
"year": 2024,
"average_annual_pay": 76411,
"preliminary": false
}
]
},
"evidence": {
"source": "US Bureau of Labor Statistics",
"source_kind": "public",
"retrieved_at": "2026-10-26T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-26T12:00:00.000Z"
}
],
"as_of": null
}
}
}
Companies & finance
Jobs and Wages
Look up quarterly employment, establishments and wages, and average annual pay, for a US county, state or the nation, by ownership and industry supersector.
POST
/
v1
/
tools
/
lookup
/
place-jobs-wages
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-jobs-wages \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"area_fips": "26163"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-jobs-wages", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"area_fips": "26163"
}),
});
const result = await agent.tool('lookup/place-jobs-wages', {
area_fips: '26163'
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_jobs_wages",
"result": {
"found": true,
"area_fips": "26163",
"ownership": "total",
"industry": "all",
"quarters": [
{
"period": "2026-Q1",
"year": 2026,
"quarter": 1,
"preliminary": true,
"establishments": 37839,
"employment_month_1": 720803,
"employment_month_2": 716326,
"employment_month_3": 718144,
"total_wages_thousands": 15729948,
"average_weekly_wage": 1684
},
{
"period": "2025-Q4",
"year": 2025,
"quarter": 4,
"preliminary": false,
"establishments": 38398,
"employment_month_1": 723714,
"employment_month_2": 725372,
"employment_month_3": 726125,
"total_wages_thousands": 14760231,
"average_weekly_wage": 1566
}
],
"annual_pay": [
{
"year": 2025,
"average_annual_pay": 79422,
"preliminary": false
},
{
"year": 2024,
"average_annual_pay": 76411,
"preliminary": false
}
]
},
"evidence": {
"source": "US Bureau of Labor Statistics",
"source_kind": "public",
"retrieved_at": "2026-10-26T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-26T12:00:00.000Z"
}
],
"as_of": null
}
}
}
Returns, for a US county, state or the nation, the quarterly number of establishments, monthly employment, total wages and average weekly wage, and the average annual pay by year, from the Quarterly Census of Employment and Wages of the US Bureau of Labor Statistics. It covers jobs covered by unemployment insurance only, and the newest quarter is preliminary.
BLS.gov cannot vouch for the data or analyses derived from these data after the data have been retrieved from BLS.gov.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
The area: a five-digit county FIPS code (26163 is Wayne County, Michigan), a two-digit state FIPS code followed by 000 (26000), or US000 for the nation. Place Resolve gives the county code of an address as
county_id. area_fips is a five-digit county FIPS code, a state FIPS code followed by 000, or US000.string
Who employs: all owners, private employers, or federal, state or local government. One of
total, private, federal_government, state_government, local_government. Defaults to "total".string
The industry supersector, or all industries. One of
all, natural_resources_and_mining, construction, manufacturing, trade_transportation_and_utilities, information, financial_activities, professional_and_business_services, education_and_health_services, leisure_and_hospitality, other_services, public_administration. Defaults to "all".Response (200 OK)
Top-level envelope:success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status:
completedstring
Always
place_jobs_wagesobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
US Bureau of Labor Statistics.string
public when the data comes from a public body, commercial otherwisestring
When the lookup was made, as an ISO 8601 UTC time
string | null
When the source says the fact was last updated, or
null when the source gives no dateResult
Nested underdata.result.
boolean
Whether the source has any series for the area, ownership and industry.
string
The area code asked for.
string
The ownership asked for.
string
The industry asked for.
object[]
One entry per published quarter, newest first.
string
The quarter, for example 2026-Q1.
number
Calendar year.
number
Quarter of the year, 1 to 4.
boolean
True when any value of the quarter is preliminary.
number | null
Number of establishments.
null when the source gives no value.number | null
Employment in the first month of the quarter.
null when the source gives no value.number | null
Employment in the second month of the quarter.
null when the source gives no value.number | null
Employment in the third month of the quarter.
null when the source gives no value.number | null
Total wages paid in the quarter, thousands of dollars.
null when the source gives no value.number | null
Average weekly wage, dollars.
null when the source gives no value.object[]
Average annual pay by year, newest first.
number
Calendar year.
number | null
Average annual pay, dollars.
null when the source gives no value.boolean
True when the value is preliminary.
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-jobs-wages \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"area_fips": "26163"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-jobs-wages", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"area_fips": "26163"
}),
});
const result = await agent.tool('lookup/place-jobs-wages', {
area_fips: '26163'
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_jobs_wages",
"result": {
"found": true,
"area_fips": "26163",
"ownership": "total",
"industry": "all",
"quarters": [
{
"period": "2026-Q1",
"year": 2026,
"quarter": 1,
"preliminary": true,
"establishments": 37839,
"employment_month_1": 720803,
"employment_month_2": 716326,
"employment_month_3": 718144,
"total_wages_thousands": 15729948,
"average_weekly_wage": 1684
},
{
"period": "2025-Q4",
"year": 2025,
"quarter": 4,
"preliminary": false,
"establishments": 38398,
"employment_month_1": 723714,
"employment_month_2": 725372,
"employment_month_3": 726125,
"total_wages_thousands": 14760231,
"average_weekly_wage": 1566
}
],
"annual_pay": [
{
"year": 2025,
"average_annual_pay": 79422,
"preliminary": false
},
{
"year": 2024,
"average_annual_pay": 76411,
"preliminary": false
}
]
},
"evidence": {
"source": "US Bureau of Labor Statistics",
"source_kind": "public",
"retrieved_at": "2026-10-26T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-26T12:00:00.000Z"
}
],
"as_of": null
}
}
}
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers
200.Notes
- The source returns the last three calendar years;
quartersandannual_payare newest first. - A value the source leaves blank is null.
total_wages_thousandsis in thousands of dollars, as published. - An area, ownership or industry the source has no series for gives
found: falseand empty lists. - Industry figures are published per ownership: a supersector with ownership
totalis refused. - The source allows 25 keyless queries a day per address, shared by every caller.
- Results return inline. The finished job stays available at
/v1/requests/{request_id}