Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.dashsocial.com/llms.txt

Use this file to discover all available pages before exploring further.

In this guide we will be going over the concept and API needed to automate importing emails captured from your brand’s LikeShop so that you don’t have to manually upload them to your email marketing tool such as MailChimp, Hubspot, etc.

​
Get up to speed quickly

You will need two things to get started and make any Dash Social API calls:
  1. API Key: Our API key (Bearer Token) can be generated directly from our platform under the Developer section.
  2. Brand ID: You can see your brand_id next to your brand name under the Developer section as well.
If you haven’t done so already, check out the API Quickstart guide to learn how you can get your API Key & brand_id.

​
Get emails from LikeShop

Getting LikeShop emails in JSON is simple — start by calling https://library-backend.dashsocial.com/brands/{brand_id}/galleries/likeshop/email_submissions with your brand_id.
ParameterDescription
brand_id (REQUIRED)The Dash Social assigned ID of the brand.
start_datestring or null. Default: null. Example: start_date=2019-12-01. Filter results starting from a date in UTC.
end_datestring or null. Default: null. Example: end_date=2019-12-12. Filter results ending at a date in UTC.
limitinteger [ 0 .. 5000 ]. Default: 2000. Number of results to return in a single response.
offsetinteger >= 0. Default: 0. The offset of the result to be returned.

​
Request Example

GET https://library-backend.dashsocial.com/brands/<brand_id>/galleries/likeshop/email_submissions?start_date=2022-11-20T18:00:00&end_date=2022-11-20T17:00:00

headers = {
  'Authorization': 'Bearer <API KEY>'
}
You should expect a JSON response as below. 
{
    "data": [
        {
            "captured_at": "2021-08-10T17:13:24",
            "email": "anonymous-2@dashsocial.com"
        },
        {
            "captured_at": "2021-08-10T19:48:28",
            "email": "anonymous-3@dashsocial.com"
        }
    ],
    "paging": {
        "count": 2,
        "next": null,
        "previous": null
    }
}

​
Automation Concept

For automation purposes you might want to take advantage of the date filters to get the latest emails captured — let’s say in the last 1 hour. This number can be higher or lower, but we recommend not going under 10 mins. Let us know if you have any feedback.