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 supports optional authentication. Endpoints accept both authenticated and unauthenticated requests. Unauthenticated requests receive Public tier rate limits. 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 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
429	Too Many Requests	Rate limit exceeded; wait and retry
500	Internal Server Error	Server-side error accessing feed storage

Rate Limiting

All endpoints are rate-limited per tier. Public tier defaults:

Endpoint	Limit
List	10/min
Download	20/hr
Checksum	10/min