Knowledge | You.com Web Search API | You.com

Set knowledge: "core" on POST /v1/search to request licensed-data results alongside web and news. When the query matches, those results land in results.knowledge. When none are relevant, the key is omitted rather than returned as an empty array.

knowledge is on the POST request body only. GET /v1/search does not accept it.

Request

curl -X POST https://ydc-index.io/v1/search \
  -H "X-API-Key: $YDC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Nvidia latest quarterly revenue",
    "count": 5,
    "knowledge": "core"
  }'

core is the only accepted value.

from youdotcom import You
with You() as you:
    res = you.search(
        query="Nvidia latest quarterly revenue",
        count=5,
        knowledge="core",
    )
    if res.results and res.results.knowledge:
        for item in res.results.knowledge:
            print(item.title)
            print(item.description)

What You Get

Up to 25 knowledge results are returned, limited to those relevant to the query.

Each item is a KnowledgeResult. type identifies the kind of result and determines which fields it populates. type, title, and attribution are required on every kind.

answer is the only type currently returned. Ignore a value you do not recognize rather than failing on it. A new kind may populate a different set of fields.

For type: answer, description is required and as_of is optional.

Field	Required	Description
`type`	Yes	Kind of knowledge result. `answer` is the only value currently returned.
`title`	Yes	Title of the result.
`attribution`	Yes	Display credit for the data behind the result. These are credits rather than citations: each entry names a provider and carries no URL.
`description`	On `type: answer`	Description drawn from proprietary licensed data.
`as_of`	No	Date the underlying data covers, as `YYYY-MM-DD`. Omitted when the provider reports no date.

Each attribution entry has:

Field	Required	Description
`name`	Yes	Data provider, such as Fiscal.ai.
`source_description`	No	Description of the provider.

Example Response

{
  "results": {
    "web": [
      {
        "url": "https://nvidianews.nvidia.com/news/nvidia-announces-financial-results-for-first-quarter-fiscal-2027",
        "title": "NVIDIA Announces Financial Results for First Quarter Fiscal 2027",
        "description": "NVIDIA today reported revenue for the first quarter ended April 26, 2026.",
        "favicon_url": "https://you.com/favicon?domain=nvidianews.nvidia.com&size=128"
      }
    ],
    "knowledge": [
      {
        "type": "answer",
        "title": "NVIDIA Corporation Total Revenues (Normalized) (Quarterly)",
        "description": "NVIDIA Corporation Total Revenues (Normalized) (Quarterly)'s latest value was $81,615,000,000 in Apr 2026, up 6,424.0% since Jan 2015. Quarterly data from Jan 2015 to Apr 2026, with a maximum of $81,615,000,000 in Apr 2026 and a minimum of $1,151,000,000 in Apr 2015.",
        "attribution": [
          {
            "name": "Fiscal.ai",
            "source_description": "Fiscal.ai is a financial data provider that publishes as-reported and standardized company financials, segments, KPIs, and ratios extracted from filings."
          }
        ],
        "as_of": "2026-04-26"
      }
    ]
  },
  "metadata": {
    "search_uuid": "c3d4e5f6-a7b8-9012-cdef-345678901234",
    "query": "Nvidia latest quarterly revenue",
    "latency": 0.8123
  }
}

View full API reference

Next Steps

Web Search API Overview

How search works, what you get, and pricing

News Results

News articles returned alongside web results when the query has news intent

API reference

Request and response schemas for knowledge