# Response Format

A successful request returns HTTP `200`:

```json
{
  "score": 7.1,
  "article": {
    "article_id": "32445ab27737dcdad9119b67fb1d379908a41ecf",
    "url": "https://www.example.com/edition/",
    "title": "Article Title",
    "published_at": "2026-08-27T07:07:00.000+03:00",
    "summary": "Article's extractive summary",
    "main_image": "https://media.example.com/image.png"
  },
  "chunk": {
    "chunk_id": "32445ab27737dcdad9119b67fb1d379908a41ecf_6",
    "chunk_index": 6,
    "text": "Relevant chunk matching the query."
  },
  "metadata": {
    "language": "english",
    "country": "US",
    "category": [
      "Economy, Business and Finance"
    ],
    "sentiment": "positive",
    "domain": "example.com",
    "site_type": "news",
    "topic": [
      "business reporting and performance",
      "business information",
      "business strategy and marketing"
    ],
    "person": [
"Elon Musk"
],
    "organization": [
      "nexen tire",
      "porsche",
      "aiming",
      "bmw"
    ],
    "location": [
"United States"
],
    "ticker": [
      "P911",
      "BMW"
    ],
    "source_type": "local_news",
    "political_bias": "left",
    "trust_category": "trusted_news",
    "domain_rank": 193
  }
}
```

| Field | Description |
| --- | --- |
| query | The submitted query |
| total_results | Number of matching articles, up to k |
| results | Matching article results |
| requests_left | Remaining credit balance |
| credits_used | Credits used by this search |
| results[].article | Article ID, URL, title, publish date, and summary |
| results[].chunk.text | The most relevant article excerpt |
| results[].metadata | Language, country, category, sentiment, domain, source type, topic, person, organization, location, ticker, political_bias, trust_category, domain_rank |

## Get the full article text

Use `article.article_id` as the News API `uuid:` query. Set `ts` to the Unix timestamp in milliseconds from 30 days before the request so the News API searches the full News Search coverage window.

`GET`

```bash
https://api.webz.io/api/news?token=YOUR_TOKEN&q=uuid:ARTICLE_UUID&ts=YOUR_TIMESTAMP_30_DAYS_AGO

```

Replace `ARTICLE_UUID` with `article.article_id` from the News Search response. The News API returns the original article document, including its full text.
