List Streams in Hub¶

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

Request¶

GET https://v2.api.uberflip.com/hubs/{hubId}/streams

Path Parameters	Description
hubId	The unique identifier of the hub

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	Properties	Type	Description
id		Integer	The stream identifier
hub_id		Integer	The hub identifier
title		String	The stream title
description		String	The stream description
url		String	The stream URL
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
no_robots		Boolean	Whether the stream allows robots
template_data		Object
->	list_view	Boolean	Whether the stream is in list view
->	read_more	Boolean	Whether the stream has the read more button
->	prevent_small_images	Boolean	Whether the stream allows small images
->	canonical_meta	Boolean	Whether the stream has canonical meta
->	canonical_redirect	Boolean	Whether the stream has canonical redirect
->	comments_disabled	Boolean	Whether the stream allows comments
owner		Object
->	id	Integer	Id of the user that created this stream
->	first_name	String	First name of the user that created this stream
->	last_name	String	Last Name of the user that created this stream
->	avatar_url	String	Url of this user’s avatar image
hidden		Boolean	Whether the stream is hidden
paused		Boolean	Whether the stream is paused
exclude_from_search		Boolean	Whether the stream is excluded from search
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/hubs/24601/streams

Sample response:

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

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