Traffic Import Guide

How to Import Traffic into Vespasian

Vespasian can import existing traffic captures from Burp Suite, browser dev tools (HAR), and mitmproxy. This lets you generate API specifications from traffic you've already captured without re-crawling.

When to Use Import vs. Crawl

• Use crawl when you want Vespasian to drive a headless browser and capture traffic automatically
• Use import when you already have traffic captured from manual testing, mobile app testing, or other tools

Import is especially useful for mobile application testing, where no browser crawl can observe the API calls.

Burp Suite XML Import

How to Export from Burp Suite

1. In Burp Suite, go to the Proxy > HTTP history tab
2. Select the requests you want to export
3. Right-click and choose Save items as XML

How to Import into Vespasian

vespasian import burp traffic.xml -o capture.json

HAR File Import

How to Export from Browser Dev Tools

1. Open browser Developer Tools (F12)
2. Go to the Network tab
3. Perform the actions you want to capture
4. Right-click in the network list and choose Save all as HAR with content

How to Import into Vespasian

vespasian import har recording.har -o capture.json

mitmproxy Dump Import

How to Capture with mitmproxy

mitmproxy -w flows
# or
mitmdump -w flows

How to Import into Vespasian

vespasian import mitmproxy flows -o capture.json

Generate Specifications from Imported Traffic

After importing, use vespasian generate to produce specifications:

vespasian generate rest capture.json -o api.yaml
vespasian generate graphql capture.json -o schema.graphql
vespasian generate wsdl capture.json -o service.wsdl

See Also

• Quick Start Guide
• CLI Reference
• Use Cases