The Tagbox API provides powerful tools to programmatically access and manage your social media galleries, posts, and widgets. Build custom integrations, automate content workflows, and create dynamic social displays with our RESTful API.
user_key parameter.
Learn how to get your API user key
Include your API user key as a query parameter in all requests. This key identifies your account and ensures secure access to your gallery data:
https://api.taggbox.com/api/v1/support/galleries?user_key=YOUR_USER_KEY
The API supports both JSON and XML response formats. Use the format parameter:
?format=json
?format=xml
{
"responseCode": 200,
"responseStatus": "success",
"responseMessage": "Operation completed successfully",
"responseData": "/* API specific data */"
}
Retrieve comprehensive information about a specific gallery including gallery details, configuration settings, and all associated social media feeds. This endpoint provides essential metadata needed for gallery management and feed analysis.
https://api.taggbox.com/api/v1/support/galleries?user_key=${user_key}&format=${format}
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_key | string |
Required
|
Your API authentication key obtained from your Taggbox account settings. This key provides secure access to your gallery data.
Example:
605b54dfbed1d7bdad7fce305e135a78
|
| format | string |
Optional
|
Response format preference. Choose 'json' for JavaScript applications or 'xml' for legacy systems. Defaults to JSON if not specified.
Example:
json/xml
|
Test the API endpoint with live data
Returns the feed sources for a specific gallery. You can filter using a user key and gallery Id for the list
https://api.taggbox.com/api/v1/support/feeds?user_key=${user_key}&galleryId=${galleryId}&format=${format}
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_key | string |
Required
|
Your API authentication key obtained from your Taggbox account settings. This key provides secure access to your gallery data.
Example:
605b54dfbed1d7bdad7fce305e135a78
|
| galleryId | integer |
Required
|
The unique identifier for the gallery. You can find this Id in your Taggbox dashboard under gallery settings.
Example:
2183925
|
| format | string |
Optional
|
Response format preference. Choose 'json' for JavaScript applications or 'xml' for legacy systems. Defaults to JSON if not specified.
Example:
json/xml
|
Test the API endpoint with live data
Retrieves gallery posts with filters for network Id, user key, and gallery Id etc. You can also choose to show only tagged posts.
https://api.taggbox.com/api/v1/support/posts?user_key=${user_key}&galleryId=${galleryId}&format=${format}
| Parameter | Type | Required | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| user_key | string |
Required
|
Your API authentication key obtained from your Taggbox account settings. This key provides secure access to your gallery data.
Example:
605b54dfbed1d7bdad7fce305e135a78
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| galleryId | integer |
Required
|
The unique identifier for the gallery. You can find this Id in your Taggbox dashboard under gallery settings.
Example:
2183925
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| feedId | array |
Optional
|
The unique identifier for the feed.
Example:
[2183925]
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| limit | integer |
Optional
|
The number of posts to retrieve. Defaults to 10 if not specified.
Example:
10
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| offset | integer |
Optional
|
The number of posts to skip before starting to retrieve. Defaults to 0 if not specified.
Example:
0
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| networkId | array |
Optional
|
The network Ids to filter posts by. Defaults to all networks if not specified.
Example:
[4,2]
Network Id List
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| productId | string |
Optional
|
The product Id to filter posts by. Defaults to all products if not specified.
Example:
112-hst
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| taggedOnly | boolean |
Optional
|
If true, only posts that are tagged with the specified product will be returned. Defaults to false if not specified.
Example:
true/false
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| format | string |
Optional
|
Response format preference. Choose 'json' for JavaScript applications or 'xml' for legacy systems. Defaults to JSON if not specified.
Example:
json/xml
|
Test the API endpoint with live data
The Tagbox API provides powerful tools to programmatically access and manage your social media galleries, posts,
and widgets. Build custom integrations, automate content workflows, and create dynamic social displays with our RESTful API.
Understanding error codes helps you debug issues and handle edge cases gracefully. The Tagbox API returns standardized HTTP status codes with detailed error messages to help you identify and resolve problems quickly.
Request was successful.
Request was not found.
Invalid parameters or malformed request.
Something went wrong on our end
Invalid or missing API key
{
"responseCode": 401,
"responseStatus": "error",
"responseMessage": "API is not available in this plan OR Wrong user key!"
}
When the requested gallery doesn't exist or you don't have access
{
"responseCode": 404,
"responseStatus": "error",
"responseMessage": "Gallery not found or access denied"
}
Missing required parameters
{
"responseCode": 400,
"responseStatus": "error",
"responseMessage": "Missing required parameter: user_key!"
}