{"uid":"cap_PfoJU8FKBzN3mM33EPaKJ","slug":"aptibuild-ai-bulk-occupations-data-b5282340","name":"AptiBuild AI — Bulk Occupations Data","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/bulk/occupations","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"state":{"type":"string","description":"Optional: filter by state name (e.g. 'Texas'). Omit for national data."},"major_group":{"type":"string","description":"Optional: filter by SOC major group code prefix (e.g. '15' for Computer occupations, '29' for Healthcare). Omit for full dataset."}}},"responseSchema":{"type":"object","properties":{"count":{"type":"integer"},"source":{"type":"string"},"occupations":{"type":"array","items":{"type":"object"}},"snapshot_date":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"15","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":"$15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VycG3e8a5gQuWZiiUJQzP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns bulk U.S. occupation data from the SOC classification system, optionally filtered by state or major occupational group.","exampleAgentPrompt":"Can you pull all healthcare occupations (SOC major group 29) in California from the AptiBuild AI occupations dataset?","exampleUseCases":[{"title":"State-level workforce analysis","prompt":"Get me the full list of occupations in Texas from the bulk occupations dataset so I can analyze the local labor market."},{"title":"SOC group deep dive","prompt":"Pull all computer and math occupations — that's SOC major group 15 — from the national dataset so I can see what roles are classified there."},{"title":"Full national occupation inventory","prompt":"Fetch the complete national occupations dataset without any filters — I need every SOC occupation record and the snapshot date it was captured."}],"resultDescription":"Returns a JSON object containing a count of matching occupations, the data source identifier, a snapshot date string, and an array of occupation objects conforming to SOC classifications. When filters are applied, only matching records are returned; without filters, the full national dataset is returned.","failureModes":["Invalid state name returns empty or error result","Unknown SOC major group prefix returns zero results","Payment failure (402) if USDC payment is not properly attached","Network timeout on large unfiltered national dataset requests","Malformed query parameters may return unexpected full dataset"],"whenToPreferThis":"Choose this endpoint when you need structured, bulk U.S. occupational data organized by SOC codes and optionally scoped to a specific state. It is well-suited for labor market research, workforce planning tools, or any application that needs to enumerate occupations by category. Prefer this over general web scraping or BLS lookups when you need a pre-aggregated, machine-readable snapshot with snapshot dating.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:43:50.306Z","isFirstParty":false}