Skip to main content
To use this feature, you must have a Pulsedive Feed plan. Your export access and available options are determined by your plan.
Pulsedive’s CSV export delivers a filtered subset of Pulsedive’s indicator dataset as a flat file. Configure your Direct URL with the filters you need, then point your tooling at it to automate recurring ingestion.

The Direct URL

The Direct URL is a GET request to Pulsedive’s CSV export endpoint with your API key and chosen filters as query parameters. A Direct URL looks like this:
https://pulsedive.com/export/csv?key=<YOUR_API_KEY>&header=true&fields=id,type,risk,threats,feeds,usersubmissions,riskfactors,reference&types=domain,ip,ipv6,url&risk=unknown,none,low,medium,high,critical&retired=true&seen=all
Your Direct URL contains your API key. Treat it as a secret. Do not commit it to version control or share it publicly.
To find your API key, visit your Pulsedive account page.

Try It

Fields

Use the fields parameter to control which columns appear in your CSV output. The indicator value is always included as the first column, regardless of which fields you select.
FieldParameter valueDescription
Indicator value(always included)The indicator itself: an IP address, domain, URL, or IPv6 address.
Indicator IDidPulsedive’s unique internal identifier for the indicator.
TypetypeThe indicator type: ip, ipv6, domain, or url.
RiskriskThe indicator’s risk level, and retirement status if applicable. See Reading the Output.
ThreatsthreatsThreat names associated with the indicator, comma-separated.
FeedsfeedsSource feeds that reference the indicator, in Feed Name:Organization format, comma-separated.
User Submission CountusersubmissionsThe number of times Pulsedive users have submitted this indicator.
Risk FactorsriskfactorsThe risk factors contributing to the indicator’s score, comma-separated.
Reference URLreferenceA direct link to the indicator’s page on pulsedive.com.

Filters

Use filters to limit your export to the indicators that matter for your use case. The options available to you depend on your Feed plan.

Indicator Types

Filter by indicator type using the types parameter. Accepts a comma-separated list.
ValueDescription
ipIPv4 addresses
ipv6IPv6 addresses
domainDomain names
urlURLs
All Feed plans include all four indicator types.

Indicator Risk

Filter by risk level using the risk parameter. Accepts a comma-separated list.
ValueDescription
unknownRisk could not be determined.
noneBenign or very low risk.
lowLow risk.
mediumMedium risk.
highHigh risk.
criticalCritical risk.
Risk level availability varies by plan. To view which risk levels are available on your plan, visit pulsedive.com/about/feed.

Timestamp

Use the seen or added parameter to filter by time period. Use seen to filter by when an indicator was last seen. Use added to filter by when it was first added to Pulsedive. Both parameters accept the same values:
ValueDescription
allAll time
yearLast year
monthLast month
weekLast week
dayLast day
The time period available to you depends on your Feed plan. To view plan details, visit pulsedive.com/about/feed.

Retired Indicators

Use the retired parameter to control whether retired indicators appear in your export.
ValueDescription
trueInclude both active and retired indicators.
falseInclude active indicators only.
Access to retired indicators depends on your Feed plan.

Header Row

Use the header parameter to include or exclude a column header row as the first line of the CSV.
ValueDescription
trueInclude a header row with column names.
falseOmit the header row.

Reading the Output

A few fields in the CSV output have formatting behaviors worth knowing before you build a parser.

Risk and Retirement Status

The risk field combines an indicator’s risk level and its retirement status in a single value. When an indicator is retired, Pulsedive appends :retired to the risk level. For example, an indicator with a high risk score that has since been retired appears as:
high:retired
Check for the :retired suffix if your pipeline needs to handle active and retired indicators differently.

Multiple Values in a Single Field

The threats, feeds, and riskfactors fields may contain multiple values. Pulsedive separates multiple values within a single field with a comma. Single fields that contain multiple values are encapsulated in quotes, which most CSV parsers will handle correctly. When parsing these fields, treat the comma as an inner delimiter within the field value, not as a column separator.

Feeds Format

Each entry in the feeds field follows Feed Name:Organization format. For example:
Zeus Bad Domains:abuse.ch,Tor IPs:dan.me.uk

Empty Fields

Fields with no data output as empty. Your parser should handle empty values for any optional field.
Not sure whether CSV or STIX/TAXII 2.1 is the right format for your use case? Visit Choose an Export Format.