starred/shiori

Fork 0

mirror of https://github.com/go-shiori/shiori.git synced 2026-04-25 06:25:54 +03:00

[GH-ISSUE #208] Clone Pocket API? #152

New issue

Closed

opened 2026-02-25 23:33:34 +03:00 by kerem · 12 comments

kerem commented

2026-02-25 23:33:34 +03:00

Owner

Originally created by @eabra on GitHub (Oct 24, 2019).
Original GitHub issue: https://github.com/go-shiori/shiori/issues/208

Would it be possible to offer a clone of the Pocket API so other Tools could connect and add/remove items here?

Originally created by @eabra on GitHub (Oct 24, 2019). Original GitHub issue: https://github.com/go-shiori/shiori/issues/208 Would it be possible to offer a clone of the Pocket API so other Tools could connect and add/remove items here?

kerem

2026-02-25 23:33:34 +03:00

closed this issue
added the
resolution:wontfix
label

kerem commented

2026-02-25 23:33:34 +03:00

Author

Owner

@8bitgentleman commented on GitHub (Nov 2, 2019):

Shiori already has an API, not as robust as Pocket's obviously but it lets you add/edit/remove bookmarks among other things

@8bitgentleman commented on GitHub (Nov 2, 2019): Shiori already has an API, not as robust as Pocket's obviously but it lets you add/edit/remove bookmarks among other things

kerem commented

2026-02-25 23:33:34 +03:00

Author

Owner

@cocoastorm commented on GitHub (Nov 4, 2019):

what other tools did you have in mind? just curious

@cocoastorm commented on GitHub (Nov 4, 2019): what other tools did you have in mind? just curious

kerem commented

2026-02-25 23:33:34 +03:00

Author

Owner

@eabra commented on GitHub (Nov 5, 2019):

Oh there are so many: miniflux, Reeder, self built tools, etc.

@eabra commented on GitHub (Nov 5, 2019): Oh there are so many: miniflux, Reeder, self built tools, etc.

kerem commented

2026-02-25 23:33:34 +03:00

Author

Owner

@8bitgentleman commented on GitHub (Nov 5, 2019):

All those tools are rss readers. Are you really looking for shiori to publish a user's saved links as a private rss feed?
This is how pocket uses rss feeds

@8bitgentleman commented on GitHub (Nov 5, 2019): All those tools are rss readers. Are you really looking for shiori to publish a user's saved links as a private rss feed? [This is how pocket uses rss feeds](https://help.getpocket.com/article/1074-can-i-subscribe-to-my-list-via-rss)

kerem commented

2026-02-25 23:33:34 +03:00

Author

Owner

@eabra commented on GitHub (Nov 5, 2019):

No I'm looking for a way to have the RSS readers send the links to shiori without having to build new API integrations for it but instead utilize the cloned pocket API so they won't have to modify their applications this way.

@eabra commented on GitHub (Nov 5, 2019): No I'm looking for a way to have the RSS readers send the links to shiori without having to build new API integrations for it but instead utilize the cloned pocket API so they won't have to modify their applications this way.

kerem commented

2026-02-25 23:33:34 +03:00

Author

Owner

@deanishe commented on GitHub (Aug 7, 2020):

No I'm looking for a way to have the RSS readers send the links to shiori without having to build new API integrations

Pretty much pointless, tbh. Even if an app isn't using the Pocket SDK, the API is still based on OAuth (which is large and complex) and every app will have its own consumer key and the Pocket API URL hardcoded.

As a result, adding support for a clone of the Pocket API to an app is actually much more complicated than adding support for an entirely different, but much simpler, API.

Either way, I just don't see many (if any) app developers buying into it.

The "Share" menu would be a far better starting point for integration, imo, because it doesn't rely on application developers to modify their apps.

@deanishe commented on GitHub (Aug 7, 2020): > No I'm looking for a way to have the RSS readers send the links to shiori without having to build new API integrations Pretty much pointless, tbh. Even if an app isn't using the Pocket SDK, the API is still based on OAuth (which is large and complex) and every app will have its own consumer key and the Pocket API URL hardcoded. As a result, adding support for a clone of the Pocket API to an app is actually much more complicated than adding support for an entirely different, but much simpler, API. Either way, I just don't see many (if any) app developers buying into it. The "Share" menu would be a far better starting point for integration, imo, because it doesn't rely on application developers to modify their apps.

kerem commented

2026-02-25 23:33:34 +03:00

Author

Owner

@samuelstevens commented on GitHub (Mar 8, 2022):

All those tools are rss readers. Are you really looking for shiori to publish a user's saved links as a private rss feed?

Sorry to open a dead issue two years later, but this is exactly what I'm looking for. I'd like to save links to a self-hosted service and then subscribe to a list of those links with a third-party rss reader. Is this possible?

@samuelstevens commented on GitHub (Mar 8, 2022): > All those tools are rss readers. Are you really looking for shiori to publish a user's saved links as a private rss feed? Sorry to open a dead issue two years later, but this is exactly what I'm looking for. I'd like to save links to a self-hosted service and then subscribe to a list of those links with a third-party rss reader. Is this possible?

kerem commented

2026-02-25 23:33:34 +03:00

Author

Owner

@fmartingr commented on GitHub (Mar 10, 2022):

Sorry to open a dead issue two years later, but this is exactly what I'm looking for. I'd like to save links to a self-hosted service and then subscribe to a list of those links with a third-party rss reader. Is this possible?

This is not integrated withing shiori (and probably never will), but creating an RSS feed from the Get Bookmarks endpoint using your preferred fields should be trivial.

@fmartingr commented on GitHub (Mar 10, 2022): > Sorry to open a dead issue two years later, but this is exactly what I'm looking for. I'd like to save links to a self-hosted service and then subscribe to a list of those links with a third-party rss reader. Is this possible? This is not integrated withing shiori (and probably never will), but creating an RSS feed from the [Get Bookmarks](https://github.com/go-shiori/shiori/wiki/API#get-bookmarks) endpoint using your preferred fields should be trivial.

kerem commented

2026-02-25 23:33:34 +03:00

Author

Owner

@samuelstevens commented on GitHub (Mar 11, 2022):

Thanks! One thing that I find really exciting about Shiori is automatic content extraction. I looked through the API docs and couldn't see anyway to get that content via the API; did I miss something? Or should I fork/open a PR if I want to see that in Shiori?

@samuelstevens commented on GitHub (Mar 11, 2022): Thanks! One thing that I find really exciting about Shiori is automatic content extraction. I looked through the API docs and couldn't see anyway to get that content via the API; did I miss something? Or should I fork/open a PR if I want to see that in Shiori?

kerem commented

2026-02-25 23:33:34 +03:00

Author

Owner

@fmartingr commented on GitHub (Mar 12, 2022):

Thanks! One thing that I find really exciting about Shiori is automatic content extraction. I looked through the API docs and couldn't see anyway to get that content via the API; did I miss something? Or should I fork/open a PR if I want to see that in Shiori?

You're right! Content is not exposed through the API :(

Right now I could see this in two ways, either a new /content/:id endpoint to extract the content of a specific bookmark or a parameter in the /bookmarks endpoint to specify if we want the content extracted as well in the output.

I'd prefer the first one, I'm not very fond of parameters modifying an API response and the performance will dimisish the more bookmarks a database has; even if right now the /bookmarks performs a JOIN with the content table, this won't be like that in the future due to performance issues. (sqlite: #387)

What do you think?

@fmartingr commented on GitHub (Mar 12, 2022): > Thanks! One thing that I find really exciting about Shiori is automatic content extraction. I looked through the API docs and couldn't see anyway to get that content via the API; did I miss something? Or should I fork/open a PR if I want to see that in Shiori? You're right! Content is not exposed through the API :( Right now I could see this in two ways, either a new `/content/:id` endpoint to extract the content of a specific bookmark or a parameter in the `/bookmarks` endpoint to specify if we want the content extracted as well in the output. I'd prefer the first one, I'm not very fond of parameters modifying an API response and the performance will dimisish the more bookmarks a database has; even if right now the `/bookmarks` performs a `JOIN` with the content table, this won't be like that in the future due to performance issues. (sqlite: #387) What do you think?

kerem commented

2026-02-25 23:33:34 +03:00

Author

Owner

@samuelstevens commented on GitHub (Mar 14, 2022):

I prefer the first approach as well.

I will take a look and see if I can implement a first pass sometime this week. Are there docs for contributing/developers?

@samuelstevens commented on GitHub (Mar 14, 2022): I prefer the first approach as well. I will take a look and see if I can implement a first pass sometime this week. Are there docs for contributing/developers?

kerem commented

2026-02-25 23:33:34 +03:00

Author

Owner

@fmartingr commented on GitHub (Mar 19, 2022):

I prefer the first approach as well.

I will take a look and see if I can implement a first pass sometime this week. Are there docs for contributing/developers?

Right now there isn't much, everything available is in the wiki, though starting working on shiori should be much of a trouble if you have go installed. A Simple go run main.go should suffice. Keep in mind that if you use shiori on your computer directy this will load the same database, you can change it using environment variables. There's also a modd file included in the repository which bundles the assets and launches the development server, but it didn't work for me so I do the manual way.

One of the things I need to work on is updating the documentation (and moving it to the repository #394). I may overhaul how to work locally with shiori while doing that. Any feedback on that regard will be appreciated.

@fmartingr commented on GitHub (Mar 19, 2022): > I prefer the first approach as well. > > I will take a look and see if I can implement a first pass sometime this week. Are there docs for contributing/developers? Right now there isn't much, everything available is in the wiki, though starting working on shiori should be much of a trouble if you have go installed. A Simple `go run main.go` should suffice. Keep in mind that if you use shiori on your computer directy this will load the same database, you can change it using [environment variables](https://github.com/go-shiori/shiori/wiki/Configuration). There's also a modd file included in the repository which bundles the assets and launches the development server, but it didn't work for me so I do the manual way. One of the things I need to work on is updating the documentation (and moving it to the repository #394). I may overhaul how to work locally with shiori while doing that. Any feedback on that regard will be appreciated.