Streamio API Documentation

Images - List

Returns a list of images from your account filtered and sorted on the parameters your specify.

Request

Url

https://streamio.com/api/v1/images.format

Request Method

GET

Parameters

• tags Return images including any of the given (comma separated) tags. https://streamio.com/api/v1/images.json?tags=awesome%2Cfunny
• tags.in Same as tags (in is short for include). https://streamio.com/api/v1/images.json?tags.in=awesome%2Cfunny
• tags.all Returns images including all given tags. https://streamio.com/api/v1/images.json?tags.all=awesome%2Cfunny
• tags.nin Returns images not including given tags. https://streamio.com/api/v1/images.json?tags.nin=awesome%2Cfunny
• skip Skips the given number of results (useful for pagination). https://streamio.com/api/v1/images.json?skip=5
• limit Limits the number of results to the given number (default is 20, max is 100). https://streamio.com/api/v1/images.json?limit=1
• order Specifies the attribute on which the results should be ordered (default is created_at descending). You can specify if the ordering should be ascending or descending by adding .asc or .desc to the attribute name. https://streamio.com/api/v1/images.json?order=created_at.asc

Response

Code

200

Body

Examples

Query on tags

Find images tagged with "sports" or "nature" with the tags parameter.

curl -u username:password https://streamio.com/api/v1/images.json?tags=sports%2Cnature

Find images tagged with both "sports" and "england" with the tags.all parameter.

curl -u username:password https://streamio.com/api/v1/images.json?tags.all=sports%2Cengland