Tags API
Tags
Tags allow content to be categorized and filtered for better curation. They are more like blog tags or product swing tags and are not to be confused with hashtags. It is a form of profiling Social Tiles for grouping/association purposes.
Properties
id
integer
X
X
Unique identifier for the Tag. Example Values: 12345
tag
tag
✔
✔
post: Required
Name and display title on the Tag.
Example Values: Editor's choice
slug
string
✔
✔
post: Required if custom_slug
is 0
Simplified and class-name-fiendly Tag identifier, most often auto-generated. On output this value is often used to set the class.
Example Values: editors-choice
custom_slug
bool
1
(true)
0
(false)
✔
✔
This value specifies if the slug
field value is being auto-generated or overwritten by the user.
Example Values: 0
type
enum
content
product
competition
✔
✔
post: Required
Specifies the type of the Tag
Example Values: content
publicly_visible
bool
1
(true)
0
(false)
✔
✔
post: Required
This value specifies if display renderers should display this Tag in display context
Example Values: 1
target
enum
_blank
_self
_parent
_top
✔
✔
When rendered as a link, this will indicate the target attribute for the anchor tag when used with custom_url
Example Values: _blank
system_tag
bool
1
(true)
0
(false)
X
X
Indicates whether this Tag is a read-only tag created and managed by the system.
Example Values: 1
priority
integer
1 (highest) - 5 (lowest)
✔
✔
Specifies the sequential sort order in which this Tag should be displayed when being rendered for display. Default values is 3
Example Values: 3
custom_url
string
✔
✔
URL that clicking on the Tag should take the user to. When type is product, this is the URL that the product click-through should be linked to
Example Values: https://www.google.com.au/?q=stackla
price
string
✔
✔
User provided price for Tags of type product
.
Example Values: $399
ext_product_id
string
✔
✔
User provided reference to external product for Tags of type product
. Should be a continous string, best if URL-friendly. When querying for a product by ID, this value can be prefixed with ext:
to fetch by it.
Example Values: PROD-1234
description
string
✔
✔
User provided description for Tags of type product. Maximum length: 512 characters
Example Values: Long sleeve woven swing dress in animal print with roll neck and back zip fastening. 87cm length. 100% Viscose. Machine washable.
image_small_url
string
✔
✔
URL of the small (optimised for 300px x 300px) image PNG/JPG/JPEG/GIF image to be displayed. This should be a HTTPS URL to so that the Stack or widget can be served over HTTPS completely
Example Values: https://stackla.com/images/product_small.jpg
image_small_width
integer
✔
✔
Width of the small image being used as the image_small_url, in pixels
Example Values: 250
image_small_height
integer
✔
✔
Height of the small image being used as the image_small_url, in pixels
Example Values: 200
image_medium_url
string
✔
✔
URL of the medium (optimised for 600px x 600px) image PNG/JPG/JPEG/GIF image to be displayed. This should be a HTTPS URL to so that the Stack or widget can be served over HTTPS completely
Example Values: https://stackla.com/images/product_medium.jpg
image_medium_width
integer
✔
✔
Width of the small image being used as the image_medium_url, in pixels
Example Values: 500
image_medium_height
integer
✔
✔
Height of the small image being used as the image_medium_url, in pixels
Example Values: 400
created_at
timestamp
X
X
UTC timestamp of when this Tag was created
Example Values: 1372057752
GET tags
Retrieves all tags available in the Stack.
Resource URL
https://api.stackla.com/api/tags
Resource Details
Rate limited: Yes
Access scope: User
Request Parameters
keyword
No
query
Keyword to search Tag ID, Name, Slug, External URL and External Product ID (prefixed with "ext:"). Example Values: 12345
, ext:PROD-1234
, my tag
type
No
query
Comma-separated of type of tags to be derived. One or more of content, product, competition, system.
Example Values: content
, product
page
No
query
Page number. Default value is 1
limit
No
query
Return limit define how many Tags will be return for each request. Default is 25. Maximum limit is 100.
POST tags
Creates a new Tag in the Stack.
Resource URL
https://api.stackla.com/api/tags
Resource Details
Rate limited: Yes
Access scope: User
Request Parameters
No additional request parameters are available.
GET tags/:tagId
Retrieves a specific Tag available in the Stack by its ID.
Resource URL
https://api.stackla.com/api/tags/:tagId
Resource Details
Rate limited: Yes
Access scope: User
Request Parameters
tagId
Yes
endpoint
ID of the Tag, or its External Product ID (prefixed with "ext:"). Example Values: 12345
, ext:PROD-1234
GET tags/:tagId/summaries
Retrieves aggregated data of a specific Tags by its ID.
Resource URL
https://api.stackla.com/api/tags/:tagId/summaries
Resource Details
Rate limited: Yes
Access scope: User
Request Parameters
tagId
Yes
endpoint
ID of the Tag, or its External Product ID (prefixed with "ext:"). Example Values: 12345
, ext:PROD-1234
PUT tags/:tagId
Updates a specific Tag available in the Stack by its ID.
Resource URL
https://api.stackla.com/api/tags/:tagId
Resource Details
Rate limited: Yes
Access scope: User
Request Parameters
tagId
Yes
endpoint
ID of the Tag, or its External Product ID (prefixed with "ext:"). Example Values: 12345
, ext:PROD-1234
DELETE tags/:tagId
Deletes a specific Tag available in the Stack by its ID.
Resource URL
https://api.stackla.com/api/tags/:tagId
Resource Details
Rate limited: Yes
Access scope: User
Request Parameters
tagId
Yes
endpoint
ID of the Tag, or its External Product ID (prefixed with "ext:"). Example Values: 12345
, ext:PROD-1234