GetHubItems

This method returns the basic details for all Hubs Items within a Hub.

Request

GET https://api.uberflip.com/?Version=0.1&Method=GetHubItems&APIKey=xxxxxxx&Signature=xxxxxx&HubId=12345&ResponseType=XML
URL Parameters Description
Version The version of the API to call (0.1).
Method The method being called (GetHubItems).
APIKey Your account’s API key.
Signature Your account’s API signature.
UserId (required for master/reseller accounts) The account identifier of the account to call the method on.
HubId The identifier of the Hub to return the Items for.
ResponseType (optional) The response format (XML or JSON). Defaults to JSON.
Limit (optional) The maximum number of results to return.
Page (optional) The page number of results to return. Defaults to 1.
SortBy (optional) The field to sort the results by (id, created, modified, external_created, external_modified, or ordinal).
SortDirection (optional) The direction to sort the results in (ASC or DESC).

For results to be sorted, both SortBy and SortDirection are required.

Types

type values correspond to the type of Item. They can be one of:

  • twitter
  • blogpost
  • facebook
  • youtube
  • uberflip
  • vimeo
  • instagram
  • slideshare
  • wistiar
  • vidyard
  • brightcove

This list may change, so use the GetHubServices method to get the latest list of services we support.

Examples

Sample response:

<Response>
    <HubItem>
        <id>123456</id>
        <created>2014-05-16 10:05:01</created>
        <modified>2014-05-28 10:41:34</modified>
        <external_created>1399478445</external_created>
        <external_modified>1400273347</external_modified>
        <type>blogpost</type>
        <title>Marketing Science</title>
        <description>Scientists agree Hubs are the way to spread your message! Read more...</description>
        <thumbnail_url>http://cdn.publishingdomain.com/img.jpg</thumbnail_url>
        <latest_score>0.4</latest_score>
        <mediaproxy_thumbnail_url>http://cdn.publishingdomain.com/mediaproxy?url=....</mediaproxy_thumbnail_url>
        <featured>0</featured>
        <hidden>0</hidden>
        <edited>1</edited>
        <deleted>0</deleted>
        <url>http://www.publishingdomain.com/h/i/123456-marketing-science</url>
    </HubItem>
    ...
    <Pagination>
            <TotalResults>33</TotalResults>
            <TotalPages>4</TotalPages>
            <Page>1</Page>
    </Pagination>
</Response>