Widget API Docs

GET
https://api.taggbox.com/api/v2/widget/wallInfo/233?user_key=605b54dfbed1d7bdad7fce307e135a12&format=json
Parameters
wallId put wall id. (Example: 233)
user_key A valid user-key. (Example: 605b54dfbed1d7bdad7fce307e135a12) How to get user_key
format {json} or {xml}
Responses
200
application/json application/xml 
{
    "responseCode": 200,
    "responseStatus": "success",
    "responseData": [
        {
            "wallId": 233,
            "wallName": "natgeoapi",
            "wallUrl": "natgeoapi",
            "wallProfanity": 0,
            "wallCreatedAt": "2018-05-29T18:57:29.000Z",
            "feeds": [
                {
                    "feedId": 26659,
                    "feedName": "natgeolive",
                    "source": "Twitter",
                    "sourceType": "Hashtag(#)",
                    "feedCreatedAt": "03/08/2018",
                    "feedUpdatedAt": "24/08/2021"
                },
                {
                    "feedId": 55199,
                    "feedName": "National Geographic",
                    "source": "Facebook",
                    "sourceType": "Page",
                    "feedCreatedAt": "30/07/2019",
                    "feedUpdatedAt": "24/08/2021"
                }
            ]
        }
    ]
}
<?xml version='1.0'?>
<xml>
<responseCode>200</responseCode>
<responseStatus>success</responseStatus>
<responseData>
<wallId>233</wallId>
<wallName>natgeoapi</wallName>
<wallUrl>natgeoapi</wallUrl>
<wallProfanity>0</wallProfanity>
<wallCreatedAt>2018-05-29T18:57:29.000Z</wallCreatedAt>
<feeds>
<feedId>26659</feedId>
<feedName>natgeolive</feedName>
<source>Twitter</source>
<sourceType>Hashtag(#)</sourceType>
<feedCreatedAt>03/08/2018</feedCreatedAt>
<feedUpdatedAt>24/08/2021</feedUpdatedAt>
</feeds>
<feeds>
<feedId>55199</feedId>
<feedName>National Geographic</feedName>
<source>Facebook</source>
<sourceType>Page</sourceType>
<feedCreatedAt>30/07/2019</feedCreatedAt>
<feedUpdatedAt>24/08/2021</feedUpdatedAt>
</feeds>
</responseData>
</xml>
401
application/json application/xml 
{
    "responseCode": 401,
    "responseStatus": "error",
    "responseMessage": "API is not available in this plan OR Wrong user key!"
}
<?xml version='1.0'?>
<xml>
<responseStatus>error</responseStatus>
<responseMessage>API is not available in this plan OR Wrong user key!</responseMessage>
<responseCode>401</responseCode>
</xml>

GET
https://api.taggbox.com/api/v2/widget/posts/233?user_key=605b54dfbed1d7bdad7fce307e135a12&offset=0&limit=100&date_from=10/08/2021&include_only_video_posts=false&include_only_text_posts=false&include_only_image_posts=false&format=json
Parameters
wallId put wall id. (Example: 233)
user_key A valid user-key. (Example: 605b54dfbed1d7bdad7fce307e135a12) How to get user_key
limit Number of posts to return in response {Max : 500}, {Default : 100}. API call limit {1000/Day}
offset get posts starting from post
date_from Include posts that were posted after mentioned date (Example:10/08/2021)
include_only_image_posts {true} to get posts with image media. Default is {false}
include_only_video_posts {true} to get posts with video. Default is {false}
include_only_text_posts {true} to get text only posts. Default is {false}
Responses
200
application/json application/xml 
{
    "responseCode": 200,
    "responseStatus": "success",
    "responseData": [
        {
            "wall": {
                "wallName": "natgeoapi",
                "wallUrl": "natgeoapi",
                "wallProfanity": 0,
                "wallCreatedAt": "2018-05-29T18:57:29.000Z"
            },
            "posts": [
                {
                    "feedId": 55199,
                    "feedName": "National Geographic",
                    "postPicture": "https://scontent.xx.fbcdn.net/v/t15.5256-10/s720x720/24510509_10155257598143951_6987739652597743616_n.jpg?_nc_cat=100&_nc_oc=AQnar6R0_-TVfuIkGCBrKTBpG1hoPyKuTzfDNw6e-gUJdznyCLvfEIIzv7ypfYPJL18&_nc_ht=scontent.xx&oh=4827bfef1dc3e0b14f96a08d4ceadc49&oe=5DE7DB3A",
                    "wallProfanity": 0,
                    "networkName": "Facebook",
                    "postId": "10156600632208951",
                    "content": "We'll be watching these baby elephants on repeat until the end of time.",
                    "postFile": "https://scontent.xx.fbcdn.net/v/t15.5256-10/s720x720/24510509_10155257598143951_6987739652597743616_n.jpg?_nc_cat=100&_nc_oc=AQnar6R0_-TVfuIkGCBrKTBpG1hoPyKuTzfDNw6e-gUJdznyCLvfEIIzv7ypfYPJL18&_nc_ht=scontent.xx&oh=4827bfef1dc3e0b14f96a08d4ceadc49&oe=5DE7DB3A",
                    "postFileOriginal": "",
                    "postFileThumb": "",
                    "postMediaFile": "",
                    "rating": null,
                    "postPin": 0,
                    "postCreatedAt": "30/07/2019",
                    "postUpdatedAt": "02/08/2019",
                    "postTags": "",
                    "location": "",
                    "postLinkUrl": "https://www.facebook.com/natgeo/videos/10156600632163951/",
                    "postAuthorName": "National Geographic",
                    "postUsername": "National Geographic",
                    "postUserPicture": "https://scontent.xx.fbcdn.net/v/t1.0-1/p50x50/46173038_10156035001398951_8581620115135528960_n.jpg?_nc_cat=1&_nc_oc=AQnH0p0eiMe3ZRTUYtj4W6iTt736d9ecWQOizifDdpYqrxMcwCftos6NgtoNbZaxsNM&_nc_ht=scontent.xx&oh=3c3be68b9f1adc17b00f0f90b0aa31bb&oe=5DE0FBA4",
                    "PostType": 4,
                    "postHighlight": 0,
                    "CTAcolor": null,
                    "CTAbackground": null,
                    "CTAStatus": null,
                    "CTAurl": null,
                    "CTAtext": null,
                    "childNode": [
                        {
                           "image": "https://cloud.taggbox.com/instagram/76563/79749/150012/image_5-1639473191.jpg",
                           "video": ""
                        },
                        {
                           "image": "https://cloud.taggbox.com/instagram/76563/79749/150012/image_6-1639473192.jpg",
                           "video": ""
                        }
                     ]
                },
                {
                    "feedId": 55199,
                    "feedName": "National Geographic",
                    "postPicture": "https://scontent.xx.fbcdn.net/v/t15.5256-10/s720x720/65918471_399603713991223_6284894711605886976_n.jpg?_nc_cat=106&_nc_oc=AQmxR8K30iu610DfZanTFT-6nsOlHtsdwdharKn9gHR2q0xMZrKYvqL8nOUCbxEiq6Y&_nc_ht=scontent.xx&oh=935edf6b7117eaf2fc073561776de0fb&oe=5DE55412",
                    "wallProfanity": 0,
                    "networkName": "Facebook",
                    "postId": "10156606382148951",
                    "content": "When a softshell turtle decides to lay her eggs, she faces an unwelcome guest.",
                    "postFile": "https://scontent.xx.fbcdn.net/v/t15.5256-10/s720x720/65918471_399603713991223_6284894711605886976_n.jpg?_nc_cat=106&_nc_oc=AQmxR8K30iu610DfZanTFT-6nsOlHtsdwdharKn9gHR2q0xMZrKYvqL8nOUCbxEiq6Y&_nc_ht=scontent.xx&oh=935edf6b7117eaf2fc073561776de0fb&oe=5DE55412",
                    "postFileOriginal": "",
                    "postFileThumb": "",
                    "postMediaFile": "",
                    "rating": null,
                    "postPin": 0,
                    "postCreatedAt": "30/07/2019",
                    "postUpdatedAt": "02/08/2019",
                    "postTags": "",
                    "location": "",
                    "postLinkUrl": "https://www.facebook.com/natgeo/videos/399602287324699/",
                    "postAuthorName": "National Geographic",
                    "postUsername": "National Geographic",
                    "postUserPicture": "https://scontent.xx.fbcdn.net/v/t1.0-1/p50x50/46173038_10156035001398951_8581620115135528960_n.jpg?_nc_cat=1&_nc_oc=AQnH0p0eiMe3ZRTUYtj4W6iTt736d9ecWQOizifDdpYqrxMcwCftos6NgtoNbZaxsNM&_nc_ht=scontent.xx&oh=3c3be68b9f1adc17b00f0f90b0aa31bb&oe=5DE0FBA4",
                    "PostType": 4,
                    "postHighlight": 0,
                    "CTAcolor": null,
                    "CTAbackground": null,
                    "CTAStatus": null,
                    "CTAurl": null,
                    "CTAtext": null,
                    "childNode": [
                        {
                           "image": "https://cloud.taggbox.com/instagram/76563/79749/150012/image_5-1639473191.jpg",
                           "video": ""
                        },
                        {
                           "image": "https://cloud.taggbox.com/instagram/76563/79749/150012/image_6-1639473192.jpg",
                           "video": ""
                        }
                     ]
                },
                {
                    "feedId": 55199,
                    "feedName": "National Geographic",
                    "postPicture": "https://external.xx.fbcdn.net/safe_image.php?d=AQBXjB0zirvrExB0&w=720&h=720&url=https%3A%2F%2Fwww.nationalgeographic.com%2Fcontent%2Fdam%2Fcultureexploration%2F2019%2F05%2Fguatemala-deportees%2F10-guatemala-deportees.ngsversion.1564151473562.adapt.1900.1.jpg&cfs=1&_nc_hash=AQCyyFxLjS_wueFj",
                    "wallProfanity": 0,
                    "networkName": "Facebook",
                    "postId": "10156610657683951",
                    "content": "\"It’s not that Guatemala is poor. It’s that money is in a few hands. What really exists here is inequality.\"",
                    "postFile": "https://external.xx.fbcdn.net/safe_image.php?d=AQBXjB0zirvrExB0&w=720&h=720&url=https%3A%2F%2Fwww.nationalgeographic.com%2Fcontent%2Fdam%2Fcultureexploration%2F2019%2F05%2Fguatemala-deportees%2F10-guatemala-deportees.ngsversion.1564151473562.adapt.1900.1.jpg&cfs=1&_nc_hash=AQCyyFxLjS_wueFj",
                    "postFileOriginal": "",
                    "postFileThumb": "",
                    "postMediaFile": "",
                    "rating": null,
                    "postPin": 0,
                    "postCreatedAt": "30/07/2019",
                    "postUpdatedAt": "30/07/2019",
                    "postTags": "",
                    "location": "",
                    "postLinkUrl": "https://on.natgeo.com/2SGL3UA",
                    "postAuthorName": "National Geographic",
                    "postUsername": "National Geographic",
                    "postUserPicture": "https://scontent.xx.fbcdn.net/v/t1.0-1/p50x50/46173038_10156035001398951_8581620115135528960_n.jpg?_nc_cat=1&_nc_oc=AQnH0p0eiMe3ZRTUYtj4W6iTt736d9ecWQOizifDdpYqrxMcwCftos6NgtoNbZaxsNM&_nc_ht=scontent.xx&oh=3c3be68b9f1adc17b00f0f90b0aa31bb&oe=5DE0FBA4",
                    "PostType": 4,
                    "postHighlight": 0,
                    "CTAcolor": null,
                    "CTAbackground": null,
                    "CTAStatus": null,
                    "CTAurl": null,
                    "CTAtext": null,
                    "childNode": [
                        {
                           "image": "https://cloud.taggbox.com/instagram/76563/79749/150012/image_5-1639473191.jpg",
                           "video": ""
                        },
                        {
                           "image": "https://cloud.taggbox.com/instagram/76563/79749/150012/image_6-1639473192.jpg",
                           "video": ""
                        }
                     ]
                }
            ]
        }
    ]
}
<?xml version='1.0'?>
<xml>
<responseCode>200</responseCode>
<responseStatus>success</responseStatus>
<responseData>
<wall>
<wallName>natgeoapi</wallName>
<wallUrl>natgeoapi</wallUrl>
<wallProfanity>0</wallProfanity>
<wallCreatedAt>Tue May 29 2018 18:57:29 GMT+0000 (Coordinated Universal Time)</wallCreatedAt>
</wall>
<posts>
<feedId>55199</feedId>
<feedName>National Geographic</feedName>
<postPicture>https://scontent.xx.fbcdn.net/v/t15.5256-10/s720x720/24510509_10155257598143951_6987739652597743616_n.jpg?_nc_cat=100&_nc_oc=AQnar6R0_-TVfuIkGCBrKTBpG1hoPyKuTzfDNw6e-gUJdznyCLvfEIIzv7ypfYPJL18&_nc_ht=scontent.xx&oh=4827bfef1dc3e0b14f96a08d4ceadc49&oe=5DE7DB3A</postPicture>
<wallProfanity>0</wallProfanity>
<networkName>Facebook</networkName>
<postId>10156600632208951</postId>
<content>We'll be watching these baby elephants on repeat until the end of time.</content>
<postFile>https://scontent.xx.fbcdn.net/v/t15.5256-10/s720x720/24510509_10155257598143951_6987739652597743616_n.jpg?_nc_cat=100&_nc_oc=AQnar6R0_-TVfuIkGCBrKTBpG1hoPyKuTzfDNw6e-gUJdznyCLvfEIIzv7ypfYPJL18&_nc_ht=scontent.xx&oh=4827bfef1dc3e0b14f96a08d4ceadc49&oe=5DE7DB3A</postFile>
<postFileOriginal/>
<postFileThumb/>
<postMediaFile/>
<rating>null</rating>
<postPin>0</postPin>
<postCreatedAt>30/07/2019</postCreatedAt>
<postUpdatedAt>02/08/2019</postUpdatedAt>
<postTags/>
<location/>
<postLinkUrl>https://www.facebook.com/natgeo/videos/10156600632163951/</postLinkUrl>
<postAuthorName>National Geographic</postAuthorName>
<postUsername>National Geographic</postUsername>
<postUserPicture>https://scontent.xx.fbcdn.net/v/t1.0-1/p50x50/46173038_10156035001398951_8581620115135528960_n.jpg?_nc_cat=1&_nc_oc=AQnH0p0eiMe3ZRTUYtj4W6iTt736d9ecWQOizifDdpYqrxMcwCftos6NgtoNbZaxsNM&_nc_ht=scontent.xx&oh=3c3be68b9f1adc17b00f0f90b0aa31bb&oe=5DE0FBA4</postUserPicture>
<PostType>4</PostType>
<postHighlight>0</postHighlight>
<CTAcolor>null</CTAcolor>
<CTAbackground>null</CTAbackground>
<CTAStatus>null</CTAStatus>
<CTAurl>null</CTAurl>
<CTAtext>null</CTAtext>
<childNode>
<image>https://cloud.taggbox.com/instagram/76563/79749/150012/image_5-1639473191.jpg</image>
<video></video>
<image>https://cloud.taggbox.com/instagram/76563/79749/150012/image_5-1639473191.jpg</image>
<video></video>
</childNode>
</posts>
<posts>
<feedId>55199</feedId>
<feedName>National Geographic</feedName>
<postPicture>https://scontent.xx.fbcdn.net/v/t15.5256-10/s720x720/65918471_399603713991223_6284894711605886976_n.jpg?_nc_cat=106&_nc_oc=AQmxR8K30iu610DfZanTFT-6nsOlHtsdwdharKn9gHR2q0xMZrKYvqL8nOUCbxEiq6Y&_nc_ht=scontent.xx&oh=935edf6b7117eaf2fc073561776de0fb&oe=5DE55412</postPicture>
<wallProfanity>0</wallProfanity>
<networkName>Facebook</networkName>
<postId>10156606382148951</postId>
<content>When a softshell turtle decides to lay her eggs, she faces an unwelcome guest.</content>
<postFile>https://scontent.xx.fbcdn.net/v/t15.5256-10/s720x720/65918471_399603713991223_6284894711605886976_n.jpg?_nc_cat=106&_nc_oc=AQmxR8K30iu610DfZanTFT-6nsOlHtsdwdharKn9gHR2q0xMZrKYvqL8nOUCbxEiq6Y&_nc_ht=scontent.xx&oh=935edf6b7117eaf2fc073561776de0fb&oe=5DE55412</postFile>
<postFileOriginal/>
<postFileThumb/>
<postMediaFile/>
<rating>null</rating>
<postPin>0</postPin>
<postCreatedAt>30/07/2019</postCreatedAt>
<postUpdatedAt>02/08/2019</postUpdatedAt>
<postTags/>
<location/>
<postLinkUrl>https://www.facebook.com/natgeo/videos/399602287324699/</postLinkUrl>
<postAuthorName>National Geographic</postAuthorName>
<postUsername>National Geographic</postUsername>
<postUserPicture>https://scontent.xx.fbcdn.net/v/t1.0-1/p50x50/46173038_10156035001398951_8581620115135528960_n.jpg?_nc_cat=1&_nc_oc=AQnH0p0eiMe3ZRTUYtj4W6iTt736d9ecWQOizifDdpYqrxMcwCftos6NgtoNbZaxsNM&_nc_ht=scontent.xx&oh=3c3be68b9f1adc17b00f0f90b0aa31bb&oe=5DE0FBA4</postUserPicture>
<PostType>4</PostType>
<postHighlight>0</postHighlight>
<CTAcolor>null</CTAcolor>
<CTAbackground>null</CTAbackground>
<CTAStatus>null</CTAStatus>
<CTAurl>null</CTAurl>
<CTAtext>null</CTAtext>
<childNode>
<image>https://cloud.taggbox.com/instagram/76563/79749/150012/image_5-1639473191.jpg</image>
<video></video>
<image>https://cloud.taggbox.com/instagram/76563/79749/150012/image_5-1639473191.jpg</image>
<video></video>
</childNode>
</posts>
<posts>
<feedId>55199</feedId>
<feedName>National Geographic</feedName>
<postPicture>https://external.xx.fbcdn.net/safe_image.php?d=AQBXjB0zirvrExB0&w=720&h=720&url=https%3A%2F%2Fwww.nationalgeographic.com%2Fcontent%2Fdam%2Fcultureexploration%2F2019%2F05%2Fguatemala-deportees%2F10-guatemala-deportees.ngsversion.1564151473562.adapt.1900.1.jpg&cfs=1&_nc_hash=AQCyyFxLjS_wueFj</postPicture>
<wallProfanity>0</wallProfanity>
<networkName>Facebook</networkName>
<postId>10156610657683951</postId>
<content>"It’s not that Guatemala is poor. It’s that money is in a few hands. What really exists here is inequality."</content>
<postFile>https://external.xx.fbcdn.net/safe_image.php?d=AQBXjB0zirvrExB0&w=720&h=720&url=https%3A%2F%2Fwww.nationalgeographic.com%2Fcontent%2Fdam%2Fcultureexploration%2F2019%2F05%2Fguatemala-deportees%2F10-guatemala-deportees.ngsversion.1564151473562.adapt.1900.1.jpg&cfs=1&_nc_hash=AQCyyFxLjS_wueFj</postFile>
<postFileOriginal/>
<postFileThumb/>
<postMediaFile/>
<rating>null</rating>
<postPin>0</postPin>
<postCreatedAt>30/07/2019</postCreatedAt>
<postUpdatedAt>30/07/2019</postUpdatedAt>
<postTags/>
<location/>
<postLinkUrl>https://on.natgeo.com/2SGL3UA</postLinkUrl>
<postAuthorName>National Geographic</postAuthorName>
<postUsername>National Geographic</postUsername>
<postUserPicture>https://scontent.xx.fbcdn.net/v/t1.0-1/p50x50/46173038_10156035001398951_8581620115135528960_n.jpg?_nc_cat=1&_nc_oc=AQnH0p0eiMe3ZRTUYtj4W6iTt736d9ecWQOizifDdpYqrxMcwCftos6NgtoNbZaxsNM&_nc_ht=scontent.xx&oh=3c3be68b9f1adc17b00f0f90b0aa31bb&oe=5DE0FBA4</postUserPicture>
<PostType>4</PostType>
<postHighlight>0</postHighlight>
<CTAcolor>null</CTAcolor>
<CTAbackground>null</CTAbackground>
<CTAStatus>null</CTAStatus>
<CTAurl>null</CTAurl>
<CTAtext>null</CTAtext>
<childNode>
<image>https://cloud.taggbox.com/instagram/76563/79749/150012/image_5-1639473191.jpg</image>
<video></video>
<image>https://cloud.taggbox.com/instagram/76563/79749/150012/image_5-1639473191.jpg</image>
<video></video>
</childNode>
</posts>
</responseData>
</xml>
401
application/json application/xml 
{
    "responseCode": 401,
    "responseStatus": "error",
    "responseMessage": "API is not available in this plan OR Wrong user key!"
}
<?xml version='1.0'?>
<xml>
<responseStatus>error</responseStatus>
<responseMessage>API is not available in this plan OR Wrong user key!</responseMessage>
<responseCode>401</responseCode>
</xml>

POST
https://api.taggbox.com/api/v2/widget/create-post?user_key=605b54dfbed1d7bdad7fce307e135a12&format=json
Request JSON
application/json 
{
   "wallId":233,
   "content":"hello demo content",
   "postFile":"https://taggbox.s3.amazonaws.com/uploaded/29ffbab45c5044b2a034987167c5d308",
   "authorName":"taggbox",
   "authorPicture":"https://taggbox.s3.amazonaws.com/uploaded/4e59b9d737ad435bb5b849e6da135bf8",
   "link":"https://app.taggbox.com"
}
Parameters
user_key A valid user-key. (Example: 605b54dfbed1d7bdad7fce307e135a12) How to get user_key
format {json} or {xml}
Responses
200
application/json application/xml 
{
    "responseCode": 200,
    "responseStatus": "success",
    "responseMessage": "Great! You have successfully created post."
}
<?xml version='1.0'?>
<xml>
<responseCode>200</responseCode>
<responseStatus>success</responseStatus>
<responseMessage>Great! You have successfully created post.</responseMessage>
</xml>
401
application/json application/xml 
{
    "responseCode": 401,
    "responseStatus": "error",
    "responseMessage": "API is not available in this plan OR Wrong user key!"
}
<?xml version='1.0'?>
<xml>
<responseStatus>error</responseStatus>
<responseMessage>API is not available in this plan OR Wrong user key!</responseMessage>
<responseCode>401</responseCode>
</xml>

GET
https://api.taggbox.com/api/v2/widget/delete/233?user_key=605b54dfbed1d7bdad7fce307e135a12&format=json
Parameters
wallId put wall id. (Example: 233)
user_key A valid user-key. (Example: 605b54dfbed1d7bdad7fce307e135a12) How to get user_key
format {json} or {xml}
Responses
200
application/json application/xml 
{
    "responseCode": 200,
    "responseStatus": "success",
    "responseMessage": "You have successfully deleted your wall."
}
<?xml version='1.0'?>
<xml>
<responseCode>200</responseCode>
<responseStatus>success</responseStatus>
<responseMessage>You have successfully deleted your wall.</responseMessage>
</xml>
401
application/json application/xml 
{
    "responseCode": 401,
    "responseStatus": "error",
    "responseMessage": "API is not available in this plan OR Wrong user key!"
}
<?xml version='1.0'?>
<xml>
<responseStatus>error</responseStatus>
<responseMessage>API is not available in this plan OR Wrong user key!</responseMessage>
<responseCode>401</responseCode>
</xml>

Celebrate this festive season with our Christmas SALE!

Enjoy 30% OFF on all plans and make the most of the holidays. Use code TAG30 at checkout to unlock your savings.

Grab Offer Now
close