The official Python library for the Yuleak API.
- Convenient methods for making calls to the API.
- Automatic parsing of API responses into Python objects.
yuleak-api is available on PYPI
pip install yuleak-apiYou can use the API with default demo key for development purpose but to use it you'll need to register to Yuleak.
from yuleak_api.client import YuleakClient
YuleakClient.set_apikey('my_secret_api_key')In case of error, GET methods will return an empty list and POST/DELETE will return False.
The error will be displayed in yuleak-api logger.
Warnings will (such as a deprecated endpoint) will also be displayed in yuleak-api logger.
Pagination will be handle by the YuleakClient, you do not have to care about.
This is not intended to provide complete documentation of the API.
For more details, please refer to the official documentation.
For more information on the included models and abstractions, please read the code.
Please check your credits amount before making any search or renew action to avoid errors.
print(YuleakClient.credits())dashboards = YuleakClient.dashboards()
for dashboard in dashboards:
# Display stats (similar to dashboard view in WebUI)
print(dashboard.stats())
# Display map (similar to map widget in WebUI)
print(dashboard.map())
# Display graph (similar to graph view in WebUI)
for node in dashboard.graph():
if node.type == 'asn':
print('AS: {0}'.format(node.label))
for child in node.neighbors:
if child.type == 'server':
print(child)
# Display timeline (similar to timeline widget in WebUI)
print(dashboard.timeline())
# Display details (similar to details view in WebUI)
for server in dashboard.details():
print(server.geo.country_name)
# Download screenshots
for domain in server.domains:
if domain.screenshot is not None:
domain.screenshot.download('/tmp/{0}.png'.format(domain.value))
dashboard.delete()resources = dashboard.resources()
for resource in resources:
print('{0} :: {1}'.format(resource.value, resource.status))
if resource.type == 'server':
resource.renew()
else:
resource.delete()server = dashboard.details()[0]
assert not server.bookmark
server.add_bookmark()
assert server.bookmark
server.del_bookmark()
assert not server.bookmarkdashboard.add_filter('domain', 'all')
for f in dashboard.filters():
print(f)
f.delete()YuleakClient.search('yuleak.com')
dashboard = YuleakClient.dashboards()[-1]
dashboard.search('yuleak.io')
# Mass search
new_servers = dashboard.list_new_servers()
if YuleakClient.credits() >= new_servers > 0:
dashboard.searchall()- GET dashboard/{id}/statsdns added
- GET dashboard/{id}/dns added
- you can now add custom headers in YuleakClient requests
- preview screenshot can now be recovered using server.domain.screenshot.download()
- requests timeout can now be set with YuleakClient.REQUESTS_TIMEOUT
- requests retry on error can now be set with YuleakClient.REQUESTS_RETRY
- correct error on 'DELETE dashboard/{id}' endpoint
- correct error on 'searchall' endpoint
- correct error on pip install
- GET dashboard/{id}/renewall added
- POST dashboard/{id}/renewall added
- GET dashboard/{id}/searchall added
- POST dashboard/{id}/searchall added
- Change to match the Yuleak API path modifications