Goodreads Developers discussion

I'm working on:
Get the reviews for a book given an ISBN
Get the reviews for a book given a Goodreads book id
Get the reviews for a book given a title string
which I assume are 3 variants returning more/less the same content (is that assumption correct?)

They all have a parameter
• rating: Show only reviews with a particular rating (optional)
What is the syntax of the rating?

Get the reviews for a book given a Goodreads book id has a parameter
• text_only: Only show reviews that have text (default false)
the other two do not list that parameter.
1. Is it there on the other two or is it only on the Goodreads book id version?
2. What is the syntax for the parameter? 'true' and 'false'? Is capitalization relevant?

which I assume are 3 variants returning more/less the same content (is that assumption correct?)

yep

1. Is it there on the other two or is it only on the Goodreads book id version?
i think they do support it, but i'd have to check.
. What is the syntax for the parameter? 'true' and 'false'? Is capitalization relevant?

I think you want 'true' or to not pass the parameter at all.

Ok, I'll experiment with the text_only parameter.

What is the syntax for the rating (e.g. what values are allowed)?

Actually, what do the text_only and rating parameters affect in the output?

Or are they hold over parameters from when you actually returned reviews rather than the reviews widget that is returned now?

Gregg wrote: "What is the syntax for the rating (e.g. what values are allowed)?"

1-5

The text_only parameter is a boolean flag, so you can set it to true or false. If you set it to true in your request, you will get only reviews with an actual body of text.

I guess I'll need to try another sample, I got the same results whether the test_only flag was true or false.

Is there some particular place in the XML I should be looking for a difference?

Gregg wrote: "I guess I'll need to try another sample, I got the same results whether the test_only flag was true or false.

There could be a bug, but that's how it's supposed to work.

Gregg wroteIs there some particular place in the XML I should be looking for a difference?"

Look for the tag in each element in the returned XML.

I've tried with several different books and never get elements in the response, just the element.

Oh, review requires an additional permission.

If you guys want to display reviews, we'd highly recommend our reviews-widget.

That's what I told CML, right now they are not going to use reviews for the first round.