# News by Country and Section
This API returns current news documents by country code and optional section. One call can return a single section or every section for that country.
## Authentication
Subscribe on the pricing page, then send your JoJ API key on every request:
X-JoJAPI-Key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY also works. Do not put the key in the URL or JSON body. The gateway validates the key before the request reaches this API.
## Parameters
country (required): en, ko, au, nz, it, ja, gb, fr, de, in.
section (optional): omit it to receive all sections for that country.
Common sections: top, BUSINESS, ENTERTAINMENT, SPORTS, WORLD, HEALTH.
it, ko, ja, fr, de use SCITECH.
en, au, nz, gb, in use SCIENCE and TECHNOLOGY.
TOP is treated as top. Multiple sections on GET: BUSINESS,SPORTS. On POST you may send a JSON array.
## Calling the API
GET example:
GET /queryNews?country=ko&section=top
POST body example:
{"country":"en","section":["top","BUSINESS"]}
Invalid country or section returns HTTP 400 with errorCode INVALID_REQUEST and the allowed values in message.
## Response
Success (HTTP 200):
```json
{
"status": "success",
"message": "Request successful",
"data": {
"country": "ko",
"sections": ["top"],
"count": 1,
"items": [
{
"docId": "kotop",
"code": "ko",
"id": "top",
"updatedAt": 1757116800000,
"news": [
{
"title": { "_text": "Headline" },
"link": { "_text": "https://example.com/article" },
"url": "https://example.com/article",
"img": "https://example.com/image.jpg",
"content": "Article body",
"summary": "One-sentence summary",
"section": "top"
}
]
}
]
}
}