> For the complete documentation index, see [llms.txt](https://docs.sumble.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sumble.com/api/lookups/technologies.md).

# 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.

## POST /v6/technologies/find

> Find technologies by name

```json
{"openapi":"3.1.0","info":{"title":"Sumble API","version":"v6"},"servers":[{"url":"https://api.sumble.com"}],"security":[{"api_token":[]}],"components":{"securitySchemes":{"api_token":{"type":"http","scheme":"bearer"}},"schemas":{"GetTechnologiesRequest":{"properties":{"query":{"type":"string","title":"Query"}},"type":"object","required":["query"],"title":"GetTechnologiesRequest"},"GetTechnologiesResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"credits_used":{"type":"integer","title":"Credits Used"},"credits_remaining":{"type":"integer","title":"Credits Remaining"},"technologies":{"items":{"$ref":"#/components/schemas/app__schemas__paid_api__technologies__GetTechnologiesResponse__TechDetails"},"type":"array","title":"Technologies"},"total_count":{"type":"integer","title":"Total Count"}},"type":"object","required":["id","credits_used","credits_remaining","technologies","total_count"],"title":"GetTechnologiesResponse"},"app__schemas__paid_api__technologies__GetTechnologiesResponse__TechDetails":{"properties":{"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["slug","name","count"],"title":"TechDetails"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v6/technologies/find":{"post":{"tags":["technologies"],"summary":"Find technologies by name","operationId":"get_technologies__api_version__technologies_find_post","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTechnologiesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTechnologiesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

***

## 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](#find-technologies).

### Credit cost

1 credit per 100 matched technologies. Unmatched inputs do not consume credits.

## POST /v6/technologies/lookup

> Look up technologies by name, slug, or alias

```json
{"openapi":"3.1.0","info":{"title":"Sumble API","version":"v6"},"servers":[{"url":"https://api.sumble.com"}],"security":[{"api_token":[]}],"components":{"securitySchemes":{"api_token":{"type":"http","scheme":"bearer"}},"schemas":{"LookupTechnologiesRequest":{"properties":{"technologies":{"items":{"type":"string"},"type":"array","maxItems":1000,"minItems":1,"title":"Technologies","description":"List of technology names, slugs, or aliases to look up"}},"type":"object","required":["technologies"],"title":"LookupTechnologiesRequest"},"LookupTechnologiesResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"credits_used":{"type":"integer","title":"Credits Used"},"credits_remaining":{"type":"integer","title":"Credits Remaining"},"matched_count":{"type":"integer","title":"Matched Count"},"results":{"items":{"$ref":"#/components/schemas/app__schemas__paid_api__technologies__LookupTechnologiesResponse__LookupResult"},"type":"array","title":"Results"}},"type":"object","required":["id","credits_used","credits_remaining","matched_count","results"],"title":"LookupTechnologiesResponse"},"app__schemas__paid_api__technologies__LookupTechnologiesResponse__LookupResult":{"properties":{"input":{"type":"string","title":"Input"},"technology":{"anyOf":[{"$ref":"#/components/schemas/app__schemas__paid_api__technologies__LookupTechnologiesResponse__TechDetails"},{"type":"null"}]}},"type":"object","required":["input","technology"],"title":"LookupResult"},"app__schemas__paid_api__technologies__LookupTechnologiesResponse__TechDetails":{"properties":{"id":{"type":"integer","title":"Id"},"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"categories":{"items":{"$ref":"#/components/schemas/TechCategory"},"type":"array","title":"Categories"}},"type":"object","required":["id","slug","name","categories"],"title":"TechDetails"},"TechCategory":{"properties":{"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"name_short":{"type":"string","title":"Name Short"}},"type":"object","required":["slug","name","name_short"],"title":"TechCategory"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v6/technologies/lookup":{"post":{"tags":["technologies"],"summary":"Look up technologies by name, slug, or alias","operationId":"lookup_technologies__api_version__technologies_lookup_post","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LookupTechnologiesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LookupTechnologiesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

***

## 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.

## POST /v6/technologies/categories/lookup

> Look up technology categories by slug or name

```json
{"openapi":"3.1.0","info":{"title":"Sumble API","version":"v6"},"servers":[{"url":"https://api.sumble.com"}],"security":[{"api_token":[]}],"components":{"securitySchemes":{"api_token":{"type":"http","scheme":"bearer"}},"schemas":{"LookupTechnologyCategoriesRequest":{"properties":{"technology_categories":{"items":{"type":"string"},"type":"array","maxItems":1000,"minItems":1,"title":"Technology Categories","description":"List of technology category slugs or names to look up"}},"type":"object","required":["technology_categories"],"title":"LookupTechnologyCategoriesRequest"},"LookupTechnologyCategoriesResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"credits_used":{"type":"integer","title":"Credits Used"},"credits_remaining":{"type":"integer","title":"Credits Remaining"},"matched_count":{"type":"integer","title":"Matched Count"},"results":{"items":{"$ref":"#/components/schemas/app__schemas__paid_api__technologies__LookupTechnologyCategoriesResponse__LookupResult"},"type":"array","title":"Results"}},"type":"object","required":["id","credits_used","credits_remaining","matched_count","results"],"title":"LookupTechnologyCategoriesResponse"},"app__schemas__paid_api__technologies__LookupTechnologyCategoriesResponse__LookupResult":{"properties":{"input":{"type":"string","title":"Input"},"category":{"anyOf":[{"$ref":"#/components/schemas/CategoryDetails"},{"type":"null"}]}},"type":"object","required":["input","category"],"title":"LookupResult"},"CategoryDetails":{"properties":{"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"name_short":{"type":"string","title":"Name Short"},"technologies":{"items":{"$ref":"#/components/schemas/Technology"},"type":"array","title":"Technologies","description":"Technologies in the category. Technologies mentioned most often in job postings appear first."}},"type":"object","required":["slug","name","name_short","technologies"],"title":"CategoryDetails"},"Technology":{"properties":{"id":{"type":"integer","title":"Id"},"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"}},"type":"object","required":["id","slug","name"],"title":"Technology"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v6/technologies/categories/lookup":{"post":{"tags":["technologies"],"summary":"Look up technology categories by slug or name","operationId":"lookup_technology_categories__api_version__technologies_categories_lookup_post","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LookupTechnologyCategoriesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LookupTechnologyCategoriesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sumble.com/api/lookups/technologies.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.