krmaxwell / spyonweb Goto Github PK

Python wrapper for the Spyonweb API. Not affiliated with SpyOnWeb.com or DevHQ.

License: Apache License 2.0

Python 100.00%

spyonweb's Introduction

spyonweb

A Python library for the Spyonweb API. Documentation for the RESTful API is available at https://api.spyonweb.com/v1/docs. NB: This Python library is not affiliated with Spyonweb.com. Be sure to review their Terms of Service.

Available methods

summary: The Request Summary API allows you to input a domain name and get the number of domains with the same Google Adsense, Google Analytics identifiers, IP Address, and Nameserver.
domain: The Domain API allows you to input a domain and get a list of domains that share the same identifiers (Google Adsense, Google Analytics, IP Address, Nameserver).
adsense: The Google Adsense API allows you to input a Google adsense identifier and get a list of domains that share the same identifier.
analytics: The Google Analytics API allows you to input a Google Analytics identifier and get a list of domains that share the same identifier.
ipaddress: The IP Address API allows you to input an IP address and get a list of domains hosted on this IP address.
dns_domain: The Domains on Nameserver API allows you to input a nameserver and get a list of domains handled by this nameserver.
dns_ip: The Nameservers on IP Address API allows you to input an IP address and get a list of nameservers using this IP address.

Usage

import spyonweb


s = spyonweb.spyonweb(token=MY_TOKEN)
test_domain = "fullmooncalendar.net"

s.summary(test_domain)

returns

{
    "status": "found",
    "result": {
        "summary": {
            "fullmooncalendar.net": {
                "items": {
                    "adsense": {
                        // Format: "adsense_code": number_of_domains
                        "pub-5953444431482912": 10,
                        "pub-8423794689684356": 36
                    },
                    "analytics": {
                        // Format: "analytics_code": number_of_domains
                        "UA-15207196": 31,
                        "UA-34505845": 9
                    },
                    "dns_servers": {
                        // Format: "nameserver": number_of_domains
                        "erdomain.earth.orderbox-dns.com": 470,
                        "erdomain.mars.orderbox-dns.com": 470,
                        "erdomain.mercury.orderbox-dns.com": 469,
                        "erdomain.venus.orderbox-dns.com": 469
                    },
                    "ip": {
                        // Format: "ip_address": number_of_domains
                        "209.40.194.244": 9
                    }
                }
            }
        }
    }
}

spyonweb's People

Contributors

Stargazers

Watchers

Forkers

hellopoogle jplenty 5l1v3r1

spyonweb's Issues

Domain lookup in Maltego not returning results

e.g. lookup on github.com returns no results but from the actual API:

{ u'result': { u'dns_domain': { u'ns-1283.awsdns-32.org': { u'fetched': 0,
                                                            u'found': 918,
                                                            u'items': { }},
                                u'ns-1707.awsdns-21.co.uk': { u'fetched': 0,
                                                              u'found': 1134,
                                                              u'items': { }},
                                u'ns-421.awsdns-52.com': { u'fetched': 0,
                                                           u'found': 973,
                                                           u'items': { }},
                                u'ns-520.awsdns-01.net': { u'fetched': 0,
                                                           u'found': 922,
                                                           u'items': { }}},
               u'domain': { u'github.com': { u'items': { u'dns_servers': { u'ns-1283.awsdns-32.org': u'205.251.197.3',
                                                                           u'ns-1707.awsdns-21.co.uk': u'205.251.198.171',
                                                                           u'ns-421.awsdns-52.com': u'205.251.193.165',
                                                                           u'ns-520.awsdns-01.net': u'205.251.194.8'},
                                                         u'ip': { u'192.30.253.112': 7,
                                                                  u'192.30.253.113': 6}}}},
               u'ip': { u'192.30.253.112': { u'fetched': 7,
                                             u'found': 7,
                                             u'items': { u'0-it.com': u'2017-02-22',
                                                         u'annieyu.com': u'2017-01-17',
                                                         u'github.com': u'2017-01-25',
                                                         u'smallstarz.com': u'2017-02-08',
                                                         u'www.github.com': u'2017-02-19',
                                                         u'www.ofertasdehoteis.com.br': u'2017-02-22',
                                                         u'www.yahrly.com': u'2017-02-27'}},
                        u'192.30.253.113': { u'fetched': 6,
                                             u'found': 6,
                                             u'items': { u'github.com': u'2017-01-25',
                                                         u'korealcds.com': u'2017-01-30',
                                                         u'smallstarz.com': u'2017-02-08',
                                                         u'www.github.com': u'2017-02-19',
                                                         u'www.ofertasdehoteis.com.br': u'2017-02-22',
                                                         u'www.yahrly.com': u'2017-02-27'}}},
               u'ip_dns': { u'205.251.193.165': { u'fetched': 0,
                                                  u'found': 2,
                                                  u'items': { }},
                            u'205.251.194.8': { u'fetched': 0,
                                                u'found': 3,
                                                u'items': { }},
                            u'205.251.197.3': { u'fetched': 0,
                                                u'found': 5,
                                                u'items': { }},
                            u'205.251.198.171': { u'fetched': 0,
                                                  u'found': 1,
                                                  u'items': { }}}},
  u'status': u'found'}

Doesn't show correct error when missing API key

If no API key or an incorrect API key is provider, then Maltego should throw an error instead of "no results found".

HTTP 500 on nameserver lookup

HTTP 500 when running "[SW] Nameserver to Domains" on ns2.ropot.net.

CLI output should be nicer

Those OrderedDicts sure do look ugly.

Error with Maltego analytics lookup

Traceback (most recent call last):
  File "/home/maltego/venv/local/lib/python2.7/site-packages/bottle.py", line 862, in _handle
    return route.call(**args)
  File "/home/maltego/venv/local/lib/python2.7/site-packages/bottle.py", line 1732, in wrapper
    rv = callback(*a, **ka)
  File "server.py", line 71, in analytics
    ent.setLinkLabel(data[name])  # date ID was associated with domain
TypeError: string indices must be integers, not str

Write tests

Implement API using Maltego TRX

Support external API key

For use in #4 so not all the requests use my key 👀

Implement paging

Create mock API for testing

Error recognizing IP address

Transform [SW] IP Address to Domain returned with an error: Must submit a valid IPv4 address (from entity "5.189.187.93")

Set up transforms in public TDS

https://cetas.paterva.com/TDS/, needed for #3