GET
/
v1
/
search
Returns a list of unified search results from web and news sources
curl --request GET \
  --url https://api.ydc-index.io/v1/search \
  --header 'X-API-Key: <api-key>'
{
  "results": {
    "web": [
      {
        "url": "https://you.com",
        "title": "The World's Greatest Search Engine!",
        "description": "Search on YDC",
        "snippets": [
          "I'm an AI assistant that helps you get more done. What can I help you with?"
        ],
        "thumbnail_url": "https://www.somethumbnailsite.com/thumbnail.jpg",
        "original_thumbnail_url": "https://www.somethumbnailsite.com/thumbnail.jpg",
        "page_age": "2025-06-25T11:41:00",
        "authors": [
          "John Doe"
        ],
        "favicon_url": "https://someurl.com/favicon"
      }
    ],
    "news": [
      {
        "title": "Exclusive | You.com becomes the backbone of the EU's AI strategy",
        "description": "As the EU's AI strategy is being debated, You.com becomes the backbone of the EU's AI strategy.",
        "page_age": "2025-06-25T11:41:00",
        "thumbnail_url": "https://www.somethumbnailsite.com/thumbnail.jpg",
        "original_thumbnail_url": "https://www.somethumbnailsite.com/thumbnail.jpg",
        "url": "https://www.you.com/news/eu-ai-strategy-youcom"
      }
    ]
  },
  "metadata": {
    "request_uuid": "942ccbdd-7705-4d9c-9d37-4ef386658e90",
    "query": "China",
    "latency": 0.123
  }
}
Before You Get StartedGet a free API Key at api.you.com
If you would like to use Bearer token authentication to integrate with Databricks Unity Catalog, please use the /v2/search endpoint instead of /search

Search Operators

OperatorDescriptionExample
siteSearches for webpages from a particular domain (including subdomains)site:uscourts.gov USA v. Enron
filetypeSearches for webpages that are of the specified file typeUSA v. Enron filetype:pdf
langSearches for webpages that are in a particular language (ISO 639-1 format)Modelo lang:es
+Searches for webpages that contain the exact term after the +Enron +GAAP
-Searches for webpages that do not contain the exact term after the -guitar -prs
ANDLogical operator to combine expressionsguitar +prs AND +silversky
ORLogical operator to combine expressionsguitar -prs AND -silversky
NOTNegation of expressionsUSA v. Enron NOT site:uscourts.gov

Authorizations

X-API-Key
string
header
required

Query Parameters

query
string
required

Search query used to retrieve relevant results from index. You may also include search operators to refine your search.

count
integer

Specifies the maximum number of results to return per section. Range 1 ≤ count ≤ 20.

freshness
enum<string>

Specifies the freshness of the results to return.

Available options:
day,
week,
month,
year
offset
integer

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.

country
string

Country Code, one of ['AR', 'AU', 'AT', 'BE', 'BR', 'CA', 'CL', 'DK', 'FI', 'FR', 'DE', 'HK', 'IN', 'ID', 'IT', 'JP', 'KR', 'MY', 'MX', 'NL', 'NZ', 'NO', 'CN', 'PL', 'PT', 'PH', 'RU', 'SA', 'ZA', 'ES', 'SE', 'CH', 'TW', 'TR', 'GB', 'US'].

safesearch
string

Configures the safesearch filter for content moderation. off - no filtering applied.moderate - moderate content filtering (default). strict - strict content filtering.

Response

200 - application/json

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

The response is of type object.