In short, our API allows third party applications to send web pages to their users’ Kindles just like does.

There are only 2 API methods currently available, and both of them are accessible via very simple HTTP or HTTPS calls. 

To test any of those methods simply enter the appropriate URL with necessary parameters in your browser’s address bar, and you’ll get a simple text response. Actually, the HTTP status code will contain all information you need to know, but if your application can’t read the status code from the header, you can read the status code from the response body.

For easy integration into 3rd-party applications, all parameters may be passed via POST or the query string (GET) or any mixed combination.

The API is available via HTTP or HTTPS. I’d suggest to use HTTPS when possible.

User authentication

This method does a very simple job: it checks the given pair of username and password for validity. Use this if you want to only check credentials without sending anything to Sendtoreader, such as when you first prompt the user for Sendtoreader credentials in a settings screen or on the first Sendtoreader request.



  • username
  • password

Sample call:

Resulting status codes:

  • 200: OK
  • 401: Exceeded the rate limit. Please wait 10 seconds and try again.
  • 403: Invalid username or password.
  • 500: The service encountered an error. Please try again later.

Sending web pages to Sendtoreader for processing



username (required)
password (required)
text (either url or text is required)

Sample call:

Please don’t forget to encode the parameters (urlencode). If you are having troubles with user login or sending a web page to his Kindle through Sendtoreader, this is very likely to be the issue. If you are using GET requests or producing POST request-body manually, you need to URL-encode the values.

Resulting status codes:

  • 200: The page has been successfully sent to user’s Kindle or saved on his/her account.
  • 401: Exceeded the rate limit. Please wait 10 seconds and try again.
  • 403: Invalid username or password.
  • 405: Error: Sendtoreader is not able to process this URL.
  • 406: Error: Specified URL is not corrrect.
  • 424: Internal Sendtoreader error. Please contact support for investigation.
  • 427: Sendtoreader can’t send document to the user. Maybe wrong or no kindle email in this user’s settings.
  • 500: The service encountered an error. Please try again later.

Additional information

  • Encoding
    All requests must be UTF-8. 
  • Rate limit
    In order to make the Sendtoreader API work smoothly, rate limiting rules apply. If you make too many requests too fast, you’ll start getting 401 Error responses. When rate limiting has kicked in, you’ll have to wait 10 seconds before making more requests.
  • Support and Feedback
    If you have any question about the API, or have found a bug, or need additional functionality, please email me at I’ll try to help.

Read also:


  1. Rebecca says:

    I can’t get this to work with Facebook. I’ve been ablr to get it to work everywhere else. How do I get it to work with Facebook?

  2. Cyril says:

    It should be great to have access to a method getting multiple url for generating a periodical-like document from custom sources.

    • Sergey says:

      Thank you for the idea Cyril, I like it and will think about its implementation in one of the next updates of the backend.

  3. noname128 says:

    Please, provide an examples of requests.
    For example my credentials is:
    How my GET request to must look like?
    I’ve tried
    But both doesnt work.

  4. Kris says:

    Do you have any plans to publish this add on for IE?

    • Sergey says:

      No, I do not. The fact is, only 4% of Sendtoreader bookmarklet’s users are using IE, while the bookmarklet works just fine in all browsers including IE.

Leave a Reply

You can use these tags: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>