Awesome Open Source
Awesome Open Source logo

Hoppscotch - A free, fast and beautiful API request builder

Helps you create requests faster, saving precious time on development - Subscribe

Website Travis Build Status GitHub release Tweet

Built with โค๏ธŽ by liyasthomas and contributors



Chat on Telegram Chat on Discord


Sponsor on GitHub Contribute on Open Collective Join on Patreon Donate on PayPal

Table of contents


โค๏ธ Lightweight: Crafted with minimalistic UI design.

โšก๏ธ Fast: Send requests and get/copy responses in real-time.

HTTP Methods
  • GET - Requests retrieve resource information
  • HEAD - Retrieve response headers identical to those of a GET request, but without the response body.
  • POST - The server creates a new entry in a database
  • PUT - Updates an existing resource
  • DELETE - Deletes resource or related component
  • CONNECT - Establishes a tunnel to the server identified by the target resource
  • OPTIONS - Describe the communication options for the target resource
  • TRACE - Performs a message loop-back test along the path to the target resource
  • PATCH - Very similar to PUT but makes a partial update on a resource
  • <custom> - Some APIs use custom request methods such as LIST. Type in your custom methods.

๐ŸŒˆ Make it yours: Customizable combinations for background, foreground and accent colors. Customize now โœจ

  • Choose theme: System, Light, Dark (default) and Black
  • Choose accent color: Blue, Green (default), Teal, Purple, Orange, Pink, Red, and Yellow
  • Toggle multi-colored headings
  • Toggle auto-scroll to response

Customized themes are synced with local session storage

๐Ÿ”ฅ PWA: Install as a PWA on your device.

  • Instant loading with Service Workers
  • Offline support
  • Low RAM/memory and CPU usage
  • Add to Home Screen
  • Desktop PWA

๐Ÿš€ Request: Retrieve response from endpoint instantly.

  • Choose method
  • Enter URL
  • Send
  • Copy/share public "Share URL"
  • Generate/copy request code snippets for 10+ languages and frameworks
  • Import cURL
  • Label requests

๐Ÿ”Œ WebSocket: Establish full-duplex communication channels over a single TCP connection.

๐Ÿ“ก Server Sent Events: Receive a stream of updates from a server over a HTTP connection without resorting to polling.

๐ŸŒฉ Socket.IO: Send and Receive data with SocketIO server.

๐ŸฆŸ MQTT: Subscribe and Publish to topics of a MQTT Broker.

๐Ÿ”ฎ GraphQL: GraphQL is a query language for APIs and a runtime for fulfilling those queries with your existing data.

  • Set endpoint and get schemas
  • Multi-column docs
  • Set custom request headers
  • Query schema
  • Get query response

๐Ÿ” Authentication: Allows to identify the end user.

  • None
  • Basic
  • Bearer Token
  • OAuth 2.0
  • OIDC Access Token/PKCE

๐Ÿ“ข Headers: Describes the format the body of your request is being sent as.

๐Ÿ“ซ Parameters: Use request parameters to set varying parts in simulated requests.

๐Ÿ“ƒ Request Body: Used to send and receive data via the REST API.

  • Set Content Type
  • Add or remove Parameter list
  • Toggle between key-value and RAW input parameter list

๐Ÿ‘‹ Response: Contains the status line, headers and the message/response body.

  • Copy response to clipboard
  • Download response as a file
  • View response headers
  • View raw and preview of HTML, image, JSON, XML responses

โฐ History: Request entries are synced with cloud / local session storage to restore with a single click.

๐Ÿ“ Collections: Keep your API requests organized with collections and folders. Reuse them with a single click.

  • Unlimited collections, folders and requests
  • Nested folders
  • Export as / import from GitHub gist

Collections are synced with cloud / local session storage

๐ŸŒ Proxy: Enable Proxy Mode from Settings to access blocked APIs.

  • Hide your IP address
  • Fixes CORS (Cross Origin Resource Sharing) issues
  • Access APIs served in non-HTTPS (http://)
  • Use custom Proxy URL

Official Hoppscotch Proxy is hosted by Apollo Software - Privacy Policy

๐Ÿ“œ Pre-Request Scripts ฮฒ: Snippets of code associated with a request that are executed before the request is sent.

  • Initialize environment variables
  • Include timestamp in the request headers
  • Send a random alphanumeric string in the URL parameters

๐Ÿ“„ API Documentation: Create and share dynamic API documentation easily, quickly.

  1. Add your requests to Collections and Folders
  2. Export Collections and easily share your APIs with the rest of your team
  3. Import Collections and Generate Documentation on-the-go

โŒจ๏ธ Keyboard Shortcuts: Optimized for efficiency.

Shortcuts WIki

๐ŸŒŽ i18n ฮฒ: Experience the app in your own language.

  1. Scroll down to the footer
  2. Click "Choose Language" icon button
  3. Select your language from the menu

Keep in mind: Translations aren't available for all source and target language combinations

To provide a localized experience for users around the world, you can add you own translations.

All i18n contributions are welcome to i18n branch only!

๐Ÿ“ฆ Add-ons: Official add-ons for hoppscotch.

Add-ons are developed and maintained under Official Hoppscotch Organization.

โ˜๏ธ Auth + Sync: Sign in and sync in real-time.

Sign in with

  • Google
  • GitHub


  • History
  • Collections
  • Environments
  • Notes

โœ… Post-Request Tests ฮฒ: Write tests associated with a request that are executed after the request response.

  • Check the status code as an integer
  • Filter response headers
  • Parse the response data

๐Ÿ“ Notes : Instantly jot down notes, tasks or whatever you feel like as they come to your mind.

Notes are only available for signed-in users

๐ŸŒฑ Environments : Environment variables allow you to store and reuse values in your requests and scripts.

  • Unlimited environments and variables
  • Initialize through pre-request script
  • Export as / import from GitHub gist

  • By storing a value in a variable, you can reference it throughout your request section
  • If you need to update the value, you only have to change it in one place
  • Using variables increases your ability to work efficiently and minimizes the likelihood of error

To find out more, please check out Hoppscotch Wiki.



  1. Choose method
  2. Enter URL
  3. Send request
  4. Get response

Built with


  1. Update .env.example file found in repository's root directory with your own keys and rename it to .env.

Sample keys only works with the production build.

Browser based development environment

Open in Gitpod

Local development environment

  1. Clone this repo with git.
  2. Install dependencies by running npm install within the directory that you cloned (probably hoppscotch).
  3. Start the development server with npm run dev.
  4. Open development site by going to http://localhost:3000 in your browser.

Docker compose

  1. Clone this repo with git.
  2. Run docker-compose up
  3. Open development site by going to http://localhost:3000 in your browser.


docker pull hoppscotch/hoppscotch

docker build -t hoppscotch/hoppscotch:latest .

docker run -p 3000:3000 hoppscotch/hoppscotch:latest
Legacy container
docker pull liyasthomas/postwoman

docker build -t liyasthomas/postwoman:latest .

docker run -p 3000:3000 liyasthomas/postwoman:latest


  1. Clone this repo with git.
  2. Install dependencies by running npm install within the directory that you cloned (probably hoppscotch).
  3. Build the release files with npm run generate.
  4. Find the built project in ./dist.


Please contribute using GitHub Flow. Create a branch, add commits, and open a pull request.

Please read CONTRIBUTING for details on our CODE OF CONDUCT, and the process for submitting pull requests to us.

Continuous Integration

We use Travis CI for continuous integration. Check out our Travis CI Status.


This project is developed by Liyas Thomas using the Semantic Versioning specification. For the versions available, see the releases on this repository.


See the CHANGELOG file for details.


Lead Developers

Testing and Debugging


Liyas Thomas

๐Ÿ’ป ๐ŸŽจ

Andrew Bastin


See the list of contributors who participated in this project.


Financial Contributors

Become a financial contributor and help us sustain our community [Support].

GitHub Sponsors


DiningCity Rithish Kenny Cheung Shivam Mishra Zach Silveira Harshit Pant Anil Kumar Gabriel Peal Kristjรกn Oddsson Don Okuda Erica Brescia Tom Preston-Werner Max Lynch Brian Shaler Max Stoiber John Caine

Open Collective


Code Contributors

This project exists thanks to all the people who contribute [Contribute].


This project is licensed under the MIT License - see the LICENSE file for details.


  • Hat tip to anyone whose code was used
  • Inspirations:


Preview Markdown code






Happy Coding โค๏ธŽ

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
vue (3,931)ย 
api (1,586)ย 
vuejs (1,050)ย 
graphql (993)ย 
testing (911)ย 
rest-api (519)ย 
websocket (422)ย 
developer-tools (324)ย 
tools (320)ย 
pwa (310)ย 
nuxt (212)ย 
testing-tools (194)ย 
api-client (186)ย 
http-client (177)ย 
spa (177)ย 
nuxtjs (116)ย 
api-rest (45)ย 
api-testing (22)ย 

Find Open Source By Browsing 7,000 Topics Across 59 Categories

Advertising ๐Ÿ“ฆย 10
All Projects
Application Programming Interfaces ๐Ÿ“ฆย 124
Applications ๐Ÿ“ฆย 192
Artificial Intelligence ๐Ÿ“ฆย 78
Blockchain ๐Ÿ“ฆย 73
Build Tools ๐Ÿ“ฆย 113
Cloud Computing ๐Ÿ“ฆย 80
Code Quality ๐Ÿ“ฆย 28
Collaboration ๐Ÿ“ฆย 32
Command Line Interface ๐Ÿ“ฆย 49
Community ๐Ÿ“ฆย 83
Companies ๐Ÿ“ฆย 60
Compilers ๐Ÿ“ฆย 63
Computer Science ๐Ÿ“ฆย 80
Configuration Management ๐Ÿ“ฆย 42
Content Management ๐Ÿ“ฆย 175
Control Flow ๐Ÿ“ฆย 213
Data Formats ๐Ÿ“ฆย 78
Data Processing ๐Ÿ“ฆย 276
Data Storage ๐Ÿ“ฆย 135
Economics ๐Ÿ“ฆย 64
Frameworks ๐Ÿ“ฆย 215
Games ๐Ÿ“ฆย 129
Graphics ๐Ÿ“ฆย 110
Hardware ๐Ÿ“ฆย 152
Integrated Development Environments ๐Ÿ“ฆย 49
Learning Resources ๐Ÿ“ฆย 166
Legal ๐Ÿ“ฆย 29
Libraries ๐Ÿ“ฆย 129
Lists Of Projects ๐Ÿ“ฆย 22
Machine Learning ๐Ÿ“ฆย 347
Mapping ๐Ÿ“ฆย 64
Marketing ๐Ÿ“ฆย 15
Mathematics ๐Ÿ“ฆย 55
Media ๐Ÿ“ฆย 239
Messaging ๐Ÿ“ฆย 98
Networking ๐Ÿ“ฆย 315
Operating Systems ๐Ÿ“ฆย 89
Operations ๐Ÿ“ฆย 121
Package Managers ๐Ÿ“ฆย 55
Programming Languages ๐Ÿ“ฆย 245
Runtime Environments ๐Ÿ“ฆย 100
Science ๐Ÿ“ฆย 42
Security ๐Ÿ“ฆย 396
Social Media ๐Ÿ“ฆย 27
Software Architecture ๐Ÿ“ฆย 72
Software Development ๐Ÿ“ฆย 72
Software Performance ๐Ÿ“ฆย 58
Software Quality ๐Ÿ“ฆย 133
Text Editors ๐Ÿ“ฆย 49
Text Processing ๐Ÿ“ฆย 136
User Interface ๐Ÿ“ฆย 330
User Interface Components ๐Ÿ“ฆย 514
Version Control ๐Ÿ“ฆย 30
Virtualization ๐Ÿ“ฆย 71
Web Browsers ๐Ÿ“ฆย 42
Web Servers ๐Ÿ“ฆย 26
Web User Interface ๐Ÿ“ฆย 210