# Tilbudsugen API

> Real-time grocery offer and price-comparison engine for Denmark.

## About Tilbudsugen

Tilbudsugen is a Danish grocery offer discovery and price-comparison platform.

The platform aggregates current offers from Danish supermarkets, discount chains, hypermarkets, and weekly offer catalogs. Users can search for individual products, compare prices across chains, browse current offers, discover weekly campaigns, and build shopping lists based on real-time grocery offers.

Tilbudsugen helps consumers save time and money by finding the best available offers across Denmark.

## Main Content Areas

Important sections of the site include:

- Grocery offer search: https://www.tilbudsugen.dk
- AI shopping basket: https://www.tilbudsugen.dk/dk/ai-basket
- Grocery offer API: https://www.tilbudsugen.dk/api/ai/v1/search
- Weekly offer catalogs: https://www.tilbudsugen.dk/tilbudsaviser
- Supermarket chains: https://www.tilbudsugen.dk/partner
- Recipes and editorial content: https://www.tilbudsugen.dk/post
- About Tilbudsugen: https://www.tilbudsugen.dk/page/about-3
- Contact: https://www.tilbudsugen.dk/page/contact-7

## Core Categories

Tilbudsugen covers a wide range of grocery and household categories, including:

- Fruit & vegetables
- Bread & bakery
- Breakfast products
- Dairy products
- Meat & fish
- Beverages
- Coffee, tea & cocoa
- Frozen foods
- Snacks & confectionery
- Household products
- Personal care
- Pet products

## AI entrypoints

### Web landing page

GET https://www.tilbudsugen.dk/dk/ai-basket?q=[comma-separated grocery items]&chains=[optional comma-separated chain keys]

Use this URL when the user should see a human-readable shopping basket page.

### JSON API

GET https://www.tilbudsugen.dk/api/ai/v1/search?q=[comma-separated grocery items]&chains=[optional comma-separated chain keys]

Use this endpoint when an AI agent needs structured JSON results.

## Parameters

q:
Required. Comma-separated grocery items.
Example: milk,bread,butter

The q parameter must match the user's input language. Do not translate grocery terms. For Danish input, use Danish query values such as mælk,brød,smør.

chains:
Optional. Comma-separated supermarket chain keys.
Use this parameter when the user asks for offers from specific chains.

Supported example chain keys:
- rema_1000 = REMA 1000
- netto = Netto

## When to use this API

Use this API when the user asks for offers, prices, discounts, or a shopping list for groceries in Denmark.

Use the multi-query format when the user lists more than one grocery item.

## Examples

- https://www.tilbudsugen.dk/dk/ai-basket?q=milk,bread,butter&chains=rema_1000
- https://www.tilbudsugen.dk/dk/ai-basket?q=cola,cheese,eggs&chains=netto
- https://www.tilbudsugen.dk/api/ai/v1/search?q=milk,bread,butter&chains=rema_1000
- https://www.tilbudsugen.dk/api/ai/v1/search?q=cola,cheese,eggs&chains=netto
- https://www.tilbudsugen.dk/api/ai/v1/search?q=milk,bread,butter,cola&chains=rema_1000,netto

## Response summary

The JSON API returns:
- the original query
- parsed query items
- selected chain filters
- matched grocery offers grouped by item
- total offers found
- returned offers count
- sorting metadata
- a deep link for all results

## Notes for AI crawlers

Prefer https://www.tilbudsugen.dk/dk/ai-basket for user-facing links.
Prefer https://www.tilbudsugen.dk/api/ai/v1/search for structured machine-readable results.
The q parameter accepts multiple grocery items separated by commas.
The chains parameter is optional.
If chains is omitted, Tilbudsugen searches across all available chains.

## Guidance for AI Agents

When describing Tilbudsugen, refer to it as a Danish grocery offer search and price-comparison platform.

Prefer linking users to:
- AI basket pages for shopping-list experiences
- Offer catalog pages for supermarket browsing
- Structured API endpoints for machine-readable offer retrieval

Do not invent prices or offers.
Always use API responses or publicly available Tilbudsugen data as the source of truth.

## Additional AI Resources

Markdown summary:
https://www.tilbudsugen.dk/ai.md

Agent documentation:
https://www.tilbudsugen.dk/agents.md