> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Social proofing

> Build social proofing experiences using product interaction data, including stock alerts, popularity counters, discount highlights, and combined proof messages.

Use the **Kameleoon Activation API** with the [`obtainProductInteractions()`](../../developer-docs/apis/activation-api-js/api-reference/api-reference#obtainproductinteractions) and [`obtainProductData`](../../developer-docs/apis/activation-api-js/api-reference/api-reference#obtainproductdata) endpoints for powerful **social proofing implementations**. Refer to the [Get started](./get-started) article for more details.

Below are some of the **possible types of social proofing experiences** you can generate, based on the [tracking](../../developer-docs/apis/activation-api-js/api-reference/api-reference#api-response-3) and [product](../../developer-docs/apis/activation-api-js/api-reference/api-reference#product) data accessible with the `obtainProductInteractions()` and `ProductData()` endpoints.

***

## Urgency and scarcity messages

| Social proofing type      | Example message                          | Key product fields used                       | Purpose                                                 | Endpoint used       |
| ------------------------- | ---------------------------------------- | --------------------------------------------- | ------------------------------------------------------- | ------------------- |
| **Low stock alert**       | “Only **2 left in stock** — order soon!” | `availableQuantity`, `available`, `leftovers` | Creates urgency to purchase before stock runs out.      | `obtainProductData` |
| **Single item remaining** | “Last **one** available!”                | `leftovers = one`                             | Reinforces scarcity for exclusive or trending products. | `obtainProductData` |
| **Limited quantities**    | “Hurry, just a **few items** left!”      | `leftovers = few` or `availableQuantity`      | Encourages faster decision-making.                      | `obtainProductData` |

***

## Popularity and demand indicators

| Social proofing type      | Example message                             | Key product fields used | Purpose                                                | Endpoint used               |
| ------------------------- | ------------------------------------------- | ----------------------- | ------------------------------------------------------ | --------------------------- |
| **Product views counter** | “**243 people** viewed this product today.” | `views`                 | Shows high demand to build FOMO (fear of missing out). | `obtainProductInteractions` |
| **Purchase counter**      | “**57 people** bought this item this week.” | `boughtQuantities`      | Indicates sales volume to boost credibility.           | `obtainProductInteractions` |

## Price-based and promotional proofs

| Social proofing type   | Example message                   | Key product fields used             | Purpose                       | Endpoint used       |
| ---------------------- | --------------------------------- | ----------------------------------- | ----------------------------- | ------------------- |
| **Discount highlight** | “Save **20%** today!”             | `price`, `oldPrice`                 | Emphasizes savings.           | `obtainProductData` |
| **Limited-time offer** | “This price ends in **2 hours**!” | `price`, `oldPrice`, time condition | Creates urgency around deals. | `obtainProductData` |

***

## Marketplace and multi-seller proofing

| Social proofing type   | Example message                        | Key product fields used | Purpose                                  | Endpoint used       |
| ---------------------- | -------------------------------------- | ----------------------- | ---------------------------------------- | ------------------- |
| **Seller credibility** | “Sold by **Merchant123**, rated 4.9★.” | `merchantID`            | Reinforces trust in third-party sellers. | `obtainProductData` |

***

### Combined proofs

You can combine multiple parameters to create **hybrid messages**, for example:

* “Only **2 left**—and **57 bought** this week!” → uses `availableQuantity` + `boughtQuantities`
* “**Trending** in **Laptops**—rated **4.7/5**!” → uses `categories` + `rating`
* “**Few left** in stock for the **Sony WH-1000XM5**!” → uses `brand` + `leftovers`