Hybrid Search | Coactive AI

1 import requests 2 3 url = "https://api.coactive.ai/api/v1/search/text-to-hybrid-search" 4 5 payload = { 6 "dataset_id": "2eef46c3-9766-42d4-9038-be5385a0b0b0", 7 "text_query": "Frog", 8 "limit": 100, 9 "offset": 0, 10 "datetime_filter": { 11 "start_utc_epoch": 1732000000, 12 "end_utc_epoch": 1752055200, 13 "key": "versioncreated", 14 "operator": "DateTimeRangeInclusive" 15 } 16 } 17 headers = { 18 "Authorization": "Bearer <token>", 19 "Content-Type": "application/json" 20 } 21 22 response = requests.post(url, json=payload, headers=headers) 23 24 print(response.json())

1 { 2 "data": [ 3 { 4 "created_user_id": "user_example", 5 "created_dt": "2018-09-11T15:11:45Z", 6 "updated_user_id": "user_example", 7 "updated_dt": "2018-09-11T15:11:45Z", 8 "coactive_image_id": "a6894d72-612d-4c20-b4d0-8f3f21c2bb10", 9 "path": "s3://your-s3-bucket/path/to/image_1.jpg", 10 "relevance_score": 1, 11 "metadata": { 12 "artist": "Painter 1" 13 }, 14 "moderation_score": 3 15 }, 16 { 17 "created_user_id": "user_example", 18 "created_dt": "2019-05-11T04:10:24Z", 19 "updated_user_id": "user_example", 20 "updated_dt": "2019-05-11T04:10:24Z", 21 "coactive_image_id": "15cef525-11f8-4f3f-8950-5ab8ce5bb7a7", 22 "path": "s3://your-s3-bucket/path/to/image_2.jpg", 23 "relevance_score": 2, 24 "metadata": { 25 "artist": "Painter 2" 26 }, 27 "moderation_score": 1 28 } 29 ] 30 }

Performs a semantic search using a text query that fuses visual content and user-provided metadata to retrieve the most contextually relevant results.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

dataset_idstringRequiredformat: "uuid4"

The unique identifier for the dataset

text_querystringRequired

The text query to search for

limitintegerOptional1-200Defaults to 100

Max number of items to return from hybrid search

offsetintegerOptional0-300Defaults to 0

Offset number for pagination

datetime_filterobject or any or nullOptional

Filter results to only include items with timestamps within this datetime range

Response

Successful Response

datalist of objects

The results from hybrid search

Authentication

Request

Response

Errors