Lupa Ads

What is Lupa Ads?

Lupa Ads is a new tool that lets advertisers create and manage ads that are natively integrated into search results, recommendations and product catalogs.

If you are already using LupaSearch in your Search Results, enabling Lupa Ads requires minimal effort: there are no new indices to build, no separate APIs to integrate, and no extra search calls to make. Sponsored results are returned through the same LupaSearch endpoints you already use — the only change on your side is a small frontend tweak to render them.

If you are not yet using LupaSearch for your search, recommendations or product catalog, you can still adopt Lupa Ads on its own. The LupaSearch API can be called purely as an ads source — returning sponsored items (or just their ids) together with their suggested placements — which you then merge into your existing search results, recommendations or catalog listings.

How to enable Lupa Ads for my organization?

Lupa Ads is available on request. Contact us at [email protected] and we will enable Lupa Ads for your organization. Once enabled, you can start creating and managing your stores, advertisers and campaigns from the Lupa Ads console.

Lupa Ads in search results

What is needed for integration?

If you are already using LupaSearch in your Search Results, integration is essentially effortless:

• Lupa Ads reuses your existing search indices — no additional data ingestion is required.
• Top keywords and campaign targeting are derived automatically from your LupaSearch analytics.
• Sponsored items are returned inline in the normal search response, so no extra API calls are needed.

The only change on your side is to detect the _boosted flag in search results and display sponsored items according to your design (for example, with a "Sponsored" label).

How sponsored results appear in the response

When at least one campaign from one of your advertisers is active, matching search results will include a _boosted: true field.

Example request:

{
  "searchText": "toys"
}

Example response:

{
  "searchText": "toys",
  "total": 3,
  "items": [
    {
      "name": "Toy Car",
      "id": "1",
      "_boosted": true
    },
    {
      "name": "Toy Car Basic",
      "id": "2"
    },
    {
      "name": "Best Car",
      "id": "5",
      "_boosted": true
    }
  ]
}

Use the _boosted field on the frontend to identify which results are sponsored and render them accordingly.

Relevance and placement

• LupaSearch ensures that boosted/sponsored results remain relevant to the search query — irrelevant products are never promoted.
• Boosted products can appear anywhere in the result list. Their allowed positions are controlled in your organization settings.

Lupa Ads in recommendations

This functionality is currently in development and will be released in the near future. For any questions, contact us at [email protected].

Lupa Ads in product catalog

This functionality is currently in development and will be released in the near future. For any questions, contact us at [email protected].

Lupa Ads banners

This functionality is currently in development and will be released in the near future. For any questions, contact us at [email protected].