Skip to main content

Pentesting tool for GraphQL triage

Project description

InQL Scanner

A Burp Extension/stand-alone tool to facilitate GraphQL technology security testing efforts.

GraphQL Official Logo

InQL Introspection (stand-alone script)

Running inql from python will issue an Introspection query to a GraphQL endpoint to fetch the metadata of all the:

  • Queries, Mutations, Subscriptions
  • their fields and arguments
  • objects and custom objects types

InQL can inspect the introspection query result and generate clean documentation in different formats such as HTML and JSON Schema.

InQL is also able to generate templates (with optional placeholders' values) for all the known types.

The resulting HTML documentation page will contain details for all available Queries, Mutations, and Subscriptions as shown here:


Templates Generation:



usage: inql [-h] [-t TARGET] [-f SCHEMA_JSON_FILE] [-k KEY] [-p PROXY]
            [--header HEADERS HEADERS] [-d] [--generate-html]
            [--generate-schema] [--generate-queries] [--insecure]
            [-o OUTPUT_DIRECTORY]

InQL Scanner

optional arguments:
  -h, --help            show this help message and exit
  -t TARGET             Remote GraphQL Endpoint (https://<Target_IP>/graphql)
  -f SCHEMA_JSON_FILE   Schema file in JSON format
  -k KEY                API Authentication Key
  -p PROXY              IP of web proxy to go through (
  -d                    Replace known GraphQL arguments types with placeholder
                        values (useful for Burp Suite)
  --generate-html       Generate HTML Documentation
  --generate-schema     Generate JSON Schema Documentation
  --generate-queries    Generate Queries
  --insecure            Accept any SSL/TLS certificate
  -o OUTPUT_DIRECTORY   Output Directory

Terminal Output:


Burp Suite Extension

Since v1.0 InQL was extended to also support BURP as a plugin. In that mode it will retain all the capabilities of the inql tool; including a handy user interface to manipulate the queries and the documentation. Following the most important capabilities of the UI tool:

  • search for known GraphQL paths; it will grep and match known values to detect GraphQL Technology usage in the website
  • search for exposed GraphQL development consoles; reports GraphiQL, GraphQL Playground, and common consoles
  • add a GraphQL Tab for every request/response using GraphQL Technology
  • add a GraphQL Scanner Tab inside Burp Suite; GUI for the Introspection Tool

Import the Extension in Burp:

  • Download Jython Jar
  • Start Burp Suite
  • Extender Tab > Options > Python Enviroment > Set the location of Jython standalone JAR
  • Extender Tab > Exrtension > Add > Extension Type > Select python
  • Extension File > Set the location of > Next
  • The output should now show the following message: InQL Scanner Started!

Now you should be able to find a GraphQL Scanner Tab:



  • Load a GraphQL endpoint or a JSON schema file location inside the input box
  • (Optional) Check the 'load template placeholders' checkbox; It will replace known GraphQL arguments types with placeholder values (useful to use in conjunction with the Repeater Tab)
  • Press the corresponding Button (Load URL/Load JSON)
  • After some seconds the left panel will refresh loading the directory structure for the selected endpoint
  • Selecting any query/mutation/subscription will load its template in the main text area on the right

Directory Structure will be the following:

  • url
    • query
      • timestamp 1
        • query1.query
        • query2.query
      • timestamp 2
        • query1.query
        • query2.query
    • mutation
    • subscription


Author and Maintainer: Andrea Brancaleoni (@nJoyneer - thypon)

Original Author: Paolo Stagno (@Void_Sec -

This project was made with love in Doyensec Research island.

Project details

Release history Release notifications

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for inql, version 0.0.4
Filename, size File type Python version Upload date Hashes
Filename, size inql-0.0.4-py2-none-any.whl (26.5 kB) File type Wheel Python version py2 Upload date Hashes View hashes
Filename, size inql-0.0.4-py3-none-any.whl (26.5 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size inql-0.0.4.tar.gz (15.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page