# Lomadee Products module

#### How to get your API Token

1. Log in to your Lomadee account.
2. In the **bottom-left** of the page, click your **username** (profile menu).
3. Click **“Credenciais de API”**.
4. Copy your **Token** and paste it into the Content Egg → Modules → Lomadee Products module settings.

<div><figure><img src="/files/hu1wthSBRzlfOkgb8bPt" alt=""><figcaption></figcaption></figure> <figure><img src="/files/aC6KFs2ul4XZLgzF4NZL" alt=""><figcaption></figcaption></figure></div>

### Lomadee API limits and important notes

#### 1) Rate limit (very low)

Lomadee’s API limit is **10 requests per minute**.

Keep in mind:

* **Each product search** = **1 request**
* **Each affiliate link generation** = **1 request**

This can be reached quickly, especially on pages with many products.

#### 2) Search can include advertisers you’re not approved for

The Lomadee product search API can return products from the **full catalog**, including advertisers:

* you are **not approved** for yet, or
* that are **not allowed** for affiliate links in your account.

Because of this, it’s recommended to set:

**Advertiser (Organization) IDs**\
Add a comma-separated list of advertiser Organization IDs (UUIDs) to **limit results** to advertisers you actually want to use (and ideally are approved for).

If you leave it empty, searches may return products from any advertiser, and some affiliate links may not be possible to generate.

#### 3) Affiliate links are generated later (not during search)

When you search products, Content Egg saves the product data first.

Affiliate (short) links are generated **later**, in a **small batch**, when products are **displayed on the frontend for the first time**.

What you may notice:

* The first page load with Lomadee products can be **slower**, because link generation happens during display.
* If the API limit is hit, the plugin will skip link generation for now and try again later.

#### 4) Approval required (admin notice + auto retry)

If you add a product from an advertiser that requires approval, Lomadee may refuse to generate the affiliate link and return a message like:

**“Organization approval is required to generate links.”**

In this case:

* The product can still appear, but it will use the **direct (non-affiliate) URL** until approval is granted.
* You’ll see a **warning notice** in the WordPress admin dashboard.
* The plugin will automatically retry generating the affiliate link **every 24 hours**.

<figure><img src="/files/cYAj2yaxMPA2qlkf7PdZ" alt="" width="375"><figcaption></figcaption></figure>

#### 5) No direct prices/stock updates

Lomadee API does **not** provide a reliable way to refresh existing items by product ID (to update **price** and **availability** for already saved products).

Recommended workaround:

* Use Content Egg’s [**update by keyword**](/updating-products/updating-the-product-list.md) feature to periodically re-run the search and refresh the product list.


---

# Agent Instructions: 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:

```
GET https://ce-docs.keywordrush.com/modules/affiliate/lomadeeproducts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.