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": "China",
      "spellcheck_off": false
    },
    "results": [
      {
        "age": "6h",
        "description": "",
        "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"
    }
  }
}

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

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
q
string
required

Search query used to retrieve relevant news from index

Response

200 - application/json

A JSON object containing news results.

The response is of type object.