For the complete documentation index, see llms.txt. This page is also available as Markdown.
Technology find
Find technologies
Search Sumble's technology catalog by name. Returns up to 50 technologies whose names match the query, ranked by exact-name match first and then by how many organizations mention the technology across jobs and people.
Each result includes the technology slug (the canonical identifier you can pass to other API endpoints, such as organization filters), the display name, and a count of organizations that mention it. The response also returns total_count — the total number of matching technologies in the catalog, which may exceed the 50 rows returned.
Use this endpoint to look up valid technology slugs before calling endpoints that accept a technology filter.
Credit cost
1 credit per request that returns at least one technology. Requests with no matches do not consume credits.
Find technologies by name
post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
querystringRequired
Responses
200
Successful Response
application/json
idstring · uuidRequired
credits_usedintegerRequired
credits_remainingintegerRequired
total_countintegerRequired
422
Validation Error
application/json
post/v9/technologies/find
Look up technologies
Resolve a list of technology names, slugs, or aliases to their canonical Sumble technologies. Pass a technologies array (1–1000 entries) and receive one entry in results for every input, in the same order you supplied them.
Each result pairs your original input with the matched technology, or null when nothing matches — so the response always lines up one-to-one with your request. Use its canonical slug as the identifier for other API endpoints, such as organization filters. A matched technology also lists the categories it belongs to.
The response also returns matched_count, the number of inputs that resolved to a technology.
Use this endpoint when you already have a set of technology names, slugs, or aliases — for example, from a spreadsheet or a prior call — and need stable, canonical identifiers to pass into follow-up requests. To search the catalog by a single partial name instead, use Find technologies.
Credit cost
1 credit per 100 matched technologies. Unmatched inputs do not consume credits.
Look up technologies by name, slug, or alias
post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
technologiesstring[] · min: 1 · max: 1000Required
List of technology names, slugs, or aliases to look up
Responses
200
Successful Response
application/json
idstring · uuidRequired
credits_usedintegerRequired
credits_remainingintegerRequired
matched_countintegerRequired
422
Validation Error
application/json
post/v9/technologies/lookup
Look up technology categories
Resolve a list of technology category slugs or names to their canonical Sumble categories. Pass a technology_categories array (1–1000 entries) and receive one entry in results for every input, in the same order you supplied them.
Each result pairs your original input with the matched category, or null when nothing matches. A matched category includes the technologies it contains, ordered by how frequently they appear in job postings.
The response also returns matched_count, the number of inputs that resolved to a category.
Use this endpoint when you have a set of category slugs or names and need to enumerate the technologies they contain — for example, to expand a category filter into individual technology slugs before passing them to another endpoint.
Credit cost
1 credit per 100 matched categories. Unmatched inputs do not consume credits.
Look up technology categories by slug or name
post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
