{"uid":"cap_Ri7Uc0UcJzATriLO1i15B","slug":"soc-2018-occupation-code-search-d1a7fa73","name":"SOC 2018 Occupation Code Search","description":"Search SOC 2018 occupations by words in the title or a code prefix; optional level filter; capped at 50.","url":"https://industry-occupation-codes.x402tookit.com/soc-search?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","required":["q"],"properties":{"q":{"type":"string","description":"Words like 'registered nurse' or 'software', or a code prefix like 15-12"},"level":{"type":"integer","description":"1 major group, 2 minor group, 3 broad occupation, 4 detailed occupation"},"limit":{"type":"integer","description":"Results 1 to 50 (default 10)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"query":{"type":["null","object"],"properties":{"q":{"type":["null","string"]},"level":{"type":["null","number"]}}},"source":{"type":["null","string"]},"matches":{"type":["array","null"],"items":{"type":"object","properties":{"code":{"type":["null","string"]},"level":{"type":["null","number"]},"title":{"type":["null","string"]},"levelName":{"type":["null","string"]},"matchScore":{"type":["null","number"]}}}},"reasons":{"type":["array","null"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"matchedBy":{"type":["null","string"]},"truncated":{"type":["boolean","null"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]},"totalMatches":{"type":["null","number"]}}}}}}},"responseSchema":null,"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_01AjVugrEDCGYyGLCmgsx","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":"Search Standard Occupational Classification (SOC) 2018 occupations by keyword or code prefix, with optional level filtering, returning up to 50 matches.","exampleAgentPrompt":"Can you search the SOC 2018 occupation codes for anything related to 'software developer' and give me up to 20 results, only at the detailed occupation level (level 4)?","exampleUseCases":[{"title":"Classify job posting by SOC code","prompt":"I have a job posting for a 'registered nurse' — can you search the SOC 2018 codes for that title and find the most relevant detailed occupation code so I can tag it correctly?"},{"title":"Explore occupations under a code prefix","prompt":"Can you search SOC 2018 for occupation codes starting with the prefix '13-10' and show me up to 30 results so I can see all the business operations specialist occupations?"},{"title":"Build occupation dropdown for HR tool","prompt":"I need a list of all major-group-level SOC 2018 occupations related to 'management' — can you search and return just the level 1 results?"}],"resultDescription":"Returns a list of matching SOC 2018 occupation entries, each with a code (e.g. '15-1252'), title, numeric level (1–4), level name (e.g. 'Detailed Occupation'), and a match score. Also includes total match count, whether results were truncated, the echoed query parameters, data source attribution, and an as-of date.","failureModes":["No matches found for the query term — returns empty matches array","Query parameter 'q' missing — returns 400 or validation error","Limit set above 50 — capped or rejected","Invalid level value (outside 1–4) — returns validation error or unfiltered results","Service degraded — degraded flag set true with partial or no results"],"whenToPreferThis":"Use this endpoint when you need to find or validate SOC 2018 Standard Occupational Classification codes by keyword search or code prefix. It is specifically suited for fuzzy title-based discovery (e.g. entering 'nurse' to find all nursing occupations) or prefix-based browsing of the SOC hierarchy. Prefer it over the SOC code-to-detail endpoint when you don't already know the exact code, and over the SOC child-listing endpoint when you want keyword matching rather than hierarchical traversal.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:31:01.501Z","isFirstParty":false,"canonicalSlug":"soc-2018-occupation-code-search-d1a7fa73"}