Feeds API
The Feeds API provides access to ThreatWinds threat intelligence feeds. These feeds contain comprehensive information on cybersecurity threats that can be used to enhance your security posture.
Overview
ThreatWinds Feeds API allows you to:
| Feature | Description |
|---|---|
| List Feeds | Get a list of all available feeds |
| Download Feeds | Download feed files based on accuracy level, type, and name |
| Checksums | Access feed checksums for verification |
The feeds are categorized by:
| Category | Values |
|---|---|
| Accuracy Level | level1, level2, level3 |
| Type | accumulative, daily |
| Name | various indicators like ip, md5, etc. |
Authentication
Like all ThreatWinds APIs, the Feeds API requires authentication. You can authenticate using either:
| Authentication Method | Description |
|---|---|
| Authorization Header | Include a bearer token in the Authorization header |
| API Key and Secret | Include your API key and secret in the request headers |
For more details on authentication, see the Authentication section.
API Endpoints
The base URL for the Feeds API is:
https://apis.threatwinds.com/api/feeds/v1
For detailed information about each endpoint, please refer to the specific documentation pages.
Error Response Headers
All error responses include the following custom headers:
| Header | Description |
|---|---|
| x-error | Human-readable error message describing what went wrong |
| x-error-id | Unique MD5 hash identifier for error tracking and support |
Error Codes
| Status Code | Description | Possible Cause |
|---|---|---|
| 200 | OK | Feed list retrieved or feed downloaded successfully |
| 400 | Bad Request | Invalid parameters or validation error |
| 401 | Unauthorized | Missing or invalid authentication credentials |
| 404 | Not Found | Feed not found or route not found |
| 500 | Internal Server Error | Server-side error accessing feed storage |