{"uid":"cap_DKt91LivQYUmlLYXEZMYc","slug":"citiview-bls-wage-data-lookup-dfe96378","name":"Citiview BLS Wage Data Lookup","description":"Salary data for any job title: employment, mean and median annual and hourly pay, and 10th to 90th percentile annual pay, nationally and for a US state, from the BLS occupational wage survey. Job titles are matched to SOC codes automatically.","url":"https://agents.citiviewgroup.com/v1/wages?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"soc":{"type":"string","description":"6-digit SOC code instead, e.g. 15-1252"},"state":{"type":"string","description":"State name or code"},"occupation":{"type":"string","description":"Job title"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_d4eocR1GDwwqlDpUXTH4K","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns BLS occupational wage survey data for any job title or SOC code, including employment count, mean/median pay, and percentile pay ranges, nationally or by US state.","exampleAgentPrompt":"What does the BLS say about salaries for data scientists in California — I need the mean, median, and 10th to 90th percentile annual pay figures.","exampleUseCases":[{"title":"Salary benchmarking for job offer","prompt":"I'm negotiating a job offer as a software developer in Texas — can you pull the BLS wage data including median and 90th percentile annual pay so I know what the market looks like?"},{"title":"HR compensation band research","prompt":"We're setting pay bands for our registered nurses in New York. Can you get me the BLS occupational wage data — employment count, mean, median, and all the percentile breakdowns?"},{"title":"Career earnings comparison","prompt":"I'm deciding between becoming a civil engineer or a mechanical engineer — can you look up the national BLS salary data for both so I can compare median pay and top-end earnings?"}],"resultDescription":"Returns structured BLS occupational wage survey data including: the matched SOC code and occupation title, total employment, mean and median annual salary, mean and median hourly wage, and annual pay at the 10th, 25th, 75th, and 90th percentiles — either nationally or filtered to a specific US state.","failureModes":["Job title cannot be matched to a SOC code — returns an error or empty result","SOC code provided does not exist in BLS data — returns not found","State name or code not recognized — may return national data or error","BLS data unavailable for a given occupation/state combination (suppressed due to small sample) — returns no data","Invalid query parameters — returns 400-level error"],"whenToPreferThis":"Use this endpoint when you need authoritative, government-sourced wage and employment data tied to official BLS occupational classifications. Prefer it over scraped or crowdsourced salary sites (e.g. Glassdoor, Payscale) when accuracy and official sourcing matter, such as for HR compensation planning, policy research, or career counseling. It is especially useful when you need percentile breakdowns (not just averages) or state-level granularity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T06:36:43.759Z","isFirstParty":false,"canonicalSlug":"citiview-bls-wage-data-lookup-dfe96378"}