Postman Interceptor is a browser extension that acts as a companion to Postman. Interceptor enables you to capture API traffic, including requests and cookies, from a web browser. After capturing requests or cookies, you can view and work with them in Postman.
To get started, install the Interceptor extension. You can then start an Interceptor session, which is a time-bound period of traffic capture. You can pause, restart, and stop an Interceptor session, then later start another one. Each session is logged in your Postman History and displays the total session time, a traffic overview, and all traffic captured. When you're finished, you can save captured requests and responses in a collection, or save captured cookies in the Postman cookie jar.
You can also use Postman Interceptor to automatically sync cookies from a web browser to the Postman cookie jar. Learn more about syncing cookies.
Use the links below to download and install the latest version of the Interceptor extension for your web browser. Interceptor is available for the following browsers:
To open the Interceptor extension, select the Interceptor icon in your browser's toolbar.
Start an Interceptor session to capture traffic and cookies from your web browser. After you stop the session, captured traffic will open in Postman. All communication between Interceptor and Postman is encrypted.
You can't have more than one proxy or Interceptor session running at the same time.
To start an Interceptor session, do the following:
Open the Interceptor extension by selecting the Interceptor icon in your browser's toolbar.
Make sure the message Ready to capture appears at the bottom of the Interceptor window.
If the message Interceptor disconnected appears, make sure either the Postman desktop app is running or the Postman web app is open in your browser. Also, in Postman, make sure you are in a personal, private, or team workspace where you have edit access.
If you're not running the latest version of the Postman desktop app, or if you're running the desktop app on Linux, you may need to install Interceptor Bridge to use Interceptor.
(Optional) On the Capture Requests tab, use the dropdown menus to limit the requests and responses that are captured while the session is active. Postman will capture requests that match the selected criteria and will ignore requests that don't match. You can change the filters at any time during the session:
On the Capture Requests tab, select Start Capture.
Interceptor starts capturing requests and cookies as you use your web browser. The Interceptor extension shows recent requests and the duration of the session.
When you're done capturing traffic, select Stop Capture to end the session.
You can also use the Interceptor extension to automatically sync cookies from your browser to the Postman cookie jar, without having to start an Interceptor session. For more information, see Sync cookies using Postman Interceptor and the Postman proxy.
When you stop an Interceptor session, Postman automatically opens the results in Postman. You can also select View in Postman to open the session results in Postman.
If the Postman web app is open, session results will open in either the web app or the desktop app, depending on which was last connected to Interceptor. If the web app isn't open, results will open in the Postman desktop app.
To view the Interceptor session again later, select History in the sidebar, then select the Interceptor session. You can also select View Past Sessions on the Interceptor session tab.
The Overview tab shows summary graphs of traffic captured in the Interceptor session. Use the dropdown menu to group requests by method, domain, or content type. The header also displays the session start time, session size, duration, and source.
You can work with the Interceptor session results in the following ways:
You can save requests captured during an Interceptor session to a collection.
Depending on which version of the Postman desktop app you're using, you may need to install Interceptor Bridge before you can use Postman Interceptor:
To check which version of Postman you're using, select the settings icon in the header and select Settings > About.
To install Interceptor Bridge, select Capture requests in the Postman footer. Then select the Via Interceptor tab and select Install Interceptor Bridge.
Last modified: 2024/04/29
Additional resources
Videos
Blog posts