Skip to main content
GET
/
livenews
Returns a list of live news from query
curl --request GET \
  --url https://api.ydc-index.io/livenews \
  --header 'X-API-Key: <api-key>'
{
  "news": {
    "query": {
      "original": "Your query about news",
      "spellcheck_off": false
    },
    "results": [
      {
        "age": "6h",
        "description": "Any news for you!",
        "meta_url": {
          "hostname": "www.wsj.com",
          "netloc": "wsj.com",
          "path": "> world > china-to-block-its-rare-earth-experts-from-spilling-their-secrets-8d69b75f",
          "scheme": "https"
        },
        "page_age": "2025-06-25T11:41:00",
        "source_name": "WSJ",
        "thumbnail": {
          "src": "https://images.wsj.net/im-42431776?width=700&height=449"
        },
        "title": "Exclusive | China Is Tracking Down Its Rare-Earth Experts—and Taking Away Passports",
        "type": "news_result",
        "url": "https://www.wsj.com/world/china-to-block-its-rare-earth-experts-from-spilling-their-secrets-8d69b75f?gaa_at=eafs&gaa_n=ASWzDAiVjqRNxFmx5h0MkVKtlAuVL0B8yQIDw3q7BheARNdP_8kbbzG50lB9&gaa_ts=685c3985&gaa_sig=x_9tkHwj_WnP29wU-sgBvg0clotjEVKnMak6vgU98b6mdtl5vl0Iu8k96Ep4H_YZRrt-38wFlodzzWcHrWYNWQ%3D%3D",
        "metadata": {},
        "article_id": "<string>"
      }
    ],
    "type": "news",
    "metadata": {
      "request_uuid": "942ccbdd-7705-4d9c-9d37-4ef386658e90"
    }
  }
}
NOTE: The You.com news API is currently available to exclusive early access partners.To express interest in early access, please reach out via email to api@you.com.
ATTENTION: The correct cURL code to use in your API call is in the playground. Click on Try it in the bar above to open the playground.

​
Description

This endpoint retrieves responses from news media websites that are relevant to the user’s query.

​
Errors

The endpoint returns as a structured JSON object with status, code, title, and detail fields:
HTTPCodeWhen it happens
401bad_requestThis can happen for a missing API key: {"detail": "API key is required"}, an invalid/expired API key: {"detail": "Invalid or expired API key"} or for other auth parsing errors: {"detail": "<error message>"}
403forbiddenAPI key lacks scope for the path (e.g., /livenews): {"detail": "Missing required scopes"}
500Internal Server Error (auth/authorization middleware)This can happen in the case of authentication failure: {"detail": "Internal authentication error"} or authorization failure: {"detail": "Internal authorization error"}

Authorizations

​
X-API-Key
string
header
required

The unique API Key required to authorize API access. Learn how to get yours in the “Get your API key” section of the documentation.

Query Parameters

​
q
string
default:Your query about news
required

Search query used to retrieve relevant news from the web.

Example:

"Your query about news"

​
count
integer

Specifies the maximum number of news results to return.

Required range: 1 <= x <= 40

Response

A JSON object containing news results.

​
news
object
⌘I