Schlagzeilen über eine News-API nach Land abrufen

Neper sammelt Nachrichten nach Land und Rubrik. Dieselben Daten stehen als Neper News API bereit – ohne dass Sie jede Quelle selbst scrapen müssen, holen Sie Schlagzeilen, Artikel-URLs, Bilder und Zusammenfassungen in Ihre App.

Es gibt einen Endpoint: /queryNews. Sie rufen ihn über einen der beiden Marketplaces auf. Die Anfrageform bleibt gleich; nur Host und Auth-Header ändern sich.

• RapidAPI
• JoJ API

Im Neper-Anleitungsbereich finden Sie diesen API-Leitfaden und künftig ergänzte Neper-Dokumentation an einer Stelle.

Abonnieren Sie auf dem Marketplace, den Sie bereits nutzen, und rufen Sie /queryNews mit dessen Schlüssel auf.

1. Anfrage: country und section

GET und POST werden unterstützt.

• country (Pflicht): en, ko, au, nz, it, ja, gb, fr, de oder in
• section (optional): weglassen, um alle Rubriken des Landes zu erhalten

Häufige Rubriken: top, BUSINESS, ENTERTAINMENT, SPORTS, WORLD, HEALTH.

Wissenschaft und Technik nutzen je nach Land andere Ids:

• it, ko, ja, fr, de → SCITECH
• en, au, nz, gb, in → SCIENCE oder TECHNOLOGY

TOP wird als top behandelt. Bei GET mehrere Rubriken als BUSINESS,SPORTS. Bei POST String, Komma-String oder JSON-Array.

Beispiele:

GET /queryNews?country=en
GET /queryNews?country=ko&section=top
GET /queryNews?country=ko&section=SCITECH

{ "country": "gb", "section": ["SPORTS", "BUSINESS"] }

Nachrichtendokumente aktualisieren sich etwa alle fünf Minuten. updatedAt ist ein Unix-Zeitstempel in Millisekunden.

2. Antwortform

Eine erfolgreiche Antwort sieht so aus:

{
  "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://news.google.com/rss" },
            "url": "https://example.com/article",
            "img": "https://example.com/image.jpg",
            "content": "Article body",
            "summary": "One-sentence summary",
            "section": "top"
          }
        ]
      }
    ]
  }
}

Leicht zu übersehen:

• Ohne section ist data.sections ein leeres Array und alle Rubriken des Landes kommen zurück.
• title und link können Objekte mit _text sein. Vor der Anzeige _text lesen.
• Artikel können auch description und faviconUrl enthalten.
• AI-summary ist für de, en und ko gefüllt. Andere Länder liefern einen leeren String. Auch in unterstützten Ländern kann summary leer sein, wenn die Quellseite keinen brauchbaren Artikeltext hatte.

3. RapidAPI

1. Das RapidAPI-Listing öffnen und einen Plan abonnieren.
2. Den RapidAPI-Schlüssel im Dashboard kopieren.
3. Den RapidAPI-Host aufrufen. Schlüssel nur in Headern senden – nicht in URL oder JSON-Body.

https://neper-news-api.p.rapidapi.com

X-RapidAPI-Key: <YOUR_KEY>
X-RapidAPI-Host: neper-news-api.p.rapidapi.com

curl -G 'https://neper-news-api.p.rapidapi.com/queryNews' \
  --data-urlencode 'country=ko' \
  --data-urlencode 'section=top' \
  -H 'X-RapidAPI-Key: <YOUR_KEY>' \
  -H 'X-RapidAPI-Host: neper-news-api.p.rapidapi.com'

import axios from 'axios'

const res = await axios.get('https://neper-news-api.p.rapidapi.com/queryNews', {
  params: { country: 'ko', section: 'top' },
  headers: {
    'X-RapidAPI-Key': '<YOUR_KEY>',
    'X-RapidAPI-Host': 'neper-news-api.p.rapidapi.com'
  }
})

console.log(res.data)

const res = await axios.post(
  'https://neper-news-api.p.rapidapi.com/queryNews',
  { country: 'en', section: ['top', 'BUSINESS'] },
  {
    headers: {
      'X-RapidAPI-Key': '<YOUR_KEY>',
      'X-RapidAPI-Host': 'neper-news-api.p.rapidapi.com'
    }
  }
)

4. JoJ API

1. Das JoJ-API-Listing öffnen und einen Plan abonnieren.
2. Einen JoJ-API-Schlüssel anlegen oder kopieren.
3. Den JoJ-Host für diese API aufrufen. Das Gateway prüft den Schlüssel und entfernt ihn vor dem Weiterleiten.

https://neper-news-api.jojapi.net

Bevorzugter Header:

X-JoJAPI-Key: <YOUR_KEY>

Ebenfalls möglich:

Authorization: Bearer <YOUR_KEY>
Authorization: <YOUR_KEY>

curl -G 'https://neper-news-api.jojapi.net/queryNews' \
  --data-urlencode 'country=ko' \
  --data-urlencode 'section=top' \
  -H 'X-JoJAPI-Key: <YOUR_KEY>'

import axios from 'axios'

const res = await axios.get('https://neper-news-api.jojapi.net/queryNews', {
  params: { country: 'ko', section: 'top' },
  headers: {
    'X-JoJAPI-Key': '<YOUR_KEY>'
  }
})

console.log(res.data)

const res = await axios.post(
  'https://neper-news-api.jojapi.net/queryNews',
  { country: 'en', section: ['top', 'BUSINESS'] },
  {
    headers: {
      'X-JoJAPI-Key': '<YOUR_KEY>'
    }
  }
)

Bei JoJ API läuft die Abrechnung über das Request-API-Objekt. Ein erfolgreicher Aufruf zählt als eine Einheit – auch wenn section fehlt und alle Rubriken zurückkommen. Monatskontingente und Rate Limits stehen auf der Preisseite. HTTP 5xx und Gateway-Fehler verbrauchen kein Kontingent.

5. Fehler

Status	Typische Bedeutung
400	Ungültiges oder fehlendes country / section. errorCode ist INVALID_REQUEST, erlaubte Werte stehen in message.
401	Schlüssel fehlt/ungültig oder kein aktives Abo
402	JoJ-API-Abrechnung: Kontingent leer, Objekt nicht im Plan oder Guthaben zu niedrig
429	Rate Limit oder Kontingent überschritten
5xx	Vorübergehendes Serverproblem

Vom JoJ-Gateway erzeugte Antworten tragen X-Jojapi-Gateway-Response: true.

Ein häufiger 400-Fall: Wissenschafts-Ids mischen. Bei ko SCITECH statt SCIENCE, bei en SCIENCE oder TECHNOLOGY statt SCITECH.

6. Marketplace wählen

/queryNews verhält sich auf beiden Seiten gleich. RapidAPI nutzen, wenn dort bereits Schlüssel und Abrechnung liegen. JoJ API nutzen, wenn ein JoJ-Key und eine Wallet für mehrere Marketplace-APIs reichen sollen.

Schlüssel nicht in den Quellcode legen. Wenn auf JoJ nur Neper gebraucht wird, den Schlüssel auf diese API beschränken.

Weitere Regionen oder Integrationsfragen: [email protected].