> For the complete documentation index, see [llms.txt](https://docs.claimr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.claimr.io/extra/kols.md).

# KOLs

## **Understanding KOLs**

KOLs, or Key Opinion Leaders, are individuals who have built a strong online presence and influence within a particular niche or community. They are often seen as experts or trusted sources of information, and their opinions and recommendations can significantly impact the decisions of their followers.

## **Benefits of using KOLs**

**Increased reach:** KOLs can significantly expand the reach of your claimr campaigns. Their established audience and online presence can introduce your campaigns to a wider range of potential participants, increasing visibility and attracting new users.

**Enhanced credibility:** KOLs often have a high level of trust and credibility within their communities. By partnering with them, you can leverage this trust to enhance the perceived value and legitimacy of your campaigns, encouraging more users to participate.

**Targeted promotion:** KOLs can effectively promote specific aspects of your campaigns or target particular user segments. This allows you to tailor your message and reach the most relevant audience for your campaign goals.

**Performance tracking:** claimr provides tools to track the performance of your KOL partnerships. You can monitor metrics such as the number of referrals, completed tasks, and overall engagement generated by each KOL, allowing you to measure the effectiveness of your collaborations and optimize your strategies.

## **Setting up KOLs**

1. **Access the KOLs section:** Navigate to the **Events** section in the claimr admin panel and select the **KOLs** tab.

<figure><img src="/files/ut3ID90IaEzAnApWJRIF" alt=""><figcaption><p>KOLs pannel</p></figcaption></figure>

2. **Create a new KOL entry:** Click <mark style="color:green;">**Create**</mark> button to add a new KOL entry.
3. **Set up KOL details:**

<figure><img src="/files/igPclXBy7fiGvbaQEoAO" alt="" width="375"><figcaption><p>KOLs settings</p></figcaption></figure>

* **Name:** Enter the name of the KOL.
* **KOL ID (optional):** Assign a custom ID to the KOL for internal management. This ID must be 8 to 24 characters long and can only contain letters, numbers, hyphens, and underscores.
* **Ref Link:**

  **Base link:** Provide the base URL for the KOL's referral link. This should be a link to a page with a claimr widget, such as a landing page or a client's website.

  **Referral ID tag:** Select a tag that will be appended to the base link to create the unique referral link: "ref" or "invite".&#x20;

4. **Save the KOL entry:** Click <mark style="color:green;">**Create**</mark> to save the new KOL entry. This will generate a unique KOL referral link, including the specified tag and the KOL's ID.

## **Tracking KOL performance**

⚡️claimr provides a table in the KOLs section to track the performance of your KOLs. It includes:

* **Name:** The name of the KOL.
* **Link ID:** The unique ID associated with the KOL's referral link.
* **Link:** The full referral link the KOL can share with their audience.
* **Valid referrals:** The number of users who joined your campaign through the KOL's unique referral link and performed a qualifying action.
* **Total referrals:** The total number of referrals attributed to the KOL, including those who may not have completed any actions.
* **XP:** The total amount of XP earned by the KOL's referrals.
* **Completed \[X] tasks:** The number of users referred by the KOL who have completed a specific number of tasks (1, 3, 5, 7, and 10).

## **Presenting KOLs to users**

When users click on a KOL's unique referral link they are directed to a page with a claimr widget.&#x20;

<figure><img src="/files/4wHiGOXG1x0WShJG6g9q" alt="" width="375"><figcaption><p>Example</p></figcaption></figure>

A typical KOL widget might display the title, the rewards information, a brief instruction ("Click to earn 10 XP"), and a button.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.claimr.io/extra/kols.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.