API Research Apigee vs Mashery

apigee format

(get) examples

general outline

• api.url/version/subject/action?query_instruction=<...>&other_query=<...>

twitter - searching for posts about turkey riots

• https://api.instagram.com/v1/users/search?q=turkey%20riots&count=100

reddit -

• http://www.reddit.com/api/info.json?limit=100
• Note: info.json alters the return type. info.xml or info.html render return accordingly

Possible Crowd Scholar example::

• https://api.crowdscholar.com/v1/articles/search?q='some_query'&count='some_count'

(post) examples

general outline

• api.url/version/subject_or_action?parameters=<...>&other_parameters=<...>

twitter example - subscribing to a user

• https://api.instagram.com/v1/subscriptions?verify_token=something&client_id=who_I_want_to_follow&client_secret=something_else

reddit example - registering a user

• http://www.reddit.com/api/register?user=timmy&email=tim%40tom.com&passwd=tom&passwd2=tom&dest=pewpew&rem=true&reason=subscribe

Possible Crowd Scholar example

• https://api.crowdscholar.com/v1/articles?json='...'

mashery format

(get) examples

rotten tomatoes

• retrieve box office movies - rottentomatoes.com/api/public/v1.0/lists/movies/box_office.json
• detailed info about a movie by id - rottentomatoes.com/api/public/v1.0/movies/:id.json
• detailed movie about the cast of a movie by id - /api/public/v1.0/movies/:id/cast.json

rovi

• search titles or names in the rovi cloud - http://api.rovicorp.com/search/v2/:endpoint/search
• http://api.rovicorp.com/search/v2/music/search?entitytype=song&query=starfuckers&size=20&offset=0&country=US&language=en&format=json&sig=bb1183b58c9699fef33916b4d71245c6

General RESTFul api design

• http/https://www.mycompany.com/program/method?Parameters=xx
• GET {Accept: [json|xml]} https://www.api.scholarly.io/v1/articles/
• GET {Accept: [json|xml]} https://www.api.scholarly.io/v1/articles/ID
• GET {Accept: [json|xml]} https://www.api.scholarly.io/v1/articles/?date=2009&title=brains
• POST https://www.api.scholarly.io/v1/articles/ | {json}