search

PromyLOPh / pandora-apidoc

pandora.com API documentation
https://6xq.net/pandora-apidoc/
Do What The F*ck You Want To Public License
48 stars 19 forks source link

docs:Add details on different search result token formats. #16

Closed jcass77 closed 8 years ago

jcass77 commented 8 years ago

It seems that the musicToken for search results is divided into three categories:

nearMatchesAvailable is True indicates that more results are available, but they are not included in the result list. This may suggest that near matches need to be retrieved with a separate (as yet undocumented) call.

jcass77 commented 8 years ago

I don't think the number of digits contained in musicToken is fixed, only the first character appears to be significant in determining the type of result.

Fixed in 9709f7c8276cbdf547227622f135e9175027318f.

PromyLOPh commented 8 years ago

It seems that the musicToken for search results is divided into three categories:

  • song results start with 'S' and are followed by seven digits.
  • artist results start with 'R' and are followed by six digits.
  • composer results start with 'C' and are followed by five digits. I wonder whether musicToken’s format is actually part of the API or just a transparent string. Anyway, merged.

nearMatchesAvailable is True indicates that more results are available, but they are not included in the result list. This may suggest that near matches need to be retrieved with a separate (as yet undocumented) call. I added the missing parameters to music.search.