Get top media image for a data source

get

https://edge.curalate.com/v1/media/{dataSourceId}/images/top

Path Params

dataSourceId

string

required

Unique gallery ID

Query Params

offset

int32

Gets the top image at the Nth offset. This enables displaying multiple images by simply varying the offset parameter. Valid values: 0 to 24

sort

string

enum

Sorts

Latest - recent content based on when it was posted to the social network or uploaded to Social Commerce
Likes - content that was liked more on social
Optimized - new and trending content that trends to get more engagement
Moderation - content that was recently moderated on the Social Commerce dashboard
Default value = Latest

Allowed:

filter

string

Filters the requested content. Filters are composed of one or more key-value pairs combined with boolean operators and parenthetical groupings. At this time a NOT operator isn’t available

fallbackImage

string

URL to an image to use as the result if no matching content is available

width

int32

Pixel width. Set to resize the image to the desired width

height

int32

Pixel height. Use with the width parameter to control both dimensions e.g., to create a square image. If the resulting aspect ratio differs from the original image, it will be cropped using an intelligent algorithm that preserves features in the image

networkSource

string

enum

Returns content for a particular network type

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200The operation completed successfully and yielded results.

400The input parameters are not valid.

404A requested resource was not found.

500An unhandled exception has occurred.

503API is temporarily unavailable.