top of page
Coffee_Pie_Logo_edited.png

Computing Service

Coffee Pie®

Coffee Pie® Ads API/MCP
Documentation

Advertising Content Policies

All ads, campaigns, and creatives submitted through our API are subject to review to ensure compliance with these guidelines and guarantee a safe and positive experience for our community. We reserve the right to reject, pause, or remove any ad at our sole discretion.

1. Prohibited Content:
The promotion of the following is strictly prohibited:

  • Illegal Content: Including, but not limited to, illicit drugs, counterfeit products, and services that violate the law.

  • Hate and Discrimination: Content that attacks or degrades groups based on race, religion, gender, sexual orientation, or disability.

  • Violence and Disturbing Content: Incitement to violence, terrorism, animal cruelty, or graphic images of harm.

  • Weapons and Explosives: Promotion of the sale of firearms, ammunition, or explosive materials.

  • Deceptive Practices: Scams, malware, phishing, or fraudulent financial promises.


2. Restricted Content:
The following categories are subject to strict review and may require prior authorization, licenses, or specific targeting (geographic and age-based):

  • Political and religious.

  • Gambling and betting.

  • Health and pharmaceutical products.

  • Financial services and cryptocurrencies.

  • Psychoactive substances such as alcohol, tobacco, cannabis, and related products.

  • Sexually explicit content such as pornography, explicit nudity, or sexual services.


3. Review and Compliance Process
Review may be automated (using filters) or manual. Repeated or serious violations of these policies will result in the suspension or termination of the advertiser's access to our API.

Consumption Patterns Tracking Data (Free Tier):

*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 API or the Model Context Protocol (MCP).

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", "Tesla Model 3", 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 in our API, but never the sensitive data associated with them, since for users security and ethical reasons, we abstain from storing such type of data.
     

Request Structure (JSON):
 

{
  "request_id": "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,
    "occupations": ["software engineer", "accountant"]
  },

"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},

    ],

 "favDeviceData": {
    "deviceType": "Android",
    "operatingSystem": "Android 13",
    "browser": "Chrome",
    "geolocation": {
      "latitude": 6.25,
      "longitude": -75.56
    }
  "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
    }
  ]
  },

"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

bottom of page