Site's Photo Streams
500px.com allows discovery of the photography uploaded by users in a number of ways.
An essential part of presentation is photo streams. Accessing the following streams is possible though means of the API:
- Rating-based streams:
- Popular, photos with a rating over 80, sorted by rating, cached for 5 minutes
- Upcoming, photos with a rating over 60, sorted by creation timestamp, cached for 5 minutes
- Time-based (Fresh) streams:
- Today, photos created since midnight (EST time), cached for 60 seconds
- Yesterday, photos created between last day's midnight and past midnight (EST time), cached until the end of hour
- Week, photos created in the past 7 days, excluding today, cached until the end of hour
- User-based streams:
- Special streams:
Categories
Categories of photos may be specified by their ID or string name, depending on the API method.
| ID |
Name |
| 0 | Uncategorized |
| 10 | Abstract |
| 11 | Animals |
| 5 | Black and White |
| 1 | Celebrities |
| 9 | City and Architecture |
| 15 | Commercial |
| 16 | Concert |
| 20 | Family |
| 14 | Fashion |
| 2 | Film |
| 24 | Fine Art |
| 23 | Food |
| 3 | Journalism |
| 8 | Landscapes |
| 12 | Macro |
| 18 | Nature |
| 4 | Nude |
| 7 | People |
| 19 | Performing Arts |
| 17 | Sport |
| 6 | Still Life |
| 21 | Street |
| 26 | Transporation New! |
| 13 | Travel |
| 22 | Underwater |
| 27 | Urban Exploration New! |
| 25 | Wedding New! |
Photo object formats
Short format
The short format of a Photo object includes the following data:
- id — ID of the photo, integer
- name — Title of the photo, string
- description — Description of the photo, string
- category — Category of the photo, (short) integer
- image_url — URL of the image, string
- rating — Rating of the photo, decimal
- votes_count — The number of votes cast on this photo, integer
- favorites_count — The number of users that have this photo in favorites, integer
- comments_count — The number of comments on this photo, integer
- times_viewed — The number of times this photo has been viewed, integer
- created_at — Timestamp indicating time of photo creation, timestamp
- user — Author's profile in short format, object
Full format
The full format of a Photo object includes the following data:
- id — ID of the photo, integer
- name — Title of the photo, string
- description — Description of the photo, string
- category — Category of the photo, (short) integer
- image_url — URL of the image, string
- votes_count — Number of votes cast on this photo, integer
- favorites_count — Number of times this photo was added as a favorite on the website, integer
- comments_count — Number of comments this photo has, integer
- rating — Rating of the photo, decimal
- created_at — Timestamp indicating time of photo creation, timestamp
- status — Status of the photo in the system, integer. An active photo always has the status of 1.
- user — Author's profile in short format, object
- camera — Make and model of the camera this photo was made with, string
- lens — This photo's camera lens information, string
- aperture — Aperture value of the shot, string
- focal_length — Focal length of the shot, string
- iso — ISO value of the shot, string
- shutter_speed — Shutter speed value of the shot, string
- taken_at — Timestamp of when the photo was taken, timestamp
- location — A human-readable name of the location where the photo was taken, string
- latitude — Latitude of the location where the photo was taken, decimal
- longitude — Longitude of the location where the photo was taken, decimal
The following data will also be returned for an authenticated request:
- voted — Whether the current user has voted for this photo, boolean
- favorited — Whether the current user currently has this photo in favorites, boolean
User object formats
Short format
The short format of a User object includes the following data:
- id — ID of the user, integer
- username — Username, string
- firstname — First name, string
- lastname — Last name, string
- city — City as specified in user's profile, string
- country — Country as specified in user's profile, string
- upgrade_status — Whether the user is a premium user, integer. Non-zero values identify premium users.
Profile format
The profile format of a User object includes the following data:
- id — ID of the user, integer
- username — Username, string
- firstname — First name, string
- lastname — Last name, string
- fullname — A combination of first and last names or a username that would naturally appear on the site, string
- userpic_url — Profile picture's URL of the user, string
- sex — Sex of the user, string. Values: 1 and 2 for male and female respectively, 0 if user refused to specify their sex.
- city — City as specified in user's profile, string
- state — State as specified in user's profile, string
- country — Country as specified in user's profile, string
- registration_date — Registration timestamp, timestamp
- about — User's about text, timestamp
- upgrade_status — Whether the user is a premium user, integer. Non-zero values identify premium users.
- domain — This user's portfolio's domain (hostname), string
- fotomoto_on — Whether the user has the store option enabled, boolean
- locale — User's preferred locale, string. Current values: 'en', 'ru', 'de', 'br'.
- show_nude — Whether the user has content filter disabled, boolean.
- friends_count — Number of people this user follows, integer.
- followers_count — Number of people this user is being followed by, integer.
- photos_count — Number of active photos posted by the user, integer.
- in_favorites_count — Number of times any photo of the user was added to favorites, integer.
- affection — Affection value, integer.
- contacts — A dictionary of user's contacts, object. Keys should be treated as provider names, and values as user IDs with given provider.
Blog Post object formats
Short format
The short format of a Blog Post object includes the following data:
- id — ID of the blog post, integer
- title — Title of the blog post, string
- created_at — Timestamp indicating time the blog post was created, timestamp
- user — Author's profile in short format, object
Full format
The full format of a Blog Post object includes the following data:
- id — ID of the blog post, integer
- longitude — Longitude attached to the blog post, string
- latitude — Latitude attached to the blog post, string
- title — Title, string
- body — Content of post, string
- tags — Comma separated list of tags, string
- created_at — Timestamp indicating time the blog post was created, timestamp
- user — Author's profile in short format, object
- photos — A list of photos given in short format, object
Comment object formats
Full format
The full format of a Comment object includes the following data:
- id — ID of the comment, integer
- body — Content of the comment, string
- to_whom_user_id — To which user the comment was made, string
- user_id — User ID of author of the comment, string
- created_at — Timestamp indicating time the comment was created, timestamp
- user — Author's profile in short format, object
