Skip to main content

Make http requests to json apis

Project description

Version Downloads Black License


Papir is an acronym for “Python API Requests”.

The main purpose is to make custom http requests to json APIs, prettify and colorize the full response (headers + json content).

Json is used to post, put, patch or delete and to customize the http headers.

Basic http authentication and gzip compression are supported.

Simple example:

$ papir


  • Works on Python 3

  • Uses only Python standard library for maximum compatibility

  • Small and simple source code


Install using pip:

pip install papir


Download and set executable permission on the script file:

chmod +x


Download and run using the python interpreter:



Usage: papir url [options] [method]

make http requests to json apis

  --version        show program's version number and exit
  -d DATA_FILE     json file to post, put, patch or delete
  -h HEADERS_FILE  json file containing additional headers
  -j JSON_DATA     json string to post, put, patch or delete
  -e JSON_HEADERS  json string containing additional headers
  -t TIMEOUT       timeout in seconds to wait for response (default: 10)
  -a AUTH          basic http authentication in the format username:password
  -f, --follow     follow redirects (default: disabled)
  -i, --insecure   allow insecure SSL connections (default: disabled)
  -v, --verbose    show request headers (default: disabled)


Assuming the file “data.json” exists containing:

    "name": "Bob",
    "age": 30

Make a post request using that data:

$ papir -d data.json

The json data can also be passed directly from cli:

$ papir -j '{"name": "Bob", "age": 30}'

To use a different http method just inform it:

$ papir -d data.json put

To customize the request headers, create a json file like:

    "Auth-User": "user",
    "Auth-Token": "1234",
    "User-Agent": "myagent"

And add it to the request:

$ papir -h headers.json

Headers can also be customized directly from cli:

$ papir -e '{"custom-header": "foobar", "user-agent": "myagent"}'

Obviously, you can mix it with all kinds of http methods:

$ papir -h headers.json -d data.json patch

Simple basic auth:

$ papir -a user:pass

To ignore invalid SSL certificates:

$ papir -i

Project details

Download files

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

Source Distribution

papir-0.3.0.tar.gz (6.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page