---
title: "GET /experimental/search"
method: GET
path: "/experimental/search"
tags: ["Search"]
---

# GET /experimental/search

`GET /experimental/search`

Hybrid keyword + vector search across tiles and skills.

## Query parameters

- `q` string
- `searchMode` union
  - 'text'
  - 'hybrid'
  - 'semantic'
- `page[number]` integer
- `page[size]` integer
- `filter[type][eq]` union
  - 'tile'
  - 'skill'
- `sort` union
  - 'score'
  - '-score'
  - 'aggregateScore'
  - '-aggregateScore'
  - 'qualityScore'
  - '-qualityScore'
  - 'impactScore'
  - '-impactScore'
  - 'updatedAt'
  - '-updatedAt'
  - 'securityLevel'
  - '-securityLevel'
  - 'evalImprovementMultiplier'
  - '-evalImprovementMultiplier'
- `filter[workspaceId]` string, uuid
- `filter[workspaceId][eq]` string, uuid
- `filter[workspaceId][ne]` string, uuid
- `filter[workspaceId][gt]` string, uuid
- `filter[workspaceId][gte]` string, uuid
- `filter[workspaceId][lt]` string, uuid
- `filter[workspaceId][lte]` string, uuid
- `filter[workspaceId][like]` string, uuid
- `filter[describes]` string
- `filter[describes][eq]` string
- `filter[describes][ne]` string
- `filter[describes][gt]` string
- `filter[describes][gte]` string
- `filter[describes][lt]` string
- `filter[describes][lte]` string
- `filter[describes][like]` string
- `filter[packageRegistry]` string
- `filter[packageRegistry][eq]` string
- `filter[packageRegistry][ne]` string
- `filter[packageRegistry][gt]` string
- `filter[packageRegistry][gte]` string
- `filter[packageRegistry][lt]` string
- `filter[packageRegistry][lte]` string
- `filter[packageRegistry][like]` string
- `filter[featured]` boolean
- `filter[featured][eq]` boolean
- `filter[featured][ne]` boolean
- `filter[hasSkills]` boolean
- `filter[hasSkills][eq]` boolean
- `filter[hasSkills][ne]` boolean
- `filter[hasSteering]` boolean
- `filter[hasSteering][eq]` boolean
- `filter[hasSteering][ne]` boolean
- `filter[hasDocs]` boolean
- `filter[hasDocs][eq]` boolean
- `filter[hasDocs][ne]` boolean
- `filter[includePrivate]` boolean
- `filter[includePrivate][eq]` boolean
- `filter[includePrivate][ne]` boolean
- `filter[includeInvalid]` boolean
- `filter[includeInvalid][eq]` boolean
- `filter[includeInvalid][ne]` boolean
- `include` union
  - 'versions'
  - 'tile-skills'
  - union[]
    - union
      - 'versions'
      - 'tile-skills'

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
    - `first` string, uri, required
    - `last` string, uri, nullable, required
    - `next` string, uri, nullable, required
    - `prev` string, uri, nullable, required
  - `meta` object, required
    - `pagination` object, required
      - `total` integer, required
      - `pages` integer, required
      - `number` integer, required
      - `size` integer, required
  - `data` union[], required
    - union
      - object
        - `id` string, uuid, required
        - `type` 'tile', required
        - `attributes` object, required
          - `name` string, required
          - `fullName` string, required
          - `describes` string, nullable, required
          - `featured` boolean, required
          - `isPrivate` boolean, required
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
          - `versions` object[]
            - `fingerprint` string, required
            - `version` string, required
            - `major` number, required
            - `minor` number, required
            - `patch` number, required
            - `prerelease` string, nullable, required
            - `summary` string, required
            - `describes` string, nullable, required
            - `docs` string, nullable, required
            - `hasDocs` boolean, required
            - `hasSteering` boolean, required
            - `hasSkills` boolean, required
            - `archived` boolean, required
            - `createdAt` string, date-time, required
            - `evalScore` integer, nullable, required
            - `evalBaselineScore` integer, nullable, required
            - `evalImprovement` integer, nullable, required
            - `evalImprovementMultiplier` number, nullable, required
            - `skills` object[]
              - …
          - `scores` object, required
            - `version` string, required
            - `aggregate` number, nullable, required
            - `quality` number, nullable, required
            - `impact` number, nullable, required
            - `security` union, required — Deprecated legacy Snyk overall grade. Use `securityLevel` instead.
              - …
            - `securityLevel` union, required
              - …
            - `evalAvg` number, nullable, required
            - `evalBaseline` number, nullable, required
            - `evalImprovement` number, nullable, required
            - `evalImprovementMultiplier` number, nullable, required
            - `evalCount` integer, nullable, required
            - `validationErrors` string[], required
            - `lastScoredAt` string, date-time, nullable, required
        - `relationships` object, required
          - `workspace` object, required
            - `data` object, required
              - …
      - object
        - `id` string, uuid, required
        - `type` 'skill', required
        - `attributes` object, required
          - `name` string, required
          - `description` string, required
          - `sourceUrl` union, required
            - ''
            - string, uri
          - `path` string, required
          - `featured` boolean, required
          - `isPrivate` boolean, required
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
          - `versions` object[]
            - `sourceRef` string, required
            - `name` string, required
            - `description` string, required
            - `createdAt` string, date-time, required
          - `validationPassed` boolean, nullable, required
          - `scores` object, required
            - `version` string, required
            - `aggregate` number, nullable, required
            - `quality` number, nullable, required
            - `impact` number, nullable, required
            - `security` union, required — Deprecated legacy Snyk overall grade. Use `securityLevel` instead.
              - …
            - `securityLevel` union, required
              - …
            - `evalAvg` number, nullable, required
            - `evalBaseline` number, nullable, required
            - `evalImprovement` number, nullable, required
            - `evalImprovementMultiplier` number, nullable, required
            - `evalCount` integer, nullable, required
            - `validationErrors` string[], required
            - `lastScoredAt` string, date-time, nullable, required

## Other responses

- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/tessl/apis/tessl-api.md) · [All operations](https://skmtc.net/tessl/apis/tessl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tessl/tessl-api/versions/fbb186825642/schema)