Thumbnails

For user-uploaded images, some thumbnails are pre-generated. The dimensions and URLs of these thumbnails depend on the type of image. Images uploaded as attachments to messages always have type Image.

The pregenerated thumbnails are listed below. In addition, since API version 1.3.6, custom formats can be requested. See Custom Thumbnails.

Note The URLs listed here are relative to the network domain (i.e. yoursubdomain.speakap.com), not the API.

Avatar

Key Size WxH URL
iphoneProfileImage 100x100 /files/{eid}/iphone-profile-image
iphoneProfileImageRetina 200x200 /files/{eid}/iphone-profile-image-retina
iphoneThumbnail 35x35 /files/{eid}/iphone-thumbnail
iphoneThumbnailRetina 70x70 /files/{eid}/iphone-thumbnail-retina
profileImage 260x260 /files/{eid}/profile-image
thumbnail 100x100 /files/{eid}/thumbnail

Background image

Key Size WxH URL
background 1440x900 /files/{eid}/background

Login background image

Key Size WxH URL
background 1440x900 /files/{eid}/background

Emblem

Key Size WxH URL
iphoneProfileImage 100x100 /files/{eid}/iphone-profile-image
iphoneProfileImageRetina 200x200 /files/{eid}/iphone-profile-image-retina
iphoneThumbnail 35x35 /files/{eid}/iphone-thumbnail
iphoneThumbnailRetina 70x70 /files/{eid}/iphone-thumbnail-retina
profileImage 260x260 /files/{eid}/profile-image
thumbnail 100x100 /files/{eid}/thumbnail

Icon

Key Size WxH URL
iphoneThumbnail 35x35 /files/{eid}/iphone-thumbnail
iphoneThumbnailRetina 70x70 /files/{eid}/iphone-thumbnail-retina
thumbnail 100x100 /files/{eid}/thumbnail

Images

Key Size WxH URL
iphoneTimeline 280x280 /files/{eid}/iphone-timeline
iphoneTimelineRetina 560x560 /files/{eid}/iphone-timeline-retina
iphoneFullscreen 320x568 /files/{eid}/iphone-fullscreen
iphoneFullscreenRetina 640x1136 /files/{eid}/iphone-fullscreen-retina
timelinePreviewSmall 235x235 /files/{eid}/timeline-preview-small
timelinePreviewLarge 474x360 /files/{eid}/timeline-preview-large

Profile header background

Key Size WxH URL
iphoneProfileHeaderBackground 320x138 /files/{eid}/iphone-profile-header-background
iphoneProfileHeaderBackgroundRetina 640x276 /files/{eid}/iphone-profile-header-background-retina
profileHeaderBackground 780x260 /files/{eid}/profile-header-background

Teaser image

Key Size WxH URL
iphoneThumbnail 35x35 /files/{eid}/iphone-thumbnail
iphoneThumbnailRetina 70x70 /files/{eid}/iphone-thumbnail-retina
thumbnail 100x100 /files/{eid}/thumbnail

Custom Thumbnails

Since API version 1.3.6, custom thumbnail sizes can be requested using urls like /files/{eid}/?w=200&h=100.

The w and h parameters represent the desired width and height respectively. The following rules apply for the returned thumbnail:

  • The image will be scaled proportionally. This means when a width of 200 and a height of 100 is requested, the image will be scaled to fit inside these dimensions, but may not have those exact dimensions if the aspect ratio of the image is not 2:1
  • The image will never be enlarged. If the image already fits within the requested dimensions, it will be returned in its original size.
  • It’s possible to provide only the w or h parameter. The image will be scaled proportionally to fit within that width or height.
  • When a specific thumbnail size is requested for the first time, a lower-quality version may be returned at first. A high-quality version may be generated asynchronously, so that subsequent requests for that thumbnail will result in a high-quality thumbnail. Note that the difference between the lower-quality and the high-quality thumbnails is generally hard to see.

To prevent abuse, not all combinations of width and height are allowed. The following table shows the possible combinations. For any of the listed combinations, it is also possible to use only one of the components (w or h). Some values are only allowed for certain kinds of source images.

w h source
127 80 any
140 132 any
140 77 any
156 110 any
157 110 any
170 162 any
170 107 any
174 110 landscape
186 186 any
206 80 any
236 110 any
236 236 square
236 350 portrait
252 276 portrait
252 276 portrait
236   portrait
300 170 any
302 326 portrait
390 170 any
424   any
454   any
454 350 portrait
454 454 square
424 163 landscape
474 213 landscape
474 175 landscape
474 100 landscape
468 158 landscape
  236 landscape
  260 any
  419 portrait
  454 any
  424 any