Timelapse News API
Integrieren Sie KI-gesteuerte Nachrichtenanalysen, Zeitreihendaten und personalisierte Berichte in Ihre Anwendungen.
API-Übersicht
Die Timelapse News API bietet Zugriff auf unsere umfangreiche Sammlung von Nachrichtendaten, KI-generierten Analysen und Zeitreiheninformationen. Unsere API wurde für Entwickler, Unternehmen und Forscher konzipiert, die hochwertige Nachrichteninhalte und -analysen in ihre eigenen Anwendungen integrieren möchten.
Echtzeit-Updates
Kontinuierlich aktualisierte Nachrichtendaten aus vertrauenswürdigen Quellen weltweit.
KI-Analysen
Automatisch generierte Zusammenfassungen, Stimmungsanalysen und Trendberichte.
Erweiterte Filterung
Filtern Sie Nachrichten nach Kategorie, Datum, Quelle, Relevanz und mehr.
Erste Schritte
1. API-Schlüssel erhalten
Registrieren Sie sich für einen API-Schlüssel, indem Sie ein Business-Abonnement abschließen oder uns für ein individuelles Angebot kontaktieren.
2. Authentifizierung einrichten
Verwenden Sie Ihren API-Schlüssel in allen Anfragen über den Authorization-Header:
Authorization: Bearer YOUR_API_KEY
3. Erste API-Anfrage senden
Eine einfache Anfrage, um die aktuellen Schlagzeilen abzurufen:
curl -X GET "https://api.timelapse.news/v1/headlines" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"
Beispielantwort:
{
"status": "success",
"data": {
"headlines": [
{
"id": 12345,
"date": "2023-05-01",
"time": "15:30",
"category": "Politik",
"headline": "Neue Gesetzesinitiative zum Klimaschutz vorgestellt",
"details": "Die Bundesregierung hat heute eine neue Gesetzesinitiative...",
"url": "https://example.com/news/12345"
},
// Weitere Schlagzeilen...
],
"total": 124,
"page": 1,
"limit": 10
}
}
API-Endpunkte
GET /v1/headlines
Ruft die neuesten Nachrichtenschlagzeilen ab, optional gefiltert nach Datum, Kategorie oder Suchbegriff.
Parameter:
| Name | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| date | String | Datum im Format YYYY-MM-DD | Optional |
| category | String | Kategorie der Nachrichten (z.B. "Politik", "Wirtschaft", "Technik") | Optional |
| q | String | Suchbegriff für Volltextsuche | Optional |
| limit | Integer | Anzahl der zurückgegebenen Ergebnisse (Standard: 10, Max: 100) | Optional |
| page | Integer | Seitennummer für Paginierung (Standard: 1) | Optional |
GET /v1/analysis
Ruft KI-generierte Analysen und Zusammenfassungen von Nachrichtentrends ab.
Parameter:
| Name | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| date | String | Datum im Format YYYY-MM-DD | Optional |
| category | String | Kategorie der Nachrichten | Optional |
| format | String | Ausgabeformat (html, text, markdown) | Optional |
GET /v1/timeline
Ruft Zeitreihendaten zur Anzahl der Nachrichten pro Tag ab, optional gefiltert nach Kategorie oder Zeitraum.
Parameter:
| Name | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| start_date | String | Startdatum im Format YYYY-MM-DD | Optional |
| end_date | String | Enddatum im Format YYYY-MM-DD | Optional |
| category | String | Kategorie der Nachrichten | Optional |
| interval | String | Zeitintervall (day, week, month) | Optional |
GET /v1/weather
Ruft die Wetterdaten für verschiedene Städte ab, optional gefiltert nach Datum oder Stadt.
Parameter:
| Name | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| date | String | Datum im Format YYYY-MM-DD | Optional |
| city | String | Name der Stadt | Optional |
POST /v1/custom-report
Premium Generiert einen personalisierten Bericht basierend auf individuellen Präferenzen und Filtern.
Request Body:
{
"categories": ["Politik", "Wirtschaft"], // Gewünschte Kategorien
"keywords": ["Klimawandel", "Energiewende"], // Relevante Schlüsselwörter
"exclude_keywords": ["Sport"], // Auszuschließende Themen
"start_date": "2023-04-01", // Startdatum
"end_date": "2023-04-30", // Enddatum
"format": "html", // Ausgabeformat
"max_length": 2000 // Maximale Zeichenanzahl
}
Nutzungsrichtlinien
Rate-Limits
Je nach Abonnementtyp gelten unterschiedliche Rate-Limits:
- Standard: 1.000 Anfragen pro Tag, max. 10 Anfragen pro Sekunde
- Business: 10.000 Anfragen pro Tag, max. 50 Anfragen pro Sekunde
- Enterprise: Individuell anpassbar
Caching
Alle Antworten enthalten entsprechende Cache-Header. Bitte respektieren Sie diese, um die API effizient zu nutzen und unnötige Anfragen zu vermeiden.
Fehlerbehandlung
Die API verwendet standardmäßige HTTP-Statuscodes und gibt im Fehlerfall detaillierte Informationen zurück:
{
"status": "error",
"code": 400,
"message": "Ungültiger Parameter: 'date' muss im Format YYYY-MM-DD sein."
}
API-Preismodelle
Wählen Sie aus flexiblen Preismodellen, die auf Ihre Anforderungen zugeschnitten sind.
Standard
- 1.000 Anfragen pro Tag
- Zugriff auf Headlines API
- Zugriff auf Weather API
- Grundlegende Analysen
- Keine personalisierten Berichte
- Kein Support
Enterprise
- Unbegrenzte Anfragen
- Zugriff auf alle API-Endpunkte
- Maßgeschneiderte Analysen
- Branchenspezifische Berichte
- Dedizierter Account Manager
- 24/7 Premium-Support
- Individuelle API-Anpassungen
Bereit für die Integration?
Kontaktieren Sie unser Team für eine kostenlose Beratung und erfahren Sie, wie die Timelapse News API Ihre Anwendung aufwerten kann.