-
Notifications
You must be signed in to change notification settings - Fork 10
Users
These are the API calls that you can use to retrieve users, their photos, friends and other data
- /users, GET
- /users/#{id}, GET
- /users/#{id}/photos, GET
- /users/#{id}/likedPhotos, GET
- /users/#{id}/friendsPhotos, GET
- /users/#{id}/likedAlbums, GET
- /users/#{id}/feed, GET
- /users/#{id}/friends, GET
- /users/#{id}/friends/#{friend_id}, GET
- /users/#{id}/followers, GET
- /users/#{id}/followers/#{friend_id}, GET
- /users/#{id}/topics, GET
- /users/#{id}/socialMedia, GET
The various possible representations of a user (simple,detailed) are presented and described in the model page.
Search for users
- q: the string to search users by
- limit (num of search results to return, default 30)
- offset (offset of search results to start at, default 0)
- 200, pagination params and a array of user objects
https://www.eyeem.com/api/v2/users?q=ramzi&limit=25&offset=20
Get a user's profile information
- detailed (boolean, default 0) 1 returns more details about the user
- 200 and a user object
Get the given user's photos
- limit: (optional, default 20)
- offset: (optional, default 0)
- 200 and and a dictionary containing limit, offset, total and an array of photo objects
Get all the photos that a user has liked note: sending onlyId=1 in request url returns a json array userIds containing just the ids
- limit: (optional, default 20)
- offset: (optional, default 0)
- onlyId=1 (optional)
- 200 and and a dictionary containing limit, offset, total and an array of photo objects
Get all the photos by users that the given user follows (ordered chronologically)
- limit: (optional, default 20)
- offset: (optional, default 0)
- 200 and and a dictionary containing limit, offset, total and an array of photo objects
note: sending onlyId=1 in request url returns a json array likedAlbumIds containing just the ids
- limit: (optional, default 20)
- offset: (optional, default 0)
- 200 and and a dictionary containing limit, offset, total and an array of likedAlbums (albums objects)
Gets albums relevant to a user (selection happens server side, includes albums they like, albums they contributed to, trending, recommended and nearby albums)
If requested from a user other than the authenticated one, only the user's liked albums are returned
- limit: (optional, default 20)
- offset: (optional, default 0)
- TODO: more parameters to come
- 200 and and a dictionary containing limit, offset, total and an array of albums
Get a user's friends (users that they follow) note: sending onlyId=1 in request url returns a json array userIds containing just the ids
- limit: (optional, default 20)
- offset: (optional, default 0)
- onlyId=1 (optional)
- 200 and and a dictionary containing limit, offset, total and an array of friends (users)
Check if the given user is friends with (follows) another user
- 200 if friends, 404 if not
Get a user's followers note: sending onlyId=1 in request url returns a json array userIds containing just the ids
- limit: (optional, default 20)
- offset: (optional, default 0)
- onlyId=1 (optional)
- 200 and and a dictionary containing limit, offset, total and an array of followers (users)
Check if a user follows the given user
- 200 if following, 404 if not
Get a list of topics the user has contributed to (the topics correlate to tag albums)
- limit: (optional, default 20)
- offset: (optional, default 0)
- 200 and and a dictionary containing limit, offset, total and an array of topic objects
Only available for the authenticated user, this call returns the status of the various connected social media accounts
- none
- 200 and an array of services objects