{"id":13572203,"url":"https://github.com/feedbin/feedbin-api","last_synced_at":"2026-01-27T01:32:42.375Z","repository":{"id":6740461,"uuid":"7986664","full_name":"feedbin/feedbin-api","owner":"feedbin","description":"Feedbin API Documentation","archived":false,"fork":false,"pushed_at":"2023-07-21T11:49:00.000Z","size":107,"stargazers_count":356,"open_issues_count":20,"forks_count":26,"subscribers_count":23,"default_branch":"master","last_synced_at":"2025-03-01T15:44:54.831Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/feedbin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2013-02-03T05:17:50.000Z","updated_at":"2025-02-17T15:58:25.000Z","dependencies_parsed_at":"2024-01-14T03:51:28.460Z","dependency_job_id":"341e7569-966a-46de-a1f6-1a3bbb4e7365","html_url":"https://github.com/feedbin/feedbin-api","commit_stats":{"total_commits":99,"total_committers":8,"mean_commits":12.375,"dds":0.08080808080808077,"last_synced_commit":"7f6139ba2d2e21571236596adf35ea5eb241ac4a"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/feedbin/feedbin-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feedbin%2Ffeedbin-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feedbin%2Ffeedbin-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feedbin%2Ffeedbin-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feedbin%2Ffeedbin-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/feedbin","download_url":"https://codeload.github.com/feedbin/feedbin-api/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feedbin%2Ffeedbin-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28795468,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T01:07:07.743Z","status":"ssl_error","status_checked_at":"2026-01-27T01:07:06.974Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T14:01:16.392Z","updated_at":"2026-01-27T01:32:42.358Z","avatar_url":"https://github.com/feedbin.png","language":null,"funding_links":[],"categories":["Index","Others"],"sub_categories":["News"],"readme":"Feedbin API V2\n==============\n\nThis is the official documentation for the Feedbin REST-style API.\n\nAPI Objects\n-----------\n\n- [Authentication](content/authentication.md)\n- [Subscriptions](content/subscriptions.md)\n- [Entries](content/entries.md)\n- [Unread Entries](content/unread-entries.md)\n- [Starred Entries](content/starred-entries.md)\n- [Taggings](content/taggings.md)\n- [Tags](content/tags.md)\n- [Saved Searches](content/saved-searches.md)\n- [Recently Read Entries](content/recently-read-entries.md)\n- [Updated Entries](content/updated-entries.md)\n- [Icons](content/icons.md)\n- [Imports](content/imports.md)\n- [Pages](content/pages.md)\n\nTech Notes\n----------\n\n- [Extracting Full Content](content/extract-full-content.md)\n- [Supporting Twitter](content/supporting-twitter.md)\n\nChanges\n-------\n- 2019-12-27: Added [Pages API](content/pages.md)\n- 2019-05-17: Added [Imports API](content/imports.md)\n- 2019-03-13: Added [Icons API](content/icons.md)\n- 2015-01-22: Added [Updated Entries API](content/updated-entries.md)\n- 2015-01-22: Added [Recently Read Entries API](content/recently-read-entries.md)\n- 2013-10-14: Added [Saved Search API](content/saved-searches.md)\n- 2013-05-20: Added `PATCH subscriptions.json` for editing feed titles to [Subscriptions](content/subscriptions.md#update-subscription)\n- 2013-05-20: Added `per_page` paramter to [Entries](content/entries.md)\n\nMaking Requests\n---------------\n\nThe base URL for all requests is `https://api.feedbin.com/v2/` Only https is supported.\n\nThe Feedbin API uses HTTP Basic authentication\n\nUsing cURL you would make a request like:\n\n```shell\ncurl -u 'example@example.com:password' https://api.feedbin.com/v2/subscriptions.json\n```\n\nWhen creating or updating a record you must set `application/json; charset=utf-8` as the `Content-Type` header.\n\n```shell\ncurl -u 'example@example.com:password' \\\n-H \"Content-Type: application/json; charset=utf-8\" \\\n-X POST -d '{\"feed_url\":\"http://daringfireball.net\"}' \\\nhttps://api.feedbin.com/v2/subscriptions.json\n```\n\nWithout this header you'll wind up with a `415 Unsupported Media Type` response.\n\nHTTP Caching, Use It\n--------------------\nFor extra speed, please use HTTP Caching. `GET` request set ETag and a Last-Modified headers.\n\n```shell\ncurl -v -u 'example@example.com:password'  https://api.feedbin.com/v2/subscriptions/3.json\n\u003c ETag: \"c7d001e87bda1f0d3745b6bd2811b055\"\n\u003c Last-Modified: Sat, 02 Feb 2013 15:20:46 GMT\n```\n\nYou can use these headers in subsequent requests like:\n\n```shell\ncurl -v -u 'example@example.com:password' --header 'If-Modified-Since:Sat, 02 Feb 2013 15:20:46 GMT' --header 'If-None-Match:\"c7d001e87bda1f0d3745b6bd2811b055\"' https://api.feedbin.com/v2/subscriptions/3.json\n\u003c HTTP/1.1 304 Not Modified\n```\n\nPagination\n----------\nEntries use pagination. Each page has a limit of 100 items. Paginated request will include a link header like:\n\n```\nLinks: \u003chttps://api.feedbin.com/v2/feeds/1/entries.json?page=2\u003e; rel=\"next\", \u003chttps://api.feedbin.com/v2/feeds/1/entries.json?page=5\u003e; rel=\"last\"\n```\n\nThe possible rel values are:\n\n- `first` The URL of the first page of results.\n- `prev` The URL of the previous page of results.\n- `next` The URL of the next page of results.\n- `last` The URL of the last page of results.\n\nOn paginated resources there is a header in the response called: `X-Feedbin-Record-Count`. This header reports the total number of records for a resource.\n\nDates\n-----\nThe Feedbin API uses the [ISO 8601](http://www.w3.org/TR/NOTE-datetime) date format. All responses will include dates formatted to this spec and all requests should stick to it as well. The dates are as high resolution as possible to allow for rapid state changes. When using the `since` parameter it is best to include the date exactly as it was returned by the server when the last request was made. Rounding down to the nearest second will most likely cause duplicates.\n\nThe date should include complete date plus hours, minutes, seconds and timezone `YYYY-MM-DDThh:mm:ss.ssssssTZD` (eg `2013-02-19T07:33:38.449047-08:00` or in UTC `2013-02-19T15:33:38.449047Z`). All dates will be converted to UTC, so the timezone is very important.\n\n**Note**\n\nIn Objective-C it's important to force a locale for the date because different regions can cause unexpected output. For example you can properly format a date for the Feedbin API like:\n\n```objectivec\nNSDateFormatter *feedbinDateFormatter = [[NSDateFormatter alloc] init];\nfeedbinDateFormatter.timeZone = [NSTimeZone timeZoneWithAbbreviation:@\"GMT\"];\n[feedbinDateFormatter setDateFormat:@\"yyyy-MM-dd'T'HH:mm:ss.SSSSSS'Z'\"];\n[feedbinDateFormatter setLocale:[[NSLocale alloc] initWithLocaleIdentifier:@\"en_US\"]];\n```\n\nThanks to [Stefan Pauwels](http://zoziapps.ch/) for sharing this tip.\n\nDomain\n------\n\nUntil 2014-03-14 the API hostname was `api.feedbin.me`. `api.feedbin.me` will remain available but `api.feedbin.com` is recommended because it is the new primary domain.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffeedbin%2Ffeedbin-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffeedbin%2Ffeedbin-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffeedbin%2Ffeedbin-api/lists"}