Tagboard Support

API Instructions

Featured Posts

Parameters

Parameter
Type
Default
Description

format

string

  • xml
  • json
  • rss
  • atom

json

Declares the format of the payload.

count

number

  • 1-100

50

Limits the amount of returned posts.

post_type

string

  • photo
  • video
  • text
  • all

all

Limits the payload to only the declared post types.

network

string

  • twitter
  • facebook
  • instagram
  • googleplus
  • vine
  • flickr
  • youtube

none

Limits the payload to only the declared social networks

before

string

none

Token used for backward paging (getting older posts).
Supported in JSON and XML only

since

string

none

Token used for forward paging (getting newer posts).
Supported in JSON and XML only

{tagboard_id}

Your tagboard_id can be found in the URL for your tagboard.
For example https://tagboard.com/WhyWorkAtTagboard/**146433**

HTTP/1.1 200 OK
Server: Cowboy
Connection: close
Limit-Window: 60
Limit-Requests: 1
Limit-Remaining: 14
Vary: origin
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
Content-Length: 6178
Accept-Ranges: bytes
Date: Wed, 24 Feb 2016 21:38:27 GMT
Via: 1.1 vegur
HTTP/1.1 200 OK
content-type: application/xml
limit-window: 60
limit-requests: 2
limit-remaining: 13
vary: origin
cache-control: no-cache
content-length: 7490
accept-ranges: bytes
Date: Wed, 24 Feb 2016 23:14:47 GMT
Connection: close
{
  "tagboard": {
    "hashtag": "WhyWorkAtTagboard",
    "description": "Just some of the reasons to work at Tagboard... One of Seattle's hottest startups. ",
    "avatar": "https://avatars.tagboard.com/146433/146433_1385162936621_avatar.png",
    "cover": "https://covers.tagboard.com/146433/146433_1385162937384_cover.png"
  },
  "posts": [
    {
      "network": "twitter",
      "text": "πŸ” + 🍟 + πŸ“Ί #whyworkattagboard @ZPeggins https://t.co/UGJlkeVKSg",
      "html": "πŸ” + 🍟 + πŸ“Ί <a href=\"/whyworkattagboard\" title=\"#whyworkattagboard\" class=\"hashtag\" rel=\"nofollow\">#whyworkattagboard</a> @<a class=\"mention\" href=\"https://twitter.com/ZPeggins\" data-screen-name=\"ZPeggins\" rel=\"nofollow\">ZPeggins</a> <a href=\"https://t.co/UGJlkeVKSg\" title=\"http://twitter.com/chaylubb/status/701892779933200384/photo/1\" rel=\"nofollow\">pic.twitter.com/UGJlkeVKSg</a>",
      "permalink": "https://twitter.com/chaylubb/status/701892779933200384",
      "post_id": "701892779933200384",
      "post_time": 1456179253,
      "user_id": "393069078",
      "user_name": "chaylubb",
      "user_real_name": "Caleb Thompson",
      "user_profile_image_url": "https://pbs.twimg.com/profile_images/669685652926038016/lFnLJsVX_normal.jpg",
      "hashtags": [
        "whyworkattagboard"
      ],
      "service_meta": {},
      "photos": [
        {
          "a": 0.75,
          "s": "https://pbs.twimg.com/media/Cb2fwg_VAAAaS-V.jpg:thumb",
          "m": "https://pbs.twimg.com/media/Cb2fwg_VAAAaS-V.jpg:medium",
          "l": "https://pbs.twimg.com/media/Cb2fwg_VAAAaS-V.jpg:large"
        }
      ],
      "curated_time": 1456179335063
    },
    {
      "network": "instagram",
      "text": "Work hard play hard!!! #whyworkattagboard #tokyo #japan",
      "html": "Work hard play hard!!! <a href=\"/whyworkattagboard\" title=\"#whyworkattagboard\" class=\"hashtag\" rel=\"nofollow\">#whyworkattagboard</a> <a href=\"/tokyo\" title=\"#tokyo\" class=\"hashtag\" rel=\"nofollow\">#tokyo</a> <a href=\"/japan\" title=\"#japan\" class=\"hashtag\" rel=\"nofollow\">#japan</a>",
      "permalink": "https://www.instagram.com/p/BCFvI-pKAJd/",
      "post_id": "1190565001713680989_418827559",
      "post_time": 1456146429,
      "user_id": "418827559",
      "user_name": "jamesdudulin",
      "user_real_name": "#JamesLin",
      "user_profile_image_url": "//scontent.cdninstagram.com/t51.2885-19/11324968_891684007535597_217260901_a.jpg",
      "hashtags": [
        "japan",
        "tokyo",
        "whyworkattagboard"
      ],
      "service_meta": {
        "likes": 5
      },
      "photos": [
        {
          "s": "//scontent.cdninstagram.com/t51.2885-15/s150x150/e35/c135.0.810.810/12502060_1045681715520911_2090978653_n.jpg?ig_cache_key=MTE5MDU2NTAwMTcxMzY4MDk4OQ%3D%3D.2.c",
          "m": "//scontent.cdninstagram.com/t51.2885-15/s320x320/e35/12717035_495449667308298_660605817_n.jpg?ig_cache_key=MTE5MDU2NTAwMTcxMzY4MDk4OQ%3D%3D.2.l",
          "l": "//scontent.cdninstagram.com/t51.2885-15/s640x640/sh0.08/e35/12717035_495449667308298_660605817_n.jpg?ig_cache_key=MTE5MDU2NTAwMTcxMzY4MDk4OQ%3D%3D.2.l"
        }
      ],
      "location": {
        "type": "Point",
        "coordinates": [
          139.706,
          35.6906
        ],
        "place_name": "Shinjuku-ku, Tokyo, Japan",
        "place_id": 215688849
      },
      "curated_time": 1456170622497
    }
  ],
  "meta": {
    "count": 2,
    "since": "f8cc57a4270a9f6fdadcfd612591390ddc6a384713ffd6434337e9",
    "before": "f8cc57ab294d862cdadafc692d9d3d0f0a6facf709678ef3df69962d0f03605e095b88215423"
  }
}
<?xml version="1.0"?>
<tagboard>
    <hashtag>
        <![CDATA[WhyWorkAtTagboard]]>
  
    </hashtag>
    <description>
        <![CDATA[Just some of the reasons to work at Tagboard... One of Seattle's hottest startups. ]]>
  
    </description>
    <avatar>https://avatars.tagboard.com/146433/146433_1385162936621_avatar.png</avatar>
    <cover>https://covers.tagboard.com/146433/146433_1385162937384_cover.png</cover>
    <meta>
        <count>2</count>
        <since>f8cc57a4270a9f6fdadcfd612591390ddc6a384713ffd6434337e9</since>
        <before>f8cc57ab294d862cdadafc692d9d3d0f0a6facf709678ef3df69962d0f03605e095b88215423</before>
  
    </meta>
    <posts type="array">
        <post>
            <network>twitter</network>
            <post_id>701892779933200384</post_id>
            <post_time>Mon Feb 22 22:14:13 +0000 2016</post_time>
            <curated_time>Mon Feb 22 22:15:35 +0000 2016</curated_time>
            <permalink>
                <![CDATA[https://twitter.com/chaylubb/status/701892779933200384]]>
      
            </permalink>
            <text>πŸ” + 🍟 + πŸ“Ί #whyworkattagboard @ZPeggins https://t.co/UGJlkeVKSg</text>
            <user_id>393069078</user_id>
            <user_name>
                <![CDATA[chaylubb]]>
      
            </user_name>
            <user_real_name>Caleb Thompson</user_real_name>
            <user_profile_image_url>
                <![CDATA[https://pbs.twimg.com/profile_images/669685652926038016/lFnLJsVX_normal.jpg]]>
      
            </user_profile_image_url>
            <photos type="array">
                <photo_url>
                    <![CDATA[https://pbs.twimg.com/media/Cb2fwg_VAAAaS-V.jpg:large]]>
        
                </photo_url>
      
            </photos>
    
        </post>
        <post>
            <network>instagram</network>
            <post_id>1190565001713680989_418827559</post_id>
            <post_time>Mon Feb 22 13:07:09 +0000 2016</post_time>
            <curated_time>Mon Feb 22 19:50:22 +0000 2016</curated_time>
            <permalink>
                <![CDATA[https://www.instagram.com/p/BCFvI-pKAJd/]]>
      
            </permalink>
            <text>Work hard play hard!!! #whyworkattagboard #tokyo #japan</text>
            <user_id>418827559</user_id>
            <user_name>
                <![CDATA[jamesdudulin]]>
      
            </user_name>
            <user_real_name>#JamesLin</user_real_name>
            <user_profile_image_url>
                <![CDATA[//scontent.cdninstagram.com/t51.2885-19/11324968_891684007535597_217260901_a.jpg]]>
      
            </user_profile_image_url>
            <photos type="array">
                <photo_url>
                    <![CDATA[//scontent.cdninstagram.com/t51.2885-15/s640x640/sh0.08/e35/12717035_495449667308298_660605817_n.jpg?ig_cache_key=MTE5MDU2NTAwMTcxMzY4MDk4OQ%3D%3D.2.l]]>
        
                </photo_url>
      
            </photos>
    
        </post>
  
    </posts>
</tagboard>
<?xml version="1.0"?>
<rss version="2.0" xmlns:tgb="https://api.tagboard.com/dtd/tagboard/post">
    <channel>
        <title>
            <![CDATA[WhyWorkAtTagboard]]>
    
        </title>
        <description>
            <![CDATA[Just some of the reasons to work at Tagboard... One of Seattle's hottest startups. ]]>
    
        </description>
        <link>
            <![CDATA[http://www.tagboard.com]]>
    
        </link>
        <lastBuildDate>Mon, 29 Feb 2016 18:26:07 +0000</lastBuildDate>
        <item>
            <guid isPermaLink="false">701892779933200384</guid>
            <description>πŸ” + 🍟 + πŸ“Ί #whyworkattagboard @ZPeggins https://t.co/UGJlkeVKSg</description>
            <tgb:post>
                <tgb:network>twitter</tgb:network>
                <tgb:post_id>701892779933200384</tgb:post_id>
                <tgb:post_time>Mon Feb 22 22:14:13 +0000 2016</tgb:post_time>
                <tgb:curated_time>Mon Feb 22 22:15:35 +0000 2016</tgb:curated_time>
                <tgb:permalink>
                    <![CDATA[https://twitter.com/chaylubb/status/701892779933200384]]>
        
                </tgb:permalink>
                <tgb:text>πŸ” + 🍟 + πŸ“Ί #whyworkattagboard @ZPeggins https://t.co/UGJlkeVKSg</tgb:text>
                <tgb:user_id>393069078</tgb:user_id>
                <tgb:user_name>
                    <![CDATA[chaylubb]]>
        
                </tgb:user_name>
                <tgb:user_real_name>Caleb Thompson</tgb:user_real_name>
                <tgb:user_profile_image_url>
                    <![CDATA[https://pbs.twimg.com/profile_images/669685652926038016/lFnLJsVX_normal.jpg]]>
        
                </tgb:user_profile_image_url>
                <tgb:photos type="array">
                    <tgb:photo_url>
                        <![CDATA[https://pbs.twimg.com/media/Cb2fwg_VAAAaS-V.jpg:large]]>
          
                    </tgb:photo_url>
        
                </tgb:photos>
      
            </tgb:post>
    
        </item>
        <item>
            <guid isPermaLink="false">1190565001713680989_418827559</guid>
            <description>Work hard play hard!!! #whyworkattagboard #tokyo #japan</description>
            <tgb:post>
                <tgb:network>instagram</tgb:network>
                <tgb:post_id>1190565001713680989_418827559</tgb:post_id>
                <tgb:post_time>Mon Feb 22 13:07:09 +0000 2016</tgb:post_time>
                <tgb:curated_time>Mon Feb 22 19:50:22 +0000 2016</tgb:curated_time>
                <tgb:permalink>
                    <![CDATA[https://www.instagram.com/p/BCFvI-pKAJd/]]>
        
                </tgb:permalink>
                <tgb:text>Work hard play hard!!! #whyworkattagboard #tokyo #japan</tgb:text>
                <tgb:user_id>418827559</tgb:user_id>
                <tgb:user_name>
                    <![CDATA[jamesdudulin]]>
        
                </tgb:user_name>
                <tgb:user_real_name>#JamesLin</tgb:user_real_name>
                <tgb:user_profile_image_url>
                    <![CDATA[//scontent.cdninstagram.com/t51.2885-19/11324968_891684007535597_217260901_a.jpg]]>
        
                </tgb:user_profile_image_url>
                <tgb:photos type="array">
                    <tgb:photo_url>
                        <![CDATA[//scontent.cdninstagram.com/t51.2885-15/s640x640/sh0.08/e35/12717035_495449667308298_660605817_n.jpg?ig_cache_key=MTE5MDU2NTAwMTcxMzY4MDk4OQ%3D%3D.2.l]]>
          
                    </tgb:photo_url>
        
                </tgb:photos>
      
            </tgb:post>
    
        </item>
  
    </channel>
</rss>
<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:tgb="https://api.tagboard.com/dtd/tagboard/post">
    <title>
        <![CDATA[WhyWorkAtTagboard]]>
  
    </title>
    <subtitle>
        <![CDATA[Just some of the reasons to work at Tagboard... One of Seattle's hottest startups. ]]>
  
    </subtitle>
    <link href="http://www.tagboard.com"/>
    <updated>2016-02-29T18:25:54+00:00</updated>
    <id>http://www.tagboard.com/whyworkattagboard/146433</id>
    <entry>
        <id>https://twitter.com/chaylubb/status/701892779933200384</id>
        <title>πŸ” + 🍟 + πŸ“Ί #whyworkattagboard @ZPeggins https://t.co/UGJlkeVKSg</title>
        <updated>2016-02-29T18:25:54+00:00</updated>
        <author>
            <name>
                <![CDATA[chaylubb]]>
      
            </name>
    
        </author>
        <link href="https://twitter.com/chaylubb/status/701892779933200384"/>
        <tgb:post>
            <tgb:network>twitter</tgb:network>
            <tgb:post_id>701892779933200384</tgb:post_id>
            <tgb:post_time>Mon Feb 22 22:14:13 +0000 2016</tgb:post_time>
            <tgb:curated_time>Mon Feb 22 22:15:35 +0000 2016</tgb:curated_time>
            <tgb:permalink>
                <![CDATA[https://twitter.com/chaylubb/status/701892779933200384]]>
      
            </tgb:permalink>
            <tgb:text>πŸ” + 🍟 + πŸ“Ί #whyworkattagboard @ZPeggins https://t.co/UGJlkeVKSg</tgb:text>
            <tgb:user_id>393069078</tgb:user_id>
            <tgb:user_name>
                <![CDATA[chaylubb]]>
      
            </tgb:user_name>
            <tgb:user_real_name>Caleb Thompson</tgb:user_real_name>
            <tgb:user_profile_image_url>
                <![CDATA[https://pbs.twimg.com/profile_images/669685652926038016/lFnLJsVX_normal.jpg]]>
      
            </tgb:user_profile_image_url>
            <tgb:photos type="array">
                <tgb:photo_url>
                    <![CDATA[https://pbs.twimg.com/media/Cb2fwg_VAAAaS-V.jpg:large]]>
        
                </tgb:photo_url>
      
            </tgb:photos>
    
        </tgb:post>
  
    </entry>
    <entry>
        <id>https://www.instagram.com/p/BCFvI-pKAJd/</id>
        <title>Work hard play hard!!! #whyworkattagboard #tokyo #japan</title>
        <updated>2016-02-29T18:25:54+00:00</updated>
        <author>
            <name>
                <![CDATA[jamesdudulin]]>
      
            </name>
    
        </author>
        <link href="https://www.instagram.com/p/BCFvI-pKAJd/"/>
        <tgb:post>
            <tgb:network>instagram</tgb:network>
            <tgb:post_id>1190565001713680989_418827559</tgb:post_id>
            <tgb:post_time>Mon Feb 22 13:07:09 +0000 2016</tgb:post_time>
            <tgb:curated_time>Mon Feb 22 19:50:22 +0000 2016</tgb:curated_time>
            <tgb:permalink>
                <![CDATA[https://www.instagram.com/p/BCFvI-pKAJd/]]>
      
            </tgb:permalink>
            <tgb:text>Work hard play hard!!! #whyworkattagboard #tokyo #japan</tgb:text>
            <tgb:user_id>418827559</tgb:user_id>
            <tgb:user_name>
                <![CDATA[jamesdudulin]]>
      
            </tgb:user_name>
            <tgb:user_real_name>#JamesLin</tgb:user_real_name>
            <tgb:user_profile_image_url>
                <![CDATA[//scontent.cdninstagram.com/t51.2885-19/11324968_891684007535597_217260901_a.jpg]]>
      
            </tgb:user_profile_image_url>
            <tgb:photos type="array">
                <tgb:photo_url>
                    <![CDATA[//scontent.cdninstagram.com/t51.2885-15/s640x640/sh0.08/e35/12717035_495449667308298_660605817_n.jpg?ig_cache_key=MTE5MDU2NTAwMTcxMzY4MDk4OQ%3D%3D.2.l]]>
        
                </tgb:photo_url>
      
            </tgb:photos>
    
        </tgb:post>
  
    </entry>
</feed>

Deleted Posts

Parameters

Parameter
Type
Default
Description

format

json, xml

json

Declares the format of the payload.

since

number

none

Epoch time-based token used for forward paging (getting newer posts).

HTTP/1.1 200 OK
Server: Cowboy
Connection: close
Vary: origin
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
Content-Length: 93
Accept-Ranges: bytes
Date: Wed, 24 Feb 2016 22:06:38 GMT
Via: 1.1 vegur
HTTP/1.1 200 OK
content-type: application/xml
limit-window: 60
limit-requests: 2
limit-remaining: 13
vary: origin
cache-control: no-cache
content-length: 7490
accept-ranges: bytes
Date: Wed, 24 Feb 2016 23:14:47 GMT
Connection: close
{
  "tagboard": {
    "hashtag": "beer"
  },
  "posts": [
    {
      "network": "facebook",
      "post_id": "1041324785909016_1041481395893355",
      "last_updated": 1456860543583
    },
    {
      "network": "facebook",
      "post_id": "1041324785909016_1041404645901030",
      "last_updated": 1456859524719
    },
    {
      "network": "twitter",
      "post_id": "702514195628232704",
      "last_updated": 1456410347938
    }
  ],
  "meta": {
    "count": 3,
    "since": 1456860543583
  }
}
<?xml version="1.0"?>
<tagboard>
    <hashtag>
        <![CDATA[beer]]>
  
    </hashtag>
    <meta>
    <count>3</count>
    <since>1456860543583</since>
  
    </meta>
    <posts type="array">
        <post>
            <network>facebook</network>
            <post_id>1041324785909016_1041481395893355</post_id>
            <last_updated>Fri Jan 27 20:19:43 +0000 48136</last_updated>
    
        </post>
        <post>
            <network>facebook</network>
            <post_id>1041324785909016_1041404645901030</post_id>
            <last_updated>Mon Jan 16 01:18:39 +0000 48136</last_updated>
    
        </post>
        <post>
            <network>twitter</network>
            <post_id>702514195628232704</post_id>
            <last_updated>Wed Oct 22 05:58:58 +0000 48121</last_updated>
    
        </post>
    </posts>
</tagboard>

API Instructions