API Documentation - Tagembed Support

These API have been deprecated on 31st October 2022

Introduction

Add Social Feeds to your Website, Screens or App with our API Solutions

tagembed lets you create beautiful social hubs for your websites with a click of a button.

Our API solutions give you absolute control of the design and layout of the content for your websites or screen displays. This is the best way to integrate the tagembed data on your apps. Find below documentation for the same.

Post Limit	100 Posts/request
API Access	Currently, we are providing API access with API Starter and API Advanced plans.
Update Time	Update time is based on your Pricing Plan
Request Limit	1 Request/ Per Minute
User Key	You can find user key in your Tagembed My Account Section *API Options will be only shown when your account is having Tagembed API access
Format	JSON and XML
Example URL	https://app.tagembed.com/api/apiJson/5613?user_key=56200ef68981fb037175a9ecca66c4d0

JSON Format

Introduction

Tagembed lets you create beautiful social hubs for your websites with a click of a button.

Getting started :

Post Limit	100 Posts/request
API Access	Currently, we are providing API access with API Starter and Advance plans.
Update Time	Update time based on your pricing plan
Request Limit	1 Request/ Per Minute
User Key	You can find user key in your Tagembed My Account Section *API Options will be only shown when your account is having Tagembed API access
Format	JSON
Example URL	https://app.tagembed.com/api/apiJson/5613?user_key=56200ef68981fb037175a9ecca66c4d0

Authentication :

Each API request requires an API key either as a HTTP Header or included as a query string. You can find your API key in the Tagembed Account Section.
Your API key has many privileges, be sure to keep it secret! Do not share the key in publicly accessible areas such GitHub, client-side code, and so forth.
Query string
Include the API key as part of the request path in the format ?api_key=API_KEY.

Response Codes :

The common HTTP Response Status Codes are used.

1. Successful Response :

400 Bad Request

2. Error Responses :

400 Bad Request
403 Forbidden
404 Not Found
405 User Key Required
406 API Is Not Available In Your Plan Or Wrong Key
407 API Limit Exceeded
408 Wall Is Not Active
409 Wall Is Not Available For This User Key
500 Internal Server Error

Endpoint :

https://app.tagembed.com/api/apiJson

Posts:

Posts that can be integrated on your website.

1. Wall Id - Get Posts

Request : GET /5613(wallId)?User_Key
Example https://app.tagembed.com/api/apiJson/5613?user_key=56200ef68981fb037175a9ecca66c4d0
Field Name	Optional	Type	Remark
Wallid	No	Number	Wall id

2. Number Of Posts - User will get total post as API response

Request : GET /5613(wallId)?User_Key&count=3(NumberOfPostOptional)
Example https://app.tagembed.com/api/apiJson/5613?user_key=56200ef68981fb037175a9ecca66c4d0&count=3
Output Maximum number of posts will be 3
Field Name	Optional	Type	Remark
Wallid	No	Number	Wall id
Count	Yes	Number	Number Of Post

3. Post Offset - User will get posts starting from post index

Request : GET /5613(wallId)?User_Key&start=0()&count=3(NumberOfPostOptional)
Example https://app.tagembed.com/api/apiJson/5613?user_key=56200ef68981fb037175a9ecca66c4d0&count=3
Output Posts with starting position 0, Max number of posts 3
Field Name	Optional	Type	Remark
Wallid	No	Number	Wall id
Start	No	Number	Start
Count	Yes	Number	Number Of Post

4. Min Id - Response will start from post min id

Request : GET /5613(wallId)?User_Key&count=3(NumberOfPostOptional)&minId=810(PostId)
Example https://app.tagembed.com/api/apiJson/5613?user_key=56200ef68981fb037175a9ecca66c4d0&count=3&minId=810
Output Posts after minId (810) , Max Number of Post 3
Field Name	Optional	Type	Remark
Wallid	No	Number	Wall id
Count	Yes	Number	Number Of Post
minid	Yes	Number	Min Post Id

5. Max Id - Response will start from first id to max id

Request : GET /5613(wallId)?User_Key&count=3(NumberOfPostOptional)&maxId=850(PostId)
Example https://app.tagembed.com/api/apiJson/5613?user_key=56200ef68981fb037175a9ecca66c4d0&count=3&maxId=850
Output Posts before maxId (850), Max Number of Post 3
Field Name	Optional	Type	Remark
Wallid	No	Number	Wall id
Count	Yes	Number	Number Of Post
maxid	Yes	Number	Max Post Id

6. Posts Between Post Id’s - Response will start from given min id to max id

Request : GET /5613(WallId)?User_Key&count=3(NumberOfPostOptional)&minId=810(StartPostId)&maxId=850(EndPostID)
Example https://app.tagembed.com/api/apiJson/5613?user_key=56200ef68981fb037175a9ecca66c4d0&count=3&minId=810&maxId=850
Output Posts between StartPostId(810) and EndPostId (850), Max Number of Post 3
Field Name	Optional	Type	Remark
Wallid	No	Number	Wall id
Count	Yes	Number	Number Of Post
minid	Yes	Number	Min Post Id
maxid	Yes	Number	Max Post Id

7. Filter Posts - Response will start from given min id to max id

Request : GET /5613(wallId)?User_Key&count=3(NumberOfPostOptional)&network=twitter(NetworkName)
Example https://app.tagembed.com/api/apiJson/5613?user_key=56200ef68981fb037175a9ecca66c4d0&count=3&network=twitter
Output Post filter according network, Max Number of Post 3
Field Name	Optional	Type	Remark
Wallid	No	Number	Wall id
Count	Yes	Number	Number Of Post
network	Yes	String	Network Name
Filter Parameters
1	&network=twitter	11	&network=workplac
2	&network=instagram	12	&network=yelp
3	&network=facebook	13	&network=slack
4	&network=google	14	&network=yammer
5	&network=pinterest	15	&network=airbnb
6	&network=flickr	16	&network=soundcloud
7	&network=youtube	17	&network=giphy
8	&network=vimeo	18	&network=capterra
9	&network=linkedIn	19	&network=etsy
10	&network=tumblr	20	&network=rss

Response - application/xml, text/xml

                                 {
                                    "wallDetail": {
                                       "wallName": "API Document ",
                                       "wallUrl": "api-document-",
                                       "wallProfanity": "0",
                                       "wallCreatedAt": "0",
                                       "count": 100
                                    },
                                    "feeds": [
                                       {
                                             "feedName": "avengers",
                                             "networkName": "Twitter",
                                             "feedId": "10090",
                                             "postId": "806",
                                             "postContent": "RT @OuterRimsPhoto: \u0022...to see if we could become something more...\u0022 #reassemble #playavengers \n\n#Avengers #Marvel #VirtualPhotography #The…",
                                             "postScore": "pos",
                                             "postFileMedium": "",
                                             "postFileSmall": "",
                                             "postContentPicture": "",
                                             "postFile": "",
                                             "postLinkUrl": "1401130620261130242",
                                             "postPin": "0",
                                             "postHighlight": "0",
                                             "postAuthorName": "Hero Fan",
                                             "postUsername": "bob64262049",
                                             "postUserPicture": "https:\/\/pbs.twimg.com\/profile_images\/1223447627930505217\/_p_FtUGs_normal.jpg",
                                             "postPicture": "https:\/\/pbs.twimg.com\/profile_images\/1223447627930505217\/_p_FtUGs_normal.jpg",
                                             "postTags": "",
                                             "postCreatedAt": "1622890546",
                                             "postMediaFile": "",
                                             "postUpdatedAt": 1622890749,
                                             "location": null,
                                             "CTAtext": "",
                                             "CTAbackground": "",
                                             "CTAcolor": "",
                                             "CTAurl": "javascript:void(0);"
                                       },
                                             ]
                                 }

Download Documentation

XML Format

Introduction

Tagembed lets you create beautiful social hubs for your websites with a click of a button.

Getting started :

Post Limit	100 Posts/request
API Access	Currently, we are providing API access with API Starter and Advance plans.
Update Time	Update time based on your pricing plan
Request Limit	1 Request/ Per Minute
User Key	You can find user key in your Tagembed My Account Section *API Options will be only shown when your account is having Tagembed API access
Format	XML
Example URL	https://app.tagembed.com/api/apiXml/5613?user_key=56200ef68981fb037175a9ecca66c4d0

Authentication :

Each API request requires an API key either as a HTTP Header or included as a query string. You can find your API key in the Tagembed Account Section.
Your API key has many privileges, be sure to keep it secret! Do not share the key in publicly accessible areas such GitHub, client-side code, and so forth.
Query string
Include the API key as part of the request path in the format ?api_key=API_KEY.

Response Codes :

The common HTTP Response Status Codes are used.

1. Successful Response :

200 HTTP Response Code.

2. Error Responses :

400 Bad Request
403 Forbidden
404 Not Found
405 User Key Required
406 API Is Not Available In Your Plan Or Wrong Key
407 API Limit Exceeded
408 Wall Is Not Active
409 Wall Is Not Available For This User Key
500 Internal Server Error

Endpoint :

https://app.tagembed.com/api/apiXml

Posts:

Posts that can be integrated on your website.

1. Wall Id - Get Posts

Request : GET /5613(wallId)?User_Key
Example https://app.tagembed.com/api/apiXml/5613?user_key=56200ef68981fb037175a9ecca66c4d0
Field Name	Optional	Type	Remark
Wallid	No	Number	Wall id

2. Number Of Posts - User will get total post as API response

Request : GET /5613(wallId)?User_Key&count=3(NumberOfPostOptional)
Example https://app.tagembed.com/api/apiXml/5613?user_key=56200ef68981fb037175a9ecca66c4d0&count=3
Output Maximum number of posts will be 3
Field Name	Optional	Type	Remark
Wallid	No	Number	Wall id
Count	Yes	Number	Number Of Post

3. Post Offset - User will get posts starting from post index

Request : GET /5613(wallId)?User_Key&start=0()&count=3(NumberOfPostOptional)
Example https://app.tagembed.com/api/apiXml/5613?user_key=56200ef68981fb037175a9ecca66c4d0&count=3
Output Posts with starting position 0, Max number of posts 3
Field Name	Optional	Type	Remark
Wallid	No	Number	Wall id
Start	No	Number	Start
Count	Yes	Number	Number Of Post

4. Min Id - Response will start from post min id

Request : GET /5613(wallId)?User_Key&count=3(NumberOfPostOptional)&minId=810(PostId)
Example https://app.tagembed.com/api/apiXml/5613?user_key=56200ef68981fb037175a9ecca66c4d0&count=3&minId=810
Output Posts after minId (810) , Max Number of Post 3
Field Name	Optional	Type	Remark
Wallid	No	Number	Wall id
Count	Yes	Number	Number Of Post
minid	Yes	Number	Min Post Id

5. Max Id - Response will start from first id to max id

Request : GET /5613(wallId)?User_Key&count=3(NumberOfPostOptional)&maxId=850(PostId)
Example https://app.tagembed.com/api/apiXml/5613?user_key=56200ef68981fb037175a9ecca66c4d0&count=3&maxId=850
Output Posts before maxId (850), Max Number of Post 3
Field Name	Optional	Type	Remark
Wallid	No	Number	Wall id
Count	Yes	Number	Number Of Post
maxid	Yes	Number	Max Post Id

6. Posts Between Post Id’s - Response will start from given min id to max id

Request : GET /5613(WallId)?User_Key&count=3(NumberOfPostOptional)&minId=810(StartPostId)&maxId=850(EndPostID)
Example https://app.tagembed.com/api/apiXml/5613?user_key=56200ef68981fb037175a9ecca66c4d0&count=3&minId=810&maxId=850
Output Posts between StartPostId(810) and EndPostId (850), Max Number of Post 3
Field Name	Optional	Type	Remark
Wallid	No	Number	Wall id
Count	Yes	Number	Number Of Post
minid	Yes	Number	Min Post Id
maxid	Yes	Number	Max Post Id

7. Filter Posts - Response will start from given min id to max id

Request : GET /5613(wallId)?User_Key&count=3(NumberOfPostOptional)&network=twitter(NetworkName)
Example https://app.tagembed.com/api/apiXml/5613?user_key=56200ef68981fb037175a9ecca66c4d0&count=3&network=twitter
Output Post filter according network, Max Number of Post 3
Field Name	Optional	Type	Remark
Wallid	No	Number	Wall id
Count	Yes	Number	Number Of Post
network	Yes	String	Network Name
Filter Parameters
1	&network=twitter	11	&network=workplac
2	&network=instagram	12	&network=yelp
3	&network=facebook	13	&network=slack
4	&network=google	14	&network=yammer
5	&network=pinterest	15	&network=airbnb
6	&network=flickr	16	&network=soundcloud
7	&network=youtube	17	&network=giphy
8	&network=vimeo	18	&network=capterra
9	&network=linkedIn	19	&network=etsy
10	&network=tumblr	20	&network=rss

Response - application/xml, text/xml

                              
                              
                              API Document 
                              api-document-
                              0
                              0
                              3
                              
                              
                              
                              avengers
                              Twitter
                              10090
                              810
                              RT @itsme_Riyasha: Any #Marvel Fans..💜 Just Try WallPaper #Avengers 💥 #Master #Thalapathy65 @actorvijay https://t.co/ddbOjzIUtG
                              pos
                              https://pbs.twimg.com/media/E3GGFqVUUAAKO2S.jpg
                              https://pbs.twimg.com/media/E3GGFqVUUAAKO2S.jpg
                              https://pbs.twimg.com/media/E3GGFqVUUAAKO2S.jpg
                              https://pbs.twimg.com/media/E3GGFqVUUAAKO2S.jpg
                              1401127085310054406
                              0
                              0
                              MersalRavi
                              D12Ravichandran
                              https://pbs.twimg.com/profile_images/1394129594245009414/uIEgIXZ9_normal.jpg
                              https://pbs.twimg.com/profile_images/1394129594245009414/uIEgIXZ9_normal.jpg
                              
                              1622889703
                              
                              1622890749
                              
                              
                              
                              
                              javascript:void(0);
                              
                              
                              avengers
                              Twitter
                              10090
                              811
                              RT @potadumpling: found and colored an old sketch, Bucky and Natasha are singing the USSR Anthem 🤣 #Avengers #BuckyBarnes #NatashaRomanoff…
                              neu
                              
                              
                              
                              
                              1401126381828849664
                              0
                              0
                              dio☠︎︎
                              necrodi0
                              https://pbs.twimg.com/profile_images/1400765426594811906/EnfnMWvA_normal.png
                              https://pbs.twimg.com/profile_images/1400765426594811906/EnfnMWvA_normal.png
                              
                              1622889535
                              
                              1622890749
                              
                              
                              
                              
                              javascript:void(0);

Download Documentation