Live News | YDC | Documentation

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

1 { 2 "news": { 3 "query": { 4 "original": "Your query about news", 5 "spellcheck_off": false 6 }, 7 "results": [ 8 { 9 "age": "6h", 10 "description": "Any news for you!", 11 "meta_url": { 12 "hostname": "www.wsj.com", 13 "netloc": "wsj.com", 14 "path": "> world > china-to-block-its-rare-earth-experts-from-spilling-their-secrets-8d69b75f", 15 "scheme": "https" 16 }, 17 "page_age": "2025-06-25T11:41:00", 18 "source_name": "WSJ", 19 "thumbnail": { 20 "src": "https://images.wsj.net/im-42431776?width=700&height=449" 21 }, 22 "title": "Exclusive | China Is Tracking Down Its Rare-Earth Experts—and Taking Away Passports", 23 "type": "news_result", 24 "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", 25 "metadata": {}, 26 "article_id": "string" 27 } 28 ], 29 "type": "news", 30 "metadata": { 31 "request_uuid": "942ccbdd-7705-4d9c-9d37-4ef386658e90" 32 } 33 } 34 }

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

qstringRequiredDefaults to Your query about news

Retrieves responses from news media websites that are relevant to the user’s query.

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.

Retrieves responses from news media websites that are relevant to the user's query. <Note> **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](mailto:api@you.com). </Note>

countintegerOptional1-40

Specifies the maximum number of news results to return.

Response

A JSON object containing news results.

newsobject or null

Authentication

Query parameters

Response

Errors