pysecuritytrails

Python3 wrapper for the Security Trails API https://securitytrails.com/

Installation

You can install it directly from the pypi package : pip install pysecuritytrails

You can also install the last version of the source code:

git clone https://github.com/Te-k/pysecuritytrails.git
cd pysecuritytrails
pip install .

Usage

from pysecuritytrails import SecurityTrails, SecurityTrailsError
st = SecurityTrails('APIKEYHERE')

# Check that it is working
try:
    st.ping()
except SecurityTrailsError:
    print('Ping failed')
    sys.exit(1)

infos = st.domain_info('securitytrails.com')
subdomains = st.domain_subdomains('securitytrails.com')
tags = st.domain_tags('securitytrails.com')
whois = st.domain_whois('securitytrails.com')
history_dns = st.domain_history_dns('securitytrails.com')
history_whois = st.domain_history_whois('securitytrails.com')

For more information on the API, check https://docs.securitytrails.com/reference

List of Functions Implemented

• ping(): You can use this simple endpoint to test your authentication and access to the SecurityTrails API.
• scroll(scroll_id): A fast and easy way to fetch many results
• domain_info(HOSTNAME): Returns the current data about the given domain.
• domain_subdomains(HOSTNAME): Returns subdomains for a given hostname
• domain_tags(HOSTNAME): Returns tags for a given hostname
• domain_associated(HOSTNAME, PAGE): Find all domains that are related to a domain you input
• domain_whois(HOSTNAME): Returns the current WHOIS data about a given domain with the stats merged together
• domain_search(FILTER, INCLUDE_IPS, PAGE) : Filter and search specific records using this endpoint.
• domain_search_sql(QUERY, INCLUDE_IPS, PAGE, SCROLL): Filter and search specific records using our DSL with this endpoint
• domain_search_stats(FILTER) : Show statistics of a research
• domain_history_dns(HOSTNAME, TYPE, PAGE): Lists out specific historical information about the given hostname parameter
• ips_nearby(IP): Returns the neighbors in any given IP level range and essentially allows you to explore closeby IP addresses.
• ips_search_dsl(IP, PAGE): Search for an IP address using DSL
• ips_search_stats(QUERY): Stats on a DSL query
• feeds_domains(TYPE, FILTER, TLD, NS): Fetch zone files including authoritative nameservers with ease

License

This code is licensed under GPLv3