{"uid":"cap_6CMdMV6oBgPBMDihiLEvz","slug":"aptibuild-ai-bls-occupation-wages-lookup-9511dae3","name":"AptiBuild AI — BLS Occupation Wages Lookup","description":"Discover what to build based on your unique skills and hobbies. AptiBuild AI generates personalized app and business ideas matched to your experience. Free to try.","url":"https://data.aptibuildai.com/data/occupations/wages","method":"GET","headers":{},"bodySchema":{"type":"object","required":["occ_code"],"properties":{"state":{"type":"string","description":"Optional state name filter"},"occ_code":{"type":"string","description":"BLS SOC occupation code (e.g. '29-1141' for Registered Nurses, '15-1252' for Software Developers)"}}},"responseSchema":{"type":"object","properties":{"count":{"type":"integer"},"query":{"type":"object"},"wages":{"type":"array","items":{"type":"object","properties":{"a_pct10":{"type":"string"},"a_pct25":{"type":"string"},"a_pct75":{"type":"string"},"a_pct90":{"type":"string"},"h_pct10":{"type":"string"},"h_pct25":{"type":"string"},"h_pct75":{"type":"string"},"h_pct90":{"type":"string"},"a_median":{"type":"string"},"h_median":{"type":"string"},"occ_code":{"type":"string"},"occ_title":{"type":"string"}}}},"source":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_siJYcVQOZwX6YH43Fl24u","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns BLS wage data (hourly and annual, median and percentile breakdowns) for a given SOC occupation code, optionally filtered by state","exampleAgentPrompt":"What are the annual median and 75th percentile wages for software developers — BLS occupation code 15-1252 — in Texas?","exampleUseCases":[{"title":"Salary benchmarking for job seekers","prompt":"What's the median annual salary and the 90th percentile wage for registered nurses (SOC code 29-1141) in New York? I want to know if my job offer is competitive."},{"title":"Career counseling wage comparison","prompt":"Pull up the BLS wage data for civil engineers, SOC code 17-2051 — I need the full percentile breakdown, hourly and annual, to help a student understand the earning range."},{"title":"Market research for app pricing","prompt":"What do accountants and auditors (occupation code 13-2011) typically earn at the 25th and 75th percentile annually in California? I'm doing market research for a financial planning tool."}],"resultDescription":"Returns a JSON object containing a wages array where each entry includes the occupation code, occupation title, annual and hourly wages at the 10th, 25th, 75th, and 90th percentiles, as well as annual and hourly median wages. Also includes the total count of matching records, the original query parameters echoed back, and a source attribution string indicating the BLS data origin.","failureModes":["Missing or invalid occ_code parameter returns an error — the SOC code is required and must be a valid BLS format (e.g. '15-1252')","Non-existent or misspelled state name may return zero results rather than an error","SOC codes with no BLS wage data on record return an empty wages array with count 0","Malformed SOC code format (e.g. missing hyphen) may cause a lookup failure","Payment failure (402) if the x402 payment is not completed before the request"],"whenToPreferThis":"Use this endpoint when you need structured BLS wage data tied to a specific SOC occupation code, especially when you want percentile breakdowns (10th, 25th, 75th, 90th) at both hourly and annual granularity. It is ideal for salary benchmarking, career research, workforce analytics, or building compensation-aware applications. Prefer this over generic web search when you need machine-readable, structured wage data with consistent schema. The optional state filter makes it useful for geographic wage comparisons.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:40:23.874Z","isFirstParty":false}