WhoisFreaks · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for WhoisFreaks Databases - Threat Feed API

7 actions 7 updates phrasing extends openapi/whoisfreaks-databases-threat-feed-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for WhoisFreaks's API. It is a proposal applied on top of the contract, not a document WhoisFreaks publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 7

$.info
$.paths['/v3.4/download/threat-feed/phishing'].get
$.paths['/v3.4/download/threat-feed/phishing/sample'].get
$.paths['/v3.4/download/threat-feed/malware'].get
$.paths['/v3.4/download/threat-feed/malware/sample'].get
$.paths['/v3.4/download/threat-feed/spam'].get
$.paths['/v3.4/download/threat-feed/spam/sample'].get

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for WhoisFreaks Databases - Threat Feed API
  version: 1.0.0
extends: openapi/whoisfreaks-databases-threat-feed-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 6
- target: $.paths['/v3.4/download/threat-feed/phishing'].get
  update:
    x-apievangelist-phrasing:
      intent: Download the daily phishing threat feed
      effect: read
      questions:
      - Where can I download a daily list of phishing domains?
      - Can I get the phishing feed from a specific past date?
      instructions:
      - text: Download today's phishing threat feed CSV.
      - text: Fetch the phishing domain feed for {date}.
        slots:
          date: query.date
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3.4/download/threat-feed/phishing/sample'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a sample of the phishing threat feed
      effect: read
      questions:
      - Is there a free phishing feed sample I can evaluate first?
      - What columns does the phishing feed CSV contain?
      instructions:
      - text: Download a sample of the phishing threat feed.
      - text: Grab the phishing feed sample so I can check its format.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3.4/download/threat-feed/malware'].get
  update:
    x-apievangelist-phrasing:
      intent: Download the daily malware threat feed
      effect: read
      questions:
      - Where do I get a daily feed of malware-hosting domains?
      - Can I pull the malware feed for an earlier day?
      instructions:
      - text: Download today's malware threat feed CSV.
      - text: Fetch the malware domain feed for {date}.
        slots:
          date: query.date
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3.4/download/threat-feed/malware/sample'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a sample of the malware threat feed
      effect: read
      questions:
      - Can I preview the malware feed before subscribing?
      - What does a malware threat feed sample look like?
      instructions:
      - text: Download a sample of the malware threat feed.
      - text: Get the malware feed sample CSV for a quick look.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3.4/download/threat-feed/spam'].get
  update:
    x-apievangelist-phrasing:
      intent: Download the daily spam threat feed
      effect: read
      questions:
      - Where can I download a daily list of spam domains for blocklisting?
      - Can I retrieve the spam feed published on a given date?
      instructions:
      - text: Download today's spam threat feed CSV.
      - text: Fetch the spam domain feed for {date}.
        slots:
          date: query.date
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3.4/download/threat-feed/spam/sample'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a sample of the spam threat feed
      effect: read
      questions:
      - Is a sample of the spam domain feed available to test with?
      - How is the spam feed CSV structured?
      instructions:
      - text: Download a sample of the spam threat feed.
      - text: Pull the spam feed sample file so I can test my importer.
      method: generated
      generated: '2026-10-01'