lookyloo/client
Raphaël Vinot 9fb963c21c chg: Bump client version 2020-06-30 16:12:55 +02:00
..
pylookyloo new: Add calls to get screenshot, html, cookies, and complete capture. 2020-06-29 19:02:57 +02:00
README.md Update readme with the API change 2020-06-30 15:46:50 +02:00
poetry.lock
pyproject.toml chg: Bump client version 2020-06-30 16:12:55 +02:00
setup.py

README.md

PyLookyloo

This is the client API for Lookyloo.

Installation

pip install pylookyloo

Usage

  • You can use the lookyloo command to enqueue an URL.
usage: lookyloo [-h] [--url URL] --query QUERY

Enqueue a URL on Lookyloo.

optional arguments:
  -h, --help     show this help message and exit
  --url URL      URL of the instance (defaults to https://lookyloo.circl.lu/,
                 the public instance).
  --query QUERY  URL to enqueue.
  --listing      Should the report be publicly listed.
  --redirects    Get redirects for a given capture.

The response is the permanent URL where you can see the result of the capture.
  • Or as a library

from pylookyloo import Lookyloo

lookyloo = Lookyloo('https://url.of.lookyloo.instance')
if lookyloo.is_up:  # to make sure it is up and reachable
	permaurl = lookyloo.enqueue('http://url.to.lookup')

You can add the following paramaters to the enqueue fuction:

    quiet      Return only the uuid
    listing    Should the report be publicly listed.
    user_agent Set your own user agent
    Depth      Set the analysis depth. Can not be more than in config

To retrieve the redirects (json)

    redirect = lookyloo.get_redirects(uuid)

To retrieve the cookies (json)

    cookies = lookyloo.get_cookies(uuid)

To retrieve the screenshot (raw)

    screen = lookyloo.get_screenshot(uuid)

To retrieve the html (raw)

    html = lookyloo.get_html(uuid)

To retrieve the complete capture(raw)

    capture = lookyloo.get_complete_capture(uuid)