Computing Service
Coffee Pie®
Coffee Pie® Ads API/MCP
Documentation
*Disclaimer: We will never sell or share with unauthorized third parties sensitive user data such as real name, real ID, phone numbers, email address, physical address, IP address, full postal code, etc. Only an auditable anonymized model with generic market segmentation information is shared in our API, so that the free tier service is transparent without being invasive View Privacy Policy. 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 advertising on our massive and highly segmented platform, using the Model Context Protocol (MCP).
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.
-
Relatives: Segments are made if there are relatives in the user's environment (such as children, nephews, neighbours, pets, etc) without sensitive data about them, only their age, gender and relation for segmentation purposes like christmas, halloween, valentine's day, etc.
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 provide 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 abstain from storing such 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
}
}
---
MCP Manifest (https://api.coffeepie.org/.well-known/manifest.json):
{
"tools": [
{
"name": "segment_audience",
"description": "Segments the target audience according to age, interests and location",
"input_schema": {
"type": "object",
"properties": {
"age_range": { "type": "string", "description": "Age range (ej: '18-24')" },
"interests": { "type": "array", "items": { "type": "string" }, "description": "Intereses list" },
"location": { "type": "string", "description": "Geographical location" }
},
"required": ["age_range", "interests", "location"]
},
"output_schema": {
"type": "object",
"properties": {
"segment_id": { "type": "string" },
"estimated_users": { "type": "number" },
"conversion_score": { "type": "number" }
}
},
"handler": {
"type": "http",
"url": "https://api.coffeepie.org/ads/segment",
"method": "POST",
"headers": {
"Authorization": "Bearer {{API_KEY}}",
"Content-Type": "application/json"
}
}
}
]
}
Endpoints:
Response:
Contact us
Subscribe to newsletter for promotions and news