Lomadee Products module

Lomadee module setup

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.

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.

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 feature to periodically re-run the search and refresh the product list.