Subscribers of the profile or store can be accessed through the Subscriber API. This API provides the subscriber's email address and the date of their subscription. The subscriber details can then be forwarded to different marketing platforms for marketing or newsletter campaigns.
In order to access the next page, make use of page parameters.
http://api.shopper.com/v1/user/subscribers?page={page}&limit={limit}&order_by={order_by}
Parameters
Parameter | Type | Description |
---|---|---|
page | integer | Page number. Starting page number is 0 |
limit | integer | The maximum number of results to fetch. The default limit is 100 |
order_by | string | For sorting. Possible values: subscribe_date. For inverse sort order, sign '-' before the value. Eg: order_by=-subscribe_date. |
Sample Response
{
"status": 200,
"message": "OK",
"current": 1,
"start": 1,
"end": 1,
"limit": 200,
"total": 10,
"next_page": "https://api.shopper.com/v1/user/subscribers?page=2&limit=200",
"subscribers": [
{
"id": "625535caefdfcd0019074899",
"email": "happy@happy.com",
"subscribe_date": "2022-04-12T08:18:18.665Z"
},
{
"id": "6255372fefdfcd001907489a",
"email": "happy2@happy.com",
"subscribe_date": "2022-04-12T08:24:15.194Z"
}
]
}
Response body
subscribers: Array of subscriber for the authenticated store, including unique subscriber id, email and subscribed date in ISO 8601 format
Response status
Status | Reason |
---|---|
500 | Internal server error |
200 | Success |
400 | Invalid request parameters |
405 | API method is not allowed, contact admin to get access |
401 | Invalid authentication parameters |