List Streams¶

This endpoint returns a paginated list of all the streams in an account.

Request¶

GET https://v2.api.uberflip.com/streams

Query Parameters	Description
query	Return only results containing the specified text in one or more of the following fields: title description
type	Return only streams of the specified type (“blogs”, “docs”, “videos”, etc)
service	Return only streams importing items from the specified service (“blogpost”, “uberflip”, “youtube”, “vimeo”, etc)
limit	Number of results to return
page	Page to show
sort	Sort results by one or more of the following fields: id title description item_count created_at modified_at

Response¶

The response will contain a streams collection:

Body Parameters	Type	Description
data	Array	The collection of streams
meta	Object	See: Pagination

Each item in the collection will have properties:

Body Parameters	Type	Description
id	Integer	The stream identifier
title	String	The stream title
description	String	The stream description
thumbnail_url	String	The stream thumbnail URL
type	String	The type of stream (“blogs”, “docs”, “videos”, etc)
service	String	The service that the stream imports items from (“blogpost”, “uberflip”, “youtube”, “vimeo”, etc)
item_count	Integer	The number of items in the stream
paused	Boolean	Whether the stream is paused
created_at	Date	The stream created date
modified_at	Date	The stream last modified date

Examples¶

curl -H "Authorization: Bearer [Token]" \
-i https://v2.api.uberflip.com/streams

Sample response:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "data": [
        {
            "id": 17359,
            "title": "Relevantize Blog",
            "description": null,
            "type": "blogs",
            "service": "blogpost",
            "item_count": 17,
            "thumbnail_url": "http://cdn.uberflip.com/mediaproxy?url=https://content.cdntwrk.com/files/aHViPTIxOCZjbWQ9aXRlbWVkaXRvcmltYWdlJmZpbGVuYW1lPWl0ZW1lZGl0b3JpbWFnZV81NjQyNGE5OWExODUwLnBuZyZ2ZXJzaW9uPTAwMDAmc2lnPWMyYjg3NTQ4YWU3NjJhODAxYjM4NWY1NGE0NWZiMGEx&size=3&version=14471",
            "paused": false,
            "created_at": "2013-06-14T14:13:41-0400",
            "modified_at": "2015-11-11T09:38:45-0500"
        },
        {
            "id": 1729,
            "title": "Players",
            "description": "Cinema Musica Videogiochi Arte Letteratura Comics Social",
            "type": "blogs",
            "service": "blogpost",
            "item_count": 200,
            "thumbnail_url": "http://www.playersmagazine.it/wordpress/wp-content/uploads/2014/03/how-i-met-your-mother-wallpaper.jpg",
            "paused": false,
            "created_at": "2013-06-21T15:14:33-0400",
            "modified_at": "2014-10-30T09:05:57-0400"
        }
    ],
    "meta": {
        ...
    }
}