Spyse : Python API Wrapper & Command-Line Client For The Tools Hosted On Spyse.com

Spyse is a developer of complete DAAS (Data-As-A-Service) solutions for Internet security professionals, corporate and remote system administrators, SSL / TLS encryption certificate providers, data centers and business analysts. All Spyse online solutions are represented by thematic services that have a single platform for collecting, processing and aggregating information.

Supports the following APIs:

Python API wrapper and command-line client for the tools hosted on spyse.com.

Also Read – PivotSuite : Network Pivoting Toolkit To Hack The Hidden Network

Installation

pip3 install spyse.py

Using the client

Required Arguments

  • -target
  • -param

Optional Arguments

  • -page
  • -apikey
  • --raw

What is the param argument?

It allows you to search their database for IPs, IP ranges, domain names, URLs, etc. The parameter argument is meant to specify the type of your input.

List of parameters

  • cidr
  • domain
  • ip
  • page
  • url
  • hash
  • q

Using search queries

Much like Shodan, it allows you to use search queries. To do this, you must supply the “q” parameter. From there, it’s as simple as supplying “org: Microsoft” as the target.

spyse -target “org: Microsoft” -param q –ssl-certificates

Searching for subdomains

spyse -target xbox.com -param domain –subdomains

Reverse IP Lookup

spyse -target 52.14.144.171 -param ip –domains-on-ip

Searching for SSL certificates

spyse -target hotmail.com -param domain –ssl-certificates

spyse -target “org: Microsoft” -param q –ssl-certificates

Getting all DNS records

spyse -target xbox.com -param domain –dns-all

Navigating multiple pages using your API key

export SPYSEKEY=”yourkeyhere”
spyse -target xbox.com -param domain -apikey $SPYSEKEY -page 2 —ssl-certificates

Piping to jq and aquatone

Initially when I decided to write this client I really wanted it to focus on flexibility within the command-line, which is why there is the --raw option. From there you can work with the raw JSON returned by the API.

spyse -target hackerone.com -param domain –dns-soa –raw | jq

spyse -target hackerone.com -param domain –subdomains –raw | aquatone

Using the library

Without API Key

from spyse import spyse

s = spyse()
subdomains = s.subdomains(“xbox.com”, param=”domain”)

With API Key

from spyse import spyse

#Using the API key allows us to go through multiple pages of results
s = spyse(‘API_TOKEN_GOES_HERE’)
subdomains = s.subdomains_aggregate(“xbox.com”, param=”domain”, page=2)

Search using CIDR

from spyse import spyse

s = spyse()
results = s.domains_on_ip(“172.217.1.0/24″, param=”cidr”)

Work with an existing file

from spyse import spyse

s = spyse()
results = []

with open(“domains.txt”) as d:
for line in d:
# default value for param=”domain”, so we don’t
# need to specify here
r = s.subdomains_aggregate(line)
results.append(r)
print(results)

R K

Recent Posts

Burrow – Breaking Through Firewalls With Open Source Ingenuity

Burrow is an open source tool for burrowing through firewalls, built by teenagers at Hack Club.…

14 hours ago

Its-A-Trap : Building Secure Web Applications With A Golang Web Server For Authentication

Simple golang webserver that listens for basic auth or post requests and sends a notification…

14 hours ago

Nutek-Apple : Unleashing Power On macOS And Linux

Nutek Security Platform for macOS and Linux operating systems. Tools for hackers, bug hunters and…

14 hours ago

SecureSphere Labs – A Haven For Cybersecurity Innovators And Ethical Hackers

Welcome to SecureSphere Labs, your go-to destination for a curated collection of powerful hacking tools…

15 hours ago

Vulpes/VulpOS : The Docker-Powered All-in-One Workstation For Penetration Testing And Offsec Labs

All in one Docker-based workstation with hacking tools for Pentesting and offsec Labs by maintained…

15 hours ago

LiCo-Extrator : Revolutionizing Icon Extraction Across Platforms

Got it! Below is the updated README.md file with instructions for downloading the project on…

1 day ago