What is Readability?

Does Readability have an API?

Yes, all of the functionality of Readability is available through the Readability API. If you're interested in using the Readability API, the documentation begins with instructions for getting keys.

How can I get a Readability API key?

All registered users can get API keys in account settings.

Are there limits or restrictions on using the Readability API?

There are no limits to the use of the Readability API. Note however, there are restrictions that are outlined in the API Terms of Service.

Can I charge money for tools or applications built on Readability?

Yes, you can charge money for tools or applications built on the Readability API, so long as it complies with our API Terms of Service.

How do I install the embedded Read Now and Read Later buttons on my site?

We provide a simple script for installing the embeddable Read Now and Read Later links on your articles. You can find the script and installation instructions on the Publisher Tools page.

I'm a publisher or writer and I would like to prohibit my content from being processed and stored by Readability. How can I do that?

You can exclude your content from being processed by Readability by contacting us.

My pages don't display correctly in Readability. Is there anything I can do to improve the Readability view?

Yes, we provide Article Publishing Guidelines on how best to mark up your pages for the Readability view.

How do I include author attribution, copyright information, and other article metadata in the Readability view?

We encourage publishers and writers to enrich their web content with additional information about their pages. You can find detailed instructions on how to do so by visiting our Article Publishing Guidelines page.

How do I make certain an image is displayed in the Readability reading view?

There are two ways to ensure that your images or figures make it to the reading view in Readability:

1. Add the following CSS class to any element (e.g. <img> or container <div>):
   • entry-content-asset
2. Wrap your image captions in a <figure> tag. You can see a specific example of this in the hNews guidelines for Readability.