How to export your data
- Would be good to mung any of these into h-review based files for import into an indiewebsite -- Kartik Prabhu
There is also a plugin for the desktop software Calibre that will allow one to sync large portions of their data directly to their computer.
How to import your data
- Multiple shelves to categorize your books.
- Books can be put on multiple shelves.
- There are three core, "exclusive" shelves: read, currently-reading, and to-read.
- All books must be in one and only one of these shelves.
- Additional "exclusive" shelves can be added by the user.
- When a book is on the currently-reading shelf, you can post reading progress updates
- A page number or percentage can be entered
- Optionally, a status of up to 420 characters can be entered
- The currently-reading list shows the percentage complete based on your last reading progress update
- A stream of your friends' added books and reading progress updates
- An annual reading challenge where you can select the number of books you want to read during that year.
- Your reading progress is tracked and informs you whether you are on track or # books behind.
- . . .
POSSE to Goodreads
- gRegor Morrill has manually POSSEd reviews to Goodreads.
- Kyle Mahan has been automatically POSSEing reviews to Goodreads since 2015-12-30
- Chris Aldrich has been manually POSSEing both status updates and reviews to GoodReads since 2016-09-13. Examples can be found in this feed.
API for Goodreads
The API appears to be good for posting information to Goodreads but not as good for reading information, e.g. for PESOS. For example, there does not appear to be a method to directly retrieve a user's updates (reading progress, reviews). The user.show method gets a user's information along with their 10 latest updates, though. It appears multiple calls to different endpoints are necessary to get more complete information.
- In the Goodreads Developers group there is a thread titled "Is the public API maintained at all?" raising some concerns about some things being broken, apparently lack of selfdogfooding by Goodreads (instead using a private, undocumented API). Quite a few other developers echoed the concerns. The thread was started 2017-03-19 and there does not appear to be an official response from Goodreads as of 2019-03-08. 
To POSSE a review to Goodreads would basically involve:
- creating an API key and secret with Goodreads
- OAuthing on behalf of the user
- Searching for the book_id in Goodreads
- Searching for the "shelf" in Goodreads
- Posting the review
Their API guidelines also *require* a link back to the "original" post in Goodreads.
- What if the post on Goodreads is a copy and not the original? - Tantek