APISCAN OWASP 5.5 APIscanner by Perry Mertens
Author: Perry Mertens ([email protected])
Year: 2026 Perry Mertens
Version: 5.5.0 (Release)
License: GNU Affero General Public License v3.0 (AGPL-v3.0)
APISCAN is an API vulnerability scanner that proactively identifies security risks by testing against the OWASP API Security Top 10 (2023). It uses your OpenAPI/Swagger specification to generate realistic attack payloads and detect issues such as Broken Object Level Authorization (BOLA), Broken Authentication, Excessive Data Exposure, and other critical API vulnerabilities. It understands OpenAPI/Swagger, supports multiple authentication flows, provides a plan/verify workflow, includes a generic sanitizer/rewrites, and writes HTML artifacts.
APISCAN: AI-assisted API security for specialists. APISCAN is not a scanner that guesses; it proves. It tests. It observes. Then models explain the risk with evidence attached. That’s how you make AI useful in security.
APISCAN is licensed under the AGPL-v3.0.
If you modify APISCAN and make it available as a hosted service, you must make the complete corresponding source code available under the same license.
APISCAN focuses on API-specific risks instead of generic web scanning.
It is built for testing APIs against the OWASP API Security Top 10 (2023), with one module per risk area and HTML reporting suitable for auditors and developers.
- Auto Form-Login — Automatic login form detection for crAPI, Juice Shop, and custom apps. HTML form parsing, JSON API detection, token auto-extraction. Use
--flow form --login-username ... --login-password ...or the GUI Auto-Detect button. - Crawl Validator — Smart endpoint validation filters fake paths.
--crawl-validate(on),--no-crawl-validate,--crawl-validate-mode balanced|strict,--crawl-validate-workers N. From 71→4 endpoints on Juice Shop. - Deep Scan Mode —
APISCAN_DEEP_SCAN=1auto-switches to full payloads, high intensity, no quick mode. All injection types including SSTI, LDAP, XXE, RCE withinjection_payloads.json. - Expanded Quick Scan — Default scan now covers 9 base tests + 6 injection types (SQL, Path, XSS, NoSQL, LFI, SSTI). Endpoint cap raised from 20→30.
- Business Logic Testing — Detects negative prices, excessive discounts, admin role assignment, and privilege escalation via deep scan mode.
- Production Ready — Tested against Juice Shop and crAPI. Crash-free: dedup fix for dict payloads, session retry fix for 500 responses, HTML response skip in form detection, error spam suppression.
- GUI — Cross-platform Tkinter interface (
python apiscan_gui.py) with Target, Authentication, Form Login (Auto-Detect), and Advanced tabs. Crawl validate controls built in. - Chain Mode — Auto-escalates BOLA findings by extracting leaked data (tokens, user IDs, emails, roles) and re-injecting it into other endpoints.
--chain-modewith optional--chain-depth 1-3for recursive privilege escalation chains. Generatesapi_chain_escalation_report.html. - Real-World Attack Patterns — Detects real-world threat actor TTPs: ShinyHunters unauthenticated data exposure (UNC6040), Salesforce enumeration & Data Loader bulk exfiltration, plus many more attack patterns.
python -m venv .venv
source .venv/bin/activate # Linux/macOS
# .venv\Scripts\activate # Windows
pip install -r requirements.txt
Before running APISCAN, configure your environment and optional AI tooling.
python setup.py
# Validates Python dependencies and environment
# Creates/updates .env.example and requirements.txt
python llmsetup.py
# Configure Ollama / OpenAI / Anthropic / DeepSeek
# Saves settings and writes apiscan_env.sh / apiscan_env.ps1 helper scripts
python apiscan.py --url https://api.example.com --swagger openapi.json --flow token --token "<ACCESS_TOKEN>" --verify-plan
API10 (Unsafe Consumption of APIs) runs in quick mode by default. This keeps normal scans fast by limiting Phase 2 to the most promising endpoints and capping quick SQL testing.
Defaults:
APISCAN_API10_QUICK=1APISCAN_API10_QUICK_MAX_ENDPOINTS=30APISCAN_API10_QUICK_SQL_MAX_TESTS=10APISCAN_API10_QUICK_DIRTRAV_MAX_TESTS=8APISCAN_API10_QUICK_HPP_MAX_PARAMS=3APISCAN_API10_QUICK_REDIRECT_MAX_TESTS=6APISCAN_RATE_LIMIT=0
| Mode | Endpoints | Tests/endpoint | Total | Time |
|---|---|---|---|---|
| Quick (default) | 30 | ~15 | ~450 | ~3-5 min |
| Deep scan | 15 | ~26 | ~390 | ~25-35 min |
Deep scan:
APISCAN_DEEP_SCAN=1+ optioneelAPISCAN_DEEP_MAX_ENDPOINTS=15(default).
PowerShell:
# Default quick mode
$env:APISCAN_API10_QUICK="1"
# Optional quick tuning
$env:APISCAN_API10_QUICK_MAX_ENDPOINTS="30"
$env:APISCAN_API10_QUICK_SQL_MAX_TESTS="10"
# Full API10 scan
$env:APISCAN_API10_QUICK="0"
# Deep scan, slower and more intensive
$env:APISCAN_DEEP_SCAN="1"
Bash/Linux/macOS:
# Default quick mode
export APISCAN_API10_QUICK=1
# Optional quick tuning
export APISCAN_API10_QUICK_MAX_ENDPOINTS=30
export APISCAN_API10_QUICK_SQL_MAX_TESTS=10
# Full API10 scan
export APISCAN_API10_QUICK=0
# Deep scan, slower and more intensive
export APISCAN_DEEP_SCAN=1
python apiscan.py --url https://api.example.com --swagger openapi.json --flow token --token "<ACCESS_TOKEN>"
python apiscan.py --url https://api.example.com --swagger openapi.json --flow none --apikey "<KEY>" --apikey-header "X-API-Key"
python apiscan.py --url https://api.example.com --swagger openapi.json --flow client --client-id "<ID>" --client-secret "<SECRET>" --token-url "https://idp/token"
Client credentials (service to service). Use a dedicated app registration with an app role on the API and admin consent.
python apiscan.py --url https://api.example.com --swagger openapi.json --flow client \
--client-id "<client-id>" --client-secret "$CLIENT_SECRET" \
--token-url "https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token" \
--scope "api://<api-app-id>/.default"
Authorization code (a user signs in through the browser). Register http://localhost:8765/callback as a redirect URI for the platform "Web"; the app needs a client secret.
python apiscan.py --url https://api.example.com --swagger openapi.json --flow auth \
--client-id "<client-id>" --client-secret "$CLIENT_SECRET" \
--auth-url "https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/authorize" \
--token-url "https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token" \
--redirect-uri "http://localhost:8765/callback" \
--scope "api://<api-app-id>/<scope-name>"
Limits: no PKCE (a public client or SPA registration cannot be used), no token refresh (an Entra token lasts about an hour, so split long scans), and no audience or resource parameter. If a flow does not fit, obtain a token elsewhere and use --flow token --token "<ACCESS_TOKEN>". Keep the client secret in an environment variable, not in the command line.
python apiscan.py --url https://api.example.com --swagger openapi.json --flow token --token "<TOKEN>" --proxy 127.0.0.1:8080 --insecure
python apiscan.py --url https://api.example.com --swagger openapi.json --plan-only
--extra-header "x-tenant-id: acc"
--extra-header "x-feature-flag: beta"
--ids-file ids.json
Endpoints with a request body need valid input; without it they stay untested. api10_sql_coverage.json lists them. Put valid bodies in a JSON file and pass it with --request-data-file (all modules) or --api10-data-file (API10 only):
{
"POST /api/users": {
"json": { "email": "audit-{{unique}}@example.com", "password": "TestPassword1!" }
},
"POST /api/basket/items": {
"json": { "basketId": "{{login.basket.id}}", "productId": 1, "quantity": 1 }
},
"PUT /api/products/{id}/reviews": {
"json": { "message": "audit test" }
}
}Keys are METHOD /path; parameter names in braces are interchangeable ({id} also matches a crawled {e}). A key for a route that is not in the specification stops the scan at startup. Allowed fields per entry: json, data, params, headers, files.
Placeholders, expanded for every request:
{{unique}},{{uuid}},{{timestamp}},{{run_id}}{{login.path.to.value}}reads a value from the--flow formlogin response (kept in memory only)
Change the severity of specific findings and record why. Use --severity-file rules.json (GUI: Severity Rules).
[
{
"title_contains": "password hash",
"endpoint": "GET /api/Users",
"severity": "Info",
"reason": "password field is masked, no hash exposed"
}
]Rules are applied after the scan. Fields: title_contains, category_contains, endpoint (METHOD /path, /path or *; parameter names in braces are interchangeable), severity (Critical, High, Medium, Low, Info) and reason (required). All given fields must match; the first matching rule wins. The report shows the new severity with the reason, and all_audit_findings.json keeps the original in reported_severity. An invalid file stops the scan at startup.
APISCAN_JWT_ENDPOINTS(default 5): endpoints outside the deep/quick cap that still get the JWT alg=none check when a Bearer token is configured.
With --crawl, a route such as this.host + '/' + id + '/reviews' is inventoried as /rest/products/{id}/reviews with a path parameter and is never requested with the literal template. Integer IDs use 1, other parameters use the example 1; provide real values with --ids-file. Set APISCAN_CRAWL_DYNAMIC=0 to disable this.
--no-sanitize
--rewrite "/identity/api/v2=>/identity/api/v7/"
--normalize-version
export LLM_PROVIDER=openai_compat
export LLM_MODEL=gpt-4o-mini
export LLM_API_KEY=sk-...
python apiscan.py --url https://api.example.com --swagger openapi.json --api11
- review.html
- combined_report.html
- Per-risk HTML reports
- SQLite database
results.db - Logs
apiscan_*.log
- Only test APIs you are authorized to test.
- Start with
--plan-onlyto avoid accidental traffic. - Use retry options for unstable endpoints.
- Medium article: https://medium.com/@PerryPM/apiscan-a-practical-approach-to-api-security-testing-by-perry-mertens-96b5e676c071
- GitHub: https://github.com/perrym/apiscanner
- Contact: [email protected]
© 2026 Perry Mertens [email protected]. Released under the AGPL-v3.0 License.
