We would like to show you a description here but the site won’t allow us. This is what my Feedly looks like so far. I am happy with the amount of sources that I have found to follow, but I think that as time goes on I will want to follow more and more accounts. Right now, as I am getting the hang of it, this is a good amount of resources to work with. Feedly is a free service (with advanced premium features available) that gives you the power to conveniently organize and streamline information. This information (i.e. Content) is sourced from the rss feeds of blogs or other online resources. While most commonly used as a free, well designed, and easy way. Share your videos with friends, family, and the world.
This describes the resources that make up the official Feedly API v3. Ifyou have any problems or requests please contactsupport.
Schema
All API access is over HTTP, and accessed from the
cloud.feedly.com
domain. All data is sent and received as JSON. HTTPS is required for all OAuthAPIs, and highly recommended for the other APIs.Blank fields are omitted.
All timestamps are returned as long EPOCH values in milliseconds.
Resource Ids
Feedly tries to use readable ids wherever possible. These ids are returned by the various “list” APIs, e.g. categories, tags etc. We do not recommended building these ids using code, as their structure might change.
Here’s a list of the most commonly used resource ids and their format:
feed/:url
- Feed Id (example: “feed/http://feeds.engadget.com/weblogsinc/engadget”)
user/:userId/category/:label
(obsolete) oruser/:userId/category/:uuid
- Category Id, used for collections of feeds; see the categories and collections APIs (example: “user/c805fcbf-3acf-4302-a97e-d82f9d7c897f/category/af190c49-0ac8-4f08-9f83-805f1a3bc142”)
user/:userId/tag/:label
(obsolete) oruser/:userId/tag/:uuid
- Tag Id, used to tag entries; see the tags API (example: “user/c805fcbf-3acf-4302-a97e-d82f9d7c897f/tag/c4b6b721-ee19-4185-b4b2-2ec990f66040”)
user/:userId/priority/:uuid
- Priority Filter Id, used to automatically tag entries; see the priorities API (example: “user/c805fcbf-3acf-4302-a97e-d82f9d7c897f/priority/4929be8a-5b31-411f-9ca3-c176188d7d58”)
topic/:topic/meme/:uuid
- Meme Id (example: “topic/tech_en/meme/4929be8a-5b31-411f-9ca3-c176188d7d58”)
These resources are specific to enterprise customers:
enterprise/:enterpriseName/category/:uuid
- Enterprise Category Id, used for team collections of feeds; see the enterprise collections APIs (example: “enterprise/acmeinc/category/4929be8a-5b31-411f-9ca3-c176188d7d58”)
enterprise/:enterpriseName/tag/:uuid
- Enterprise Tag Id, used for entries tagged in a team; see the enterprise tags APIs (example: “enterprise/acmeinc/tag/4929be8a-5b31-411f-9ca3-c176188d7d58”)
enterprise/:enterpriseName/priority/:uuid
- Enterprise Priority Filter Id, used to automatically tag entries in a team; see the enterprise priorities APIs (example: “enterprise/acmeinc/priority/4929be8a-5b31-411f-9ca3-c176188d7d58”)
Resource ids must be URL-encoded if they are passed as a URL parameter.
Global Resource Ids
Here is a list of built-in categories and tags applications can take advantage of. These idsare not returned by the APIs directly, they must be constructed in code.
user/:userId/category/global.all
- All articles from all the feeds the user subscribes to (example: “user/c805fcbf-3acf-4302-a97e-d82f9d7c897f/category/global.all”)
user/:userId/category/global.uncategorized
- All the articles from all the sources the user subscribes to and are not in a category (example: “user/c805fcbf-3acf-4302-a97e-d82f9d7c897f/category/global.uncategorized”)
user/:userId/category/global.must
- Users can promote sources they really love to read to must have (example: “user/c805fcbf-3acf-4302-a97e-d82f9d7c897f/category/global.must”)
user/:userId/tag/global.read
- List of entries the user has recently read - limited to the feeds the users subscribes to (example: “user/c805fcbf-3acf-4302-a97e-d82f9d7c897f/tag/global.read”)
user/:userId/tag/global.saved
- Users can save articles for later. Equivalent of starring articles in Google Reader (example: “user/c805fcbf-3acf-4302-a97e-d82f9d7c897f/tag/global.saved”)
user/:userId/tag/global.all
- All articles from all personal tags, including global.saved (example: “user/c805fcbf-3acf-4302-a97e-d82f9d7c897f/tag/global.all”)
user/:userId/tag/global.annotated
- All personal annotated articles (pro only), i.e. with a highlight or a comment (example: “user/c805fcbf-3acf-4302-a97e-d82f9d7c897f/tag/global.annotated”)
user/:userId/priority/global.all
- All articles from all personal priority filters (example: “user/c805fcbf-3acf-4302-a97e-d82f9d7c897f/priority/global.all”)
These resources are specific to enterprise customers:
Feedy Greedy Deer Feed
enterprise/:enterpriseName/category/global.all
- All articles from all team feeds (example: “enterprise/acmeinc/category/global.all”)
enterprise/:enterpriseName/tag/global.all
- All articles from all team tags (example: “enterprise/acmeinc/tag/global.all”)
enterprise/:enterpriseName/priority/global.all
- All articles from all team priority filters (example: “enterprise/acmeinc/priority/global.all”)
enterprise/:enterpriseName/tag/global.annotated
- All team annotated articles (enterprise only), i.e. with a highlight or a comment (example: “user/c805fcbf-3acf-4302-a97e-d82f9d7c897f/tag/global.annotated”)
user/:userId/category/global.enterprise
- All articles from all the team categories a user is following (example: “user/c805fcbf-3acf-4302-a97e-d82f9d7c897f/category/global.enterprise”)
user/:userId/tag/global.enterprise
- All articles from all the team tags a user is subscribed to (example: “user/c805fcbf-3acf-4302-a97e-d82f9d7c897f/tag/global.enterprise”)
Authentication
In order to access most APIs you will have to first authenticate to a Feedly account in order to generate an access token.All the endpoint expect an Authorization header.
or
![Feedy Feedy](/uploads/1/1/9/6/119612015/558506056.jpg)
There are two ways to obtain an access token:
- generate a Developer Token for an account. This is the simplest way to get started, as it doesnot require any approval. It is limited to a single account, and can perform a limited number of API calls per day.
- use the full OAuth API to generate tokens for any account. This will let you build applications formultiple users, but it requires API access keys. Please see the Feedly API developer forum to get started.
HTTP Verbs
Where possible, API v3 strives to use appropriate HTTP verbs for each action.
- GET
- Used for retrieving resources.
- POST
- Used for creating resources, or performing custom actions (such as using markers to mark entries, categories and feeds as red).
- PUT
- Used for replacing resources or collections.
- DELETE
- Used for deleting resources.
Client Errors
Here are some of the most common types of client errors on API calls that receive request bodies:
- Sending invalid JSON, or the wrong
Content-Type
header will result in a400 Bad Request
response. - Sending the wrong type of JSON values will result in a
400 Bad Request
response. - Sending a request with an invalid or expired Authorization header will result in a
401 Unauthorized
response.
The “errorMessage” usually contains a helpful message about the issue.The “errorId” property makes it easy for the Feedly team to find extended error messages,and help you debug your application faster.
If resources have custom validation errors, they will be documented with the resource.
Pagination
Requests which allow clients to page through a long list of entries use the concept ofcount and continuation to allow the client to page through the entries. See (streams)[https://developer.feedly.com/v3/streams] endpoint.
Rate Limiting
The Feedly Cloud servers have abuse-prevention systems that might reject API calls if too many requests are detected.When this happens, your application will receive a
429 Too Many Requests
, as well asa Retry-After
header with the number of seconds of “penalty”. During this time period,all API calls from this client will be rejected.Some APIs like feeds, search, and authentication are much more sensitive to abuse-prevention.For access tokens that are rate-limited (like Developer Tokens), the Feedly Cloud server will return extra headersabout the number of calls performed, the call limit, and the time before the limit resets (in seconds).
In this example, 13 API calls were performed out of 500 total, and the count will reset tozero in 23,841 seconds.
Conditional requests
Currently, most responses will return “no cache” headers, and a new ‘Last-Modified’.As we implement better cache control, these headers might change.
Cross Origin Resource Sharing
At the moment, Feedly does not support CORS from other domains.
Millions of professionals rely on Feedly to keep up with the topics and trends they care about. The content they discover and curate in Feedly is all the more valuable if they can easily share it with other people and applications. The purpose of the Feedly API is to empower individuals and businesses to streamline their research and curation workflows as well as empower third-party developers to create different/innovative reading experiences.
Feedly Enterprise customers can use the Feedly API add-on feature to integrate the insights they current in Feedly with ticketing apps, collaboration apps, sales apps, social media sharing apps, machine learning models, and other business apps. The Feedly Enterprise plan includes up to 200,000 request per month and the full power of the Feedly API. Any action a user is taking in the Feedly application can be performed via the Feedly Enterprise API.
Feedly Pro customers can use productivity apps like Buffer, Zapier, IFTTT, and many others to easily integrate their their Feedly with other systems and automate tedious cut-and-paste actions. If you are a developer building a productivity app and you would like to to integrate your app with Feedly, we have a special program to support you.
Feedly Pro customers can also use the Feedly app to create what we call hobby scripts (small apps that allow you to play with your Feedly content in a non-commercial context)
The last use case for the Feedly API is the development of third-party reader apps. There are already lots of third-party reader apps integrated with Feedly (example: Reeder, Newsify, …) so we have a review process to make sure that a new potential reading app that wants to integrate with Feedly is truly innovative and respectful of the user’s privacy before we grant access to the API.
The Feedly mobile and Web apps are built on top of the Feedly API so all the Feedly features are available via the JSON+REST API.
If you are a Feedly customer, interested in integrating your Feedly feeds, boards, and priorities with another business applications, please signup for an Feedly Enterprise API demo.
Feedly Sign In
If you are building a productivity application and integrating with Feedly to enable your customers access their Feedly content, we require a Feedly Pro license for each customer. This is what we are doing with Buffer, IFTTT, Zapier, etc. You can start building your application against the Feedly API Sandbox and contact us when you are ready to go production.
If you are building an innovative consumer application using Feedly (innovative because of a new platform or UI), we will grant you a license and help you distribute your solution. The key here is around innovation. You can start building your application against the Feedly API Sandbox and contact us when you are ready to go production.
If you are a hobbyist playing around with the Feedly API in a non-commercial context and have a Feedly Pro plan, you can use the Feedly developer token to access your feeds and boards.
The Feedly API is based on JSON and REST. It is very easy to use. Here are three examples.
Example 1: Get access to the content of the ReadWrite feed
Example 2: Get access to the personalization graph of an authenticated user
Example 3: Get the most popular articles from Engadget
Here are a few toolkits and libraries contributed by Feedly API developers.
- FeedlyClient, a Python wrapper library
- feedly-api, a PHP wrapper library
- RSSSharp, a .Net toolkit
- feedly node, a Node.JS library
- Feedlr, a Ruby wrapper
- D Feedly, a D language wrapper library