---
title: "Hybrid Search"
method: POST
path: "/api/v1/search/text-to-hybrid-search"
tags: ["search > search"]
---

# Hybrid Search

`POST /api/v1/search/text-to-hybrid-search`

Search images using a text query that scores results against both visual content and text metadata (titles, captions, descriptions, and other text fields).This endpoint is in beta and requires special access, please contact the support team.

## Headers

- `Authorization` string, required

## Request body

- SearchHybridSearchRequest — Hybrid search request
  - `dataset_id` string, uuid, required — The unique identifier for the dataset
  - `text_query` string, required — The text query to search for
  - `negative_text` string, nullable — Optional text describing what to exclude from search results. Steers the visual query embedding away from this direction.
  - `limit` integer — Max number of items to return from hybrid search
  - `datetime_filter` SearchDateTimeRangeInclusiveClause
    - `key` string, required
    - `start_utc_epoch` number, double, nullable
    - `end_utc_epoch` number, double, nullable
    - `operator` 'DateTimeRangeInclusive', required
  - `skip_moderation` boolean — Skip content moderation if enabled
  - `moderation_score_type` 'probability' | 'level' — Score type returned by the moderation service. - PROBABILITY: Scores in range 0-1 (uses BGE Reranker model) - LEVEL: Scores in range 0-5 (uses OpenAI model)

## Response `200`

Successful Response

- SearchHybridSearchResponse — Base search response
  - `data` SearchHybridSearchImage[], required — The results from hybrid search
    - `created_user_id` string, required — The user that created the resource
    - `created_dt` string, date-time, required — The created datetime of the resource
    - `updated_user_id` string, required — The user that last updated the resource
    - `updated_dt` string, date-time, required — The datetime the resource was last updated
    - `coactive_image_id` string, uuid, required — The coactive image id
    - `path` string, nullable — The original path of the image
    - `metadata` object, nullable — The user provided metadata for the image
    - `moderation_score` number, double, nullable — The moderation score of the image
    - `relevance_score` number, double, required — The relevance score of the image

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-22** `1223758be9ba` — 2 warning
  - the `limit` request property's max was set to `200.00`
  - the `limit` request property's min was set to `1.00`

[Change history](https://skmtc.dev/coactive/apis/api-reference/changes/api/v1/search/text-to-hybrid-search/post.md)

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coactive/api-reference/revisions/1223758be9ba/schema)