Search | YDC | Documentation

This endpoint is designed to return LLM-ready web results based on a user’s query. Based on a classification mechanism, it can return web results and news associated with your query. If you need to feed an LLM with the results of a query that sounds like What is the weather like in France in September?, then this endpoint is the right one for you.

WARNING: If you would like to use Bearer token authentication to integrate with Databricks Unity Catalog, please use the /v2/search endpoint instead of /search

This endpoint is designed to return LLM-ready web results based on a user's query. Based on a classification mechanism, it can return web results and news associated with your query. If you need to feed an LLM with the results of a query that sounds like `What is the weather like in France in September?`, then this endpoint is the right one for you. <Warning>**WARNING**: If you would like to use Bearer token authentication to integrate with Databricks Unity Catalog, please use the `/v2/search` endpoint instead of `/search`</Warning>

Authentication

X-API-Keystring

A unique API Key is required to authorize API access. For details, see how to get your API Key.

Query Parameters

querystringRequiredDefaults to Your query

The search query used to retrieve relevant results from the web. You can also include search operators to refine your search.

countintegerOptional1-100

Specifies the maximum number of search results to return per section (the sections are web and news. See the JSON response to visualize them).

freshnessstringOptional

Specifies the freshness of the results to return. Provide either one of day, week, month, year, or a date range string in the format YYYY-MM-DDtoYYYY-MM-DD.

When your search query includes a temporal keyword and you also set a freshness parameter, the search will use the broader (i.e., less restrictive) of the two timeframes. For example, if you use query=news+this+week&freshness=month, the results will use a freshness of month.

Specifies the freshness of the results to return. Provide either one of `day`, `week`, `month`, `year`, or a date range string in the format `YYYY-MM-DDtoYYYY-MM-DD`. When your search query includes a temporal keyword and you also set a freshness parameter, the search will use the broader (i.e., less restrictive) of the two timeframes. For example, if you use `query=news+this+week&freshness=month`, the results will use a freshness of month.

offsetintegerOptional

Indicates the offset for pagination. The offset is calculated in multiples of count. For example, if count = 5 and offset = 1, results 5–10 will be returned. Range 0 ≤ offset ≤ 9.

countryenumOptional

The country code that determines the geographical focus of the web results.

safesearchenumOptional

Configures the safesearch filter for content moderation. This allows you to decide whether to return NSFW content or not.

Allowed values:

livecrawlenumOptional

Indicates which section(s) of search results to livecrawl and return full page content.

Allowed values:

livecrawl_formatsenumOptional

Indicates the format of the livecrawled content.

Allowed values:

Response

A JSON object containing unified search results from web and news sources

resultsobject or null

metadataobject or null

1	import requests
2
3	url = "https://ydc-index.io/v1/search"
4
5	querystring = {"query":"Your query"}
6
7	headers = {"X-API-Key": "<apiKey>"}
8
9	response = requests.get(url, headers=headers, params=querystring)
10
11	print(response.json())

1	{
2	"results": {
3	"web": [
4	{
5	"url": "https://you.com",
6	"title": "The World's Greatest Search Engine!",
7	"description": "Search on YDC",
8	"snippets": [
9	"I'm an AI assistant that helps you get more done. What can I help you with?"
10	],
11	"thumbnail_url": "https://www.somethumbnailsite.com/thumbnail.jpg",
12	"page_age": "2025-06-25T11:41:00",
13	"authors": [
14	"John Doe"
15	],
16	"favicon_url": "https://someurl.com/favicon"
17	}
18	],
19	"news": [
20	{
21	"title": "Exclusive \| You.com becomes the backbone of the EU's AI strategy",
22	"description": "As the EU's AI strategy is being debated, You.com becomes the backbone of the EU's AI strategy.",
23	"page_age": "2025-06-25T11:41:00",
24	"thumbnail_url": "https://www.somethumbnailsite.com/thumbnail.jpg",
25	"url": "https://www.you.com/news/eu-ai-strategy-youcom"
26	}
27	]
28	},
29	"metadata": {
30	"request_uuid": "942ccbdd-7705-4d9c-9d37-4ef386658e90",
31	"query": "Your query",
32	"latency": 0.123
33	}
34	}

Authentication

Query Parameters

Response

Errors