How to retrieve data collected in your promotions via the API
API Playground - Retrieving user's contact data and permission marketing preferences How to retrieve data collected in your promotions via the API.
This article is part of our Playground series, where you can learn how to use BeeLiked's API without needing an Account of your own. See the Playground Introduction page for details
We have set up the following Spin the Wheel promotion as a Public Promotion (Open to anyone with the public link). Spin Paddy
The promotion has an entry page that asks for first name, last name, and email. It also collects opt-in permission marketing preferences.
View and enter the promotion by clicking the image or link above.
(IMPORTANT: remember that any data entered will be accessible to all users of the Playground API, so we recommend not using real user credentials).
This promotion (promo ID 24783) is set up to collect the following information:
- First Name
- Last Name
- Newsletter Opt In
- Terms and Conditions Approval
There are two ways you can retrieve this data:
1. Retrieve all data entered into all and any of your promotions via Audience Members
Refer to the API documentation to Audience Members:
Once you have completed authentication, you will be able to call the /audience/members endpoint to retrieve a list of all entries across all your promotions.
2. Retrieve the entry data submitted for just one promotion
In the above example, you will need to filter the audience according to the promotion ID so you can just return entries from this promotion.
In Playground the following Promo IDs are Live:
Public promos with entry form:
Spin Paddy - Wheel of Fortune - promo id = 24783
Tartan Gift - Unwrap the Gift - promo id = 24867
Treat Time - Open Envelope - promo id = 24866
Grab Something - Grabber - promo id = 23711
Private Promotions where an InviteLink is required to enter:
Over the Moon - Wheel of Fortune - promo id = 24798
Seasons Greetings - pop the balloon - promo id = 24782