Retrieve a slot

Retrieves the content of a slot, which then can be used to perform custom server-side personalization.

Required format with one of the following options:

FormatDescription
htmlReturns the SmartBlock selected by the Slot formatted as HTML.
blockimageReturns the SmartBlock selected by the Slot formatted as an image.
dynamichtml

Returns open-time HTML.

Note: Not needed for server-side personalization.

fullReturns everything as a JSON container, with HTML inside, plus metadata.
compactReturns everything as a JSON container, matching items inside items, plus metadata.
Useful for Recommendations, to return product IDs without the accompanying HTML.
appjsonReturns everything as a JSON container, with HTML inside, matching items inside items, plus metadata.

Example format responses:

<table cellspacing="0" cellpadding="0" border="0" style="width: 600px;" align="center">
    <tr>
        <td class="imagecontainer" data-imageindex="0" style="border-radius: 0px; 
            padding: 0px;
            text-align: center;
            background-color: #ffffff;
            ">
            <a href target="_blank" style="text-decoration: none;">
                <img src="https://media.giphy.com/media/v1.Y2lkPTc5MGI3NjExcTVtbWpmZWZ2eHhjbndva2NsYXAyaHJ3c3Nnb3c3bWloYm96NnB6biZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/xTiN0CNHgoRf1Ha7CM/giphy.gif" alt="GIF">
            </a>
        </td>
    </tr>
</table>
<table cellspacing="0" cellpadding="0" border="0" style="width: 600px;" align="center">
    <tr>
        <td class="imagecontainer" data-imageindex="0" style="border-radius: 0px; 
            padding: 0px;
            text-align: center;
            background-color: #ffffff;
            ">
            <a href="" target="_blank" style="text-decoration: none;">
                <img src="https://media.giphy.com/media/v1.Y2lkPTc5MGI3NjExcTVtbWpmZWZ2eHhjbndva2NsYXAyaHJ3c3Nnb3c3bWloYm96NnB6biZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/xTiN0CNHgoRf1Ha7CM/giphy.gif" alt="GIF" />
            </a>
        </td>
    </tr>
</table>
<table cellspacing="0" cellpadding="0" border="0" style="width: 600px;" align="center">
    <tr>
        <td class="imagecontainer" data-imageindex="0" style="border-radius: 0px; 
            padding: 0px;
            text-align: center;
            background-color: #ffffff;
            "><a class="fr__link-wrapper"
                href="https://c8.dycdn.net/rg55bjkl/s/push2dd/?k=3ldtt4d&amp;format=dynamiclink"><img src="https://c8.dycdn.net/rg55bjkl/s/push2dd/?k=3ldtt4d&amp;format=dynamicimage"></a>
        </td>
    </tr>
</table>
{
    "html": "<table cellspacing=\"0\" cellpadding=\"0\" border=\"0\" style=\"width: 600px;\" align=\"center\">\n\n    <tr>\n\n        <td class=\"imagecontainer\" data-imageindex=\"0\" style=\"border-radius: 0px; \n            padding: 0px;\n            text-align: center;\n            background-color: #ffffff;\n            \">\n\n            <a href target=\"_blank\" style=\"text-decoration: none;\">\n\n                <img src=\"https://media.giphy.com/media/v1.Y2lkPTc5MGI3NjExcTVtbWpmZWZ2eHhjbndva2NsYXAyaHJ3c3Nnb3c3bWloYm96NnB6biZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/xTiN0CNHgoRf1Ha7CM/giphy.gif\" alt=\"GIF\">\n\n            </a>\n\n        </td>\n\n    </tr>\n\n</table>",
    "js": null,
    "css": null,
    "var": {
        "tmclt": true
    },
    "meta": {
        "tmsl": "push2dd",
        "tmsb": "aa7u9zu",
        "tmrl": "l0tt40i",
        "tmcs": "iz2z0mg",
        "tmcv": 0,
        "tmty": "e",
        "tmsn": "Test LS",
        "products": []
    }
}
{
    "html": null,
    "js": null,
    "css": null,
    "var": {},
    "meta": {
        "tmsl": "push2dd",
        "tmsb": "aa7u9zu",
        "tmrl": "l0tt40i",
        "tmty": "e",
        "tmsn": "Test LS"
    },
    "items": []
}
{
    "html": "\n\n<table cellspacing=\"0\" cellpadding=\"0\" border=\"0\" style=\"width: 600px;\" align=\"center\">\n\n    <tr>\n\n        <td class=\"imagecontainer\" data-imageindex=\"0\" style=\"border-radius: 0px; \n            padding: 0px;\n            text-align: center;\n            background-color: #ffffff;\n            \">\n\n            <a href=\"\" target=\"_blank\" style=\"text-decoration: none;\">\n\n                <img src=\"https://media.giphy.com/media/v1.Y2lkPTc5MGI3NjExcTVtbWpmZWZ2eHhjbndva2NsYXAyaHJ3c3Nnb3c3bWloYm96NnB6biZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/xTiN0CNHgoRf1Ha7CM/giphy.gif\" alt=\"GIF\" />\n\n            </a>\n\n        </td>\n\n    </tr>\n\n</table>\n",
    "js": null,
    "css": null,
    "var": {},
    "meta": {
        "tmsl": "push2dd",
        "tmsb": "aa7u9zu",
        "tmrl": "l0tt40i",
        "tmcs": "iz2z0mg",
        "tmcv": 0,
        "tmty": "e",
        "tmsn": "Test LS",
        "products": []
    },
    "items": []
}

Additional personalization parameters

This endpoint also supports personalization by including an identifier for the visitor in the query string parameters.

The any of the following optional query string parameters are supported:

ParameterDescription
eThe visitor's email address.
d

An identifier for a device the visitor used to visit your website.

The device ID is a cookie value that is generated by our script on your website.

This is stored in the tms_VisitorID cookie. This is a first-party cookie, so is available in the Cookie HTTP header on requests to your server.

cid

The visitor's customer ID. This only works if this value is known to Dotdigital Personalization already.

Learn more inImport person data.

If you're using filters to return relevant content based on the specific site then you may also need to pass through additional parameters, such as:

ParameterDescription
pridUnique product identifier, for example, 12345.
sbrSite Brand/Territory for the product, for example, DEMO.
currCurrency - ISO 4217 currency code, for example, USD.

Examples

Fetch HTML content for server side merging

https://c8.dycdn.net/abcdefg1/s/push2dd/?k=z321xx4d&format=html

Fetch JSON content for server side processing

https://c8.dycdn.net/abcdefg1/s/push2dd/?k=z321xx4d&format=full

Fetch JSON content for server side processing with additional personalization

https://c8.dycdn.net/abcdefg1/s/push2dd/?k=z321xx4d&format=full&[email protected]

🪛

Struggling to get the correct URL to get a slot

To find the specific URL for a Slot stored in your account:

  1. In Personalization, go to Content > Slots.
  2. Select the Web Personalization tab.
  3. Select the Slot you want, then select the Use icon.
  4. The URL to request that slot is shown under Feed URL.
Path Params
string
required

Website ID for the account you are posting data to.

string
required

The slot's id you want the content for.

Query Params
string
enum
Defaults to html

Required format for the content.

Allowed:
string

The email address of the site visitor.

string

Device ID for the site visitor, from the tracking cookies.

string

The shopper's customer ID. This only works if this value is known to Dotdigital Personalization already.

string

Unique product identifier e.g. 12345

string

Site Brand/Territory for the product (e.g. the product was shown in USD on the US version of the store) e.g. DEMO

string

Currency - ISO 4217 currency code e.g. USD

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

400

Bad request

401

Unauthorized

Language
Credentials
Query
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/html
application/json