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
Authentication is optional for all Feeds API endpoints. Unauthenticated requests work but receive Public (IP-based) tier rate limits. Providing credentials unlocks your subscription tier’s higher rate limits.
| 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 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 |
| 404 | Not Found | Feed not found or route not found |
| 500 | Internal Server Error | Server-side error accessing feed storage |
Rate Limiting
All endpoints are rate-limited per subscription tier. Unauthenticated requests are limited to the Public tier.
| Endpoint | Public (IP-based) | Authenticated (tier-based) |
|---|---|---|
| List | 10/min | Varies by tier; see Limits API |
| Download | 20/hr | Varies by tier; see Limits API |
| Checksum | 10/min | Varies by tier; see Limits API |
Query your exact limits via GET /api/billing/v1/limits/feeds.