List

API Reference

Livenews

Returns a list of live news from query

get/livenews

Returns a list of live news from query

Query Parameters

qstring

Search query used to retrieve relevant news from index

Returns

newsobject

Hide ParametersShow Parameters

queryobject

Hide ParametersShow Parameters

originalstring

spellcheck_offboolean

resultsarray of object

Hide ParametersShow Parameters

agestring

titlestring

typestring

urlstring

formaturi

article_idstring

optional

descriptionstring

optional

meta_urlobject

optional

Hide ParametersShow Parameters

hostnamestring

netlocstring

pathstring

schemestring

metadatamap

optional

page_agestring

optional

formatdate-time

source_namestring

optional

thumbnailobject

optional

Hide ParametersShow Parameters

srcstring

formaturi

typestring

metadataobject

optional

Hide ParametersShow Parameters

request_uuidstring

formatuuid

HTTPTypeScriptPython

curl https://api.you.com/livenews \
    -H "X-API-Key: $YOU_API_API_KEY" \
    -d '{}'

200 Example

{
  "news": {
    "query": {
      "original": "China",
      "spellcheck_off": false
    },
    "results": [
      {
        "age": "6h",
        "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",
        "article_id": "article_id",
        "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"
        },
        "metadata": {
          "foo": "bar"
        },
        "page_age": "2019-12-27T18:11:19.117Z",
        "source_name": "WSJ",
        "thumbnail": {
          "src": "https://images.wsj.net/im-42431776?width=700&height=449"
        }
      }
    ],
    "type": "news",
    "metadata": {
      "request_uuid": "942ccbdd-7705-4d9c-9d37-4ef386658e90"
    }
  }
}