Computing Service
Coffee Pie®
Coffee Pie Ads API
Documentation
*Disclaimer: We never share sensitive user data such as real name, real ID, email address, physical address, IP address, full postal code (just an approximate region), etc. Only an anonymized model with generic market segmentation information is shared in our API, so that the free tier service is transparent without being invasive. If you're part of a Marketing Agency, contact us directly to schedule a Demo with one of our Account Executives to show you the advantages and benefits of using our massive and highly segmented platform. If you're user and feel that you are not willing to accept this type of business model, either because don't want to watch ads or you find it intrusive to your privacy, we invite you to get a package valid weekly, monthly or annually, since with this prepaid model the anonymous profile with your consumption patterns is not displayed in our API, your choice!
Consumption Patterns Tracking Data (Free Tier):
1. Demographics
-
Age, Gender, Marital Status, etc: This is essential for personalizing campaigns.
-
Educational Level, Annual Income, Occupation: Helps create a more detailed user profile.
-
Family: Segments are made if there are relatives in the user's environment (such as children, nephews, neighbors) for christmas, halloween, valentine's day, etc, without sensitive data about them, only their age, gender and relation (including pets).
2. Interests
-
Categories and Specifics: Includes broad categories (such as "technology" or "fashion") and specific ones ("Samsung Galaxy," "Nike Shoes," etc.).
3. Behavior
-
Purchase Frequency, Device Preference: Information about how the user interacts online and with which devices.
-
Time on Platforms and Purchase Frequency: Useful for understanding what type of content the user is interested in.
-
Purchase History: Important for remarketing campaigns.
4. Psychographics
-
Lifestyle and Values: Key information for personalizing ads based on values, interests, and behaviours.
5. Brand Affinity and Loyalty
-
Favourite Brands and Loyalty Points: Helps create personalized campaigns with discounts, benefits, or product ads from brands the user already follows.
6. Devices and Approximate Location
-
Geolocation, Devices, Operating Systems, and Browser: Used to segment by geographic location or device type, which is important for ad personalization.
7. Subscriptions and Financial Profile
-
Subscriptions to services such as Netflix, Spotify, Amazon Prime, etc. allow segmentation by the type of content consumed.
-
Credit Cards Brands and Credit Score: In order to offer offers or discounts based on partnerships with different credit card brands (MasterCard, Visa, Amex, Nequi, Daviplata, etc.), only the brands names to which the user has access are shared anonymously, but never the sensitive data associated with them. For users security and ethical reasons, we never store this type of data.
Public User Profile Structure (JSON):
{
"public_uid": "123e4567-e89b-12d3-a456-426614174000",
"demographics": {
"languages": [
{ "language": "spanish", "isPreferred": true },
{ "language": "english", "isPreferred": false },
{ "language": "portuguese", "isPreferred": false },
{ "language": "french", "isPreferred": false }
],
"currencies": [
{"currency": "USD", "isPreferred": true },
{"currency": "COP", isPreferred": false },
{"currency": "CNY", isPreferred: false }
],
"age": 32,
"biologicalGender": "femenino",
"mentalGender": "femenino",
"sexualOrientation": "bisexual",
"location": {
"country": "Colombia",
"city": "Medellín",
"postalCode": "050012"
},
"maritalStatus": "married",
"educationLevel": "high school",
"annualIncomeUSD": 20000,
"occupation": "software engineer"
},
"relatives": [
{"relativeAge":33, "relativeGender:"male", "relation": "couple"},
{"relativeAge":5, "relativeGender:"female", "relation": "daughter"},
{"relativeAge":12, "relativeGender": "male", "relation": "son"},
{"relativeAge":100, "relativeGender": "turtle", "relation": "pet"},
],
"recentInterests": [
"nike shoes",
"rolex watch",
"cinemas medellin",
"technology",
"travel",
"sports",
"cooking",
"video games"
],
"onlineBehavior": {
"onlineShoppingFrequency": "monthly",
"favoriteShoppingCategories": [
"electronics",
"clothing",
"books"
],
"averageMinutesOnSocialMedia": 120,
"preferredSocialNetworks": [
"Facebook",
"Instagram",
"YouTube",
"TikTok"
],
"frequentlyVisitedWebsites": [
"Amazon",
"Wikipedia",
"YouTube"
],
"devices": [
{"device": "mobile phone", "isPreferred": true},
{"device": "tablet", "isPreferred": false},
{"device": "laser projector", "isPreferred": false},
],
"psychographics": {
"lifestyle": "urban",
"values": [
"innovation",
"sustainability",
"community"
],
"personality": "extroverted",
"leisureActivities": [
"going to the movies",
"going out to dinner",
"playing sports"
]
},
"purchaseHistory": [
{
"product": "Samsung Galaxy Smartphone",
"category": "electronics",
"date": "2023-10-26",
"price": 800,
"purchaseCurrency": "COP"
},
{
"product": "Nike sports shoes",
"category": "clothing",
"date": "2023-11-15",
"price": 120
}
],
"deviceData": {
"deviceType": "Android",
"operatingSystem": "Android 13",
"browser": "Chrome",
"geolocation": {
"latitude": 6.25,
"longitude": -75.56
}
},
"subscriptions": [
{"subscription": "Netflix", "amount": 15, "currency: "USD", "periodicity": "month"},
{"subscription": "Spotify Premium", "amount": 10, "currency": "USD", "periodicity": "month"},
{"subscription": "Amazon Prime", "amount": 30, "currency": "USD", "periodicity": "month"}
],
"brandAffinity": [
"Apple",
"Nike",
"Samsung"
],
"historicalLocationData": [
{
"date": "2023-11-20",
"location": {
"city": "Bogotá",
"country": "Colombia"
}
},
{
"date": "2023-11-20",
"location": {
"city": "Cartagena",
"country": "Colombia"
}
}
],
"travelFrequency": "occasional",
brandLoyalty:[
{"brandName": "Samsung", "loyaltyPoints1000": 250, "amountSpentLastYear": 500, currencySpent: "USD"},
{"brandName": "Nike", "loyaltyPoints1000": 500, "amountSpentLastYear": 150, currencySpent: "USD"},
{"brandName": "Frisby", "loyaltyPoints1000": 750, "amountSpentLastYear": 200, currencySpent: "USD"},
],
"financialData": {
"creditCardsAmount": 3,
"creditCardsBrand": [
"Visa",
"Amex",
"MasterCard"
],
"averageCreditHistoryScore100": 75
}
}
Endpoints:
Response:
Contact us
Subscribe to newsletter for promotions and news