Python wrapper for the Backscatter API
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
backscatter Added a header option and removed debug Feb 8, 2019
docs Forgot to build the docs Feb 4, 2019
source See readme Feb 4, 2019
.gitignore Initial commit Jan 12, 2019
LICENSE Initial commit Jan 12, 2019
Makefile Added readme details Jan 13, 2019
README.rst See readme Feb 4, 2019
requirements.txt Fully working version ready for real testing. Jan 22, 2019 Added a header option and removed debug Feb 8, 2019


Python Backscatter

This is an abstract python library built on top of the Backscatter service. It is preferred that users use this library when implementing integrations or plan to use Backscatter within their code. The library includes a small client to interact with the API.

Quick Start

Install the library:

pip install backscatter or python install

Save your configuration:

backscatter setup --api-key <your-API-key>

Search observations:

backscatter observations --query

Get Trends:

backscatter trends --type port

Enrich values:

backscatter enrich --query


  • Run observation searches for ip, network, asn, country and ports
  • Get trend data for all data types



  • Feature: Support for port enrichment call


  • Feature: Support proxies within the core library
  • Change: Adjust timeout to something more favorable to long queries


  • Bugfix: Avoid errors on free account without observations


  • Feature: Added enrichment support
  • Feature: Added JSON and table output formats
  • Change: Adjusted query type to be optional if value is mapped to a type


  • Bugfix: Resolved undeclared var in client observations call


  • Initial launch of the library