Mergado MCP Server

This domain hosts the MCP (Model Context Protocol) server for Mergado. It provides a unified interface for AI assistants to access Mergado tools, product feeds, and data management capabilities.Tato doména hostuje MCP (Model Context Protocol) server pro Mergado. Poskytuje jednotné rozhraní pro přístup AI asistentů k nástrojům Mergado, produktovým feedům a dalším funkcím platformy.Táto doména hostuje MCP (Model Context Protocol) server pre Mergado. Poskytuje jednotné rozhranie pre prístup AI asistentov k nástrojom Mergado, produktovým feedom a ďalším funkciám platformy.Ez a domain a Mergado MCP (Model Context Protocol) szerverét szolgálja ki. Egységes felületet biztosít az AI asszisztensek számára a Mergado eszközeihez, termékfeedjeihez és adatkezelési funkcióihoz.

Contact supportKontaktovat podporuKontaktovať podporuKapcsolat a támogatással

Getting StartedJak se připojitAko sa pripojiťElső lépések

AuthenticationAutentizaceAutentifikáciaHitelesítés

The Mergado MCP server requires authentication. There are two ways:Mergado MCP server vyžaduje autentizaci. Existují dva způsoby:Mergado MCP server vyžaduje autentifikáciu. Existujú dva spôsoby:A Mergado MCP szerver hitelesítést igényel. Két módja van:

Sign in through your client (Recommended)Přihlášení přes klienta (doporučeno)Prihlásenie cez klienta (odporúčané)Bejelentkezés a kliensen keresztül (ajánlott)

Some MCP clients (like ChatGPT or Claude) have sign-in built right into MCP. Just add the MCP server URL and the client redirects you to log in and authorize access to Mergado on its own - no token or manual setup needed.Někteří MCP klienti (např. ChatGPT nebo Claude) mají přihlášení zabudované přímo v MCP. Stačí zadat URL MCP serveru a klient vás sám přesměruje na přihlášení a autorizaci do Mergada - žádný token ani jeho ruční nastavení není potřeba.Niektorí MCP klienti (napr. ChatGPT alebo Claude) majú prihlásenie zabudované priamo v MCP. Stačí zadať URL MCP servera a klient vás sám presmeruje na prihlásenie a autorizáciu do Mergada - žiadny token ani jeho ručné nastavenie nie je potrebné.Egyes MCP kliensekben (például a ChatGPT-ben vagy a Claude-ban) a bejelentkezés közvetlenül az MCP-be van építve. Elég megadni az MCP szerver URL-jét, és a kliens magától átirányítja Önt a Mergadóba való bejelentkezésre és engedélyezésre - nincs szükség tokenre vagy kézi beállításra.

Client registration is automatic. The client registers itself with the server on first connect - there's nothing to create or fill in by hand.Registrace klienta probíhá automaticky. Klient se k serveru zaregistruje sám při prvním připojení - nemusíte nic ručně vytvářet ani nikam vyplňovat.Registrácia klienta prebieha automaticky. Klient sa k serveru zaregistruje sám pri prvom pripojení - nemusíte nič ručne vytvárať ani nikam vypĺňať.A kliens regisztrációja automatikusan történik. A kliens az első csatlakozáskor magától regisztrál a szerveren - semmit nem kell kézzel létrehoznia vagy kitöltenie.

Bearer tokenBearer tokenBearer tokenBearer token

Clients that don't support signing in through MCP use a Personal Access Token (PAT). Add it to every request in the Authorization header:Klienti, kteří přihlášení přes MCP nepodporují, použijí Personal Access Token (PAT). Přidejte jej do každého požadavku v hlavičce Authorization:Klienti, ktorí prihlásenie cez MCP nepodporujú, použijú Personal Access Token (PAT). Pridajte ho do každej požiadavky v hlavičke Authorization:Azok a kliensek, amelyek nem támogatják az MCP-n keresztüli bejelentkezést, Personal Access Tokent (PAT) használnak. Adja hozzá minden kéréshez az Authorization fejlécben:

Authorization: Bearer YOUR_TOKEN

You can create a PAT in your Mergado account: Personal Access Token ->PAT vytvoříte v nastavení svého účtu Mergado: Osobní přístupový token ->PAT vytvoríte v nastavení svojho účtu Mergado: Osobný prístupový token ->PAT-ot a Mergado fiókja beállításaiban hozhat létre: Személyes hozzáférési token ->

Server URLURL serveruURL serveraA szerver URL-je

The Mergado MCP server URL is:URL Mergado MCP serveru je:URL Mergado MCP servera je:A Mergado MCP szerver URL-je: 

https://mcp.mergado.com

Client SetupNastavení klientaNastavenie klientaA kliens beállítása

Select your MCP client to see the setup instructions.Vyberte svého MCP klienta a zobrazte pokyny k nastavení.Vyberte svojho MCP klienta a zobrazte pokyny na nastavenie.Válassza ki az MCP kliensét a beállítási útmutató megjelenítéséhez.

ChatGPT supports remote MCP servers with built-in sign-in.ChatGPT podporuje vzdálené MCP servery se zabudovaným přihlášením.ChatGPT podporuje vzdialené MCP servery so zabudovaným prihlásením.A ChatGPT beépített bejelentkezéssel támogatja a távoli MCP szervereket.

  1. Enable Developer mode in Settings -> Apps -> Advanced settingsZapněte Developer mode v Settings -> Apps -> Advanced settingsZapnite Developer mode v Settings -> Apps -> Advanced settingsKapcsolja be a Developer mode beállítást itt: Settings -> Apps -> Advanced settings
  2. Go to Settings -> Apps -> Create appPřejděte do Settings -> Apps -> Create appPrejdite do Settings -> Apps -> Create appLépjen a Settings -> Apps -> Create app menüpontra
  3. Paste the MCP server URL: https://mcp.mergado.comVložte URL MCP serveru: https://mcp.mergado.comVložte URL MCP servera: https://mcp.mergado.comIllessze be az MCP szerver URL-jét: https://mcp.mergado.com
  4. ChatGPT will handle authorization automatically - you'll be redirected to log inChatGPT provede autorizaci automaticky - budete přesměrováni na přihlášeníChatGPT vykoná autorizáciu automaticky - budete presmerovaní na prihlásenieA ChatGPT automatikusan elvégzi az engedélyezést - át lesz irányítva a bejelentkezésre
  5. After authorizing, the server tools will be available in your conversationsPo autorizaci budou nástroje serveru dostupné ve vašich konverzacíchPo autorizácii budú nástroje servera dostupné vo vašich konverzáciáchAz engedélyezés után a szerver eszközei elérhetők lesznek a beszélgetéseiben
Remote MCP servers in ChatGPT require a Plus, Pro, Business, Enterprise, or Edu plan with Developer mode enabled.Vzdálené MCP servery v ChatGPT vyžadují plán Plus, Pro, Business, Enterprise nebo Edu se zapnutým Developer mode.Vzdialené MCP servery v ChatGPT vyžadujú plán Plus, Pro, Business, Enterprise alebo Edu so zapnutým Developer mode.A távoli MCP szerverekhez a ChatGPT-ben Plus, Pro, Business, Enterprise vagy Edu előfizetés szükséges, bekapcsolt Developer mode mellett.

Claude.ai supports remote MCP servers with built-in sign-in.Claude.ai podporuje vzdálené MCP servery se zabudovaným přihlášením.Claude.ai podporuje vzdialené MCP servery so zabudovaným prihlásením.A Claude.ai beépített bejelentkezéssel támogatja a távoli MCP szervereket.

  1. Open claude.ai -> Settings -> ConnectorsOtevřete claude.ai -> Settings -> ConnectorsOtvorte claude.ai -> Settings -> ConnectorsNyissa meg a claude.ai -> Settings -> Connectors menüpontot
  2. Click Add custom connector and paste the MCP server URLKlikněte na Add custom connector a vložte URL MCP serveruKliknite na Add custom connector a vložte URL MCP serveraKattintson az Add custom connector gombra, és illessze be az MCP szerver URL-jét
  3. Claude will redirect you to log in and authorizeClaude vás přesměruje na přihlášení a autorizaciClaude vás presmeruje na prihlásenie a autorizáciuA Claude átirányítja Önt a bejelentkezésre és az engedélyezésre
  4. Once connected, the server tools will appear in your conversationsPo připojení se nástroje serveru zobrazí ve vašich konverzacíchPo pripojení sa nástroje servera zobrazia vo vašich konverzáciáchA csatlakozás után a szerver eszközei megjelennek a beszélgetéseiben
Custom connectors are available on the Free, Pro, Max, Team, and Enterprise plans (Free is limited to one connector). On Team and Enterprise, only Owners can add a connector.Vlastní konektory jsou dostupné v plánech Free, Pro, Max, Team a Enterprise (Free je omezen na jeden konektor). V plánech Team a Enterprise může konektor přidat pouze vlastník (Owner).Vlastné konektory sú dostupné v plánoch Free, Pro, Max, Team a Enterprise (Free je obmedzený na jeden konektor). V plánoch Team a Enterprise môže konektor pridať iba vlastník (Owner).Az egyéni konnektorok a Free, Pro, Max, Team és Enterprise csomagokban érhetők el (a Free egyetlen konnektorra van korlátozva). A Team és Enterprise csomagokban konnektort csak a tulajdonos (Owner) adhat hozzá.

Claude Desktop supports remote MCP servers via its configuration file.Claude Desktop podporuje vzdálené MCP servery přes konfigurační soubor.Claude Desktop podporuje vzdialené MCP servery cez konfiguračný súbor.A Claude Desktop konfigurációs fájlon keresztül támogatja a távoli MCP szervereket.

  1. Open Claude Desktop -> Settings -> Developer -> Edit ConfigOtevřete Claude Desktop -> Settings -> Developer -> Edit ConfigOtvorte Claude Desktop -> Settings -> Developer -> Edit ConfigNyissa meg a Claude Desktopot -> Settings -> Developer -> Edit Config
  2. Edit the file claude_desktop_config.json:Upravte soubor claude_desktop_config.json:Upravte súbor claude_desktop_config.json:Szerkessze a claude_desktop_config.json fájlt:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonmacOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonmacOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonmacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.jsonWindows: %APPDATA%\Claude\claude_desktop_config.jsonWindows: %APPDATA%\Claude\claude_desktop_config.jsonWindows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mergado": {
      "url": "https://mcp.mergado.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

If your Claude Desktop version doesn't support remote HTTP MCP servers directly, use the mcp-remote bridge via npx (requires Node.js):Pokud vaše verze Claude Desktop nepodporuje vzdálené HTTP MCP servery přímo, použijte mcp-remote bridge přes npx (vyžaduje Node.js):Ak vaša verzia Claude Desktop nepodporuje vzdialené HTTP MCP servery priamo, použite mcp-remote bridge cez npx (vyžaduje Node.js):Ha az Ön Claude Desktop verziója nem támogatja közvetlenül a távoli HTTP MCP szervereket, használja az mcp-remote bridge-et npx-en keresztül (Node.js szükséges hozzá):

{
  "mcpServers": {
    "mergado-npx": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mergado.com",
        "--header",
        "Authorization: Bearer YOUR_TOKEN"
      ]
    }
  }
}
After saving, fully quit and relaunch Claude Desktop. Closing the window isn't enough - on Windows and macOS it keeps running in the system tray. Right-click the tray icon and choose Quit (or Cmd + Q on macOS) before launching again.Po uložení Claude Desktop zcela ukončete a znovu spusťte. Zavření okna nestačí - na Windows a macOS běží na pozadí v systémové liště. Klikněte pravým tlačítkem na ikonu v liště a zvolte Quit (nebo Cmd + Q na macOS).Po uložení Claude Desktop úplne ukončite a znova spustite. Zatvorenie okna nestačí - na Windows a macOS beží na pozadí v systémovej lište. Kliknite pravým tlačidlom na ikonu v lište a zvoľte Quit (alebo Cmd + Q na macOS).Mentés után teljesen lépjen ki a Claude Desktopból, majd indítsa újra. Az ablak bezárása nem elég - Windowson és macOS-en a háttérben, a tálcán tovább fut. Kattintson jobb gombbal a tálcaikonra, és válassza a Quit lehetőséget (vagy Cmd + Q macOS-en).

Add an MCP server using the claude mcp add command:Přidejte MCP server příkazem claude mcp add:Pridajte MCP server príkazom claude mcp add:Adja hozzá az MCP szervert a claude mcp add paranccsal:

claude mcp add mergado \
  --transport http \
  https://mcp.mergado.com \
  --header "Authorization: Bearer YOUR_TOKEN"

Or add it to the .mcp.json file in your project root:Nebo jej přidejte do souboru .mcp.json v kořenovém adresáři projektu:Alebo ho pridajte do súboru .mcp.json v koreňovom adresári projektu:Vagy adja hozzá a projekt gyökerében lévő .mcp.json fájlhoz:

{
  "mcpServers": {
    "mergado": {
      "type": "http",
      "url": "https://mcp.mergado.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Cursor supports remote MCP servers via its settings.Cursor podporuje vzdálené MCP servery přes nastavení.Cursor podporuje vzdialené MCP servery cez nastavenia.A Cursor a beállításokon keresztül támogatja a távoli MCP szervereket.

  1. Open Cursor -> Settings -> MCPOtevřete Cursor -> Settings -> MCPOtvorte Cursor -> Settings -> MCPNyissa meg a Cursor -> Settings -> MCP menüpontot
  2. Click Add new MCP serverKlikněte na Add new MCP serverKliknite na Add new MCP serverKattintson az Add new MCP server gombra
  3. Select type HTTP and enter the server URLVyberte typ HTTP a zadejte URL serveruVyberte typ HTTP a zadajte URL serveraVálassza a HTTP típust, és adja meg a szerver URL-jét

Or add it to .cursor/mcp.json in your project:Nebo jej přidejte do .cursor/mcp.json ve vašem projektu:Alebo ho pridajte do .cursor/mcp.json vo vašom projekte:Vagy adja hozzá a projektjében lévő .cursor/mcp.json fájlhoz:

{
  "mcpServers": {
    "mergado": {
      "url": "https://mcp.mergado.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Windsurf supports MCP servers via its configuration file.Windsurf podporuje MCP servery přes konfigurační soubor.Windsurf podporuje MCP servery cez konfiguračný súbor.A Windsurf konfigurációs fájlon keresztül támogatja az MCP szervereket.

  1. Open Windsurf -> Settings -> search for MCPOtevřete Windsurf -> Settings -> vyhledejte MCPOtvorte Windsurf -> Settings -> vyhľadajte MCPNyissa meg a Windsurf -> Settings menüt -> keressen rá az MCP kifejezésre
  2. Click Add Server or edit ~/.codeium/windsurf/mcp_config.jsonKlikněte na Add Server nebo upravte ~/.codeium/windsurf/mcp_config.jsonKliknite na Add Server alebo upravte ~/.codeium/windsurf/mcp_config.jsonKattintson az Add Server gombra, vagy szerkessze a ~/.codeium/windsurf/mcp_config.json fájlt
{
  "mcpServers": {
    "mergado": {
      "serverUrl": "https://mcp.mergado.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

VS Code supports MCP servers through GitHub Copilot's agent mode.VS Code podporuje MCP servery prostřednictvím agent módu GitHub Copilotu.VS Code podporuje MCP servery prostredníctvom agent módu GitHub Copilotu.A VS Code a GitHub Copilot agent módján keresztül támogatja az MCP szervereket.

  1. Make sure you have the GitHub Copilot extension installedUjistěte se, že máte nainstalované rozšíření GitHub CopilotUistite sa, že máte nainštalované rozšírenie GitHub CopilotGyőződjön meg róla, hogy telepítve van a GitHub Copilot bővítmény
  2. Create a .vscode/mcp.json file in your projectVytvořte soubor .vscode/mcp.json ve svém projektuVytvorte súbor .vscode/mcp.json vo svojom projekteHozza létre a .vscode/mcp.json fájlt a projektjében
{
  "servers": {
    "mergado": {
      "type": "http",
      "url": "https://mcp.mergado.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Alternatively, add it to your VS Code settings.json under the "mcp" key.Případně jej přidejte do settings.json VS Code pod klíč "mcp".Prípadne ho pridajte do settings.json VS Code pod kľúč "mcp".Vagy adja hozzá a VS Code settings.json fájljához az "mcp" kulcs alatt.

OpenWebUI supports MCP servers at two levels - globally for all users (admin), or per-user.OpenWebUI podporuje MCP servery na dvou úrovních - globálně pro všechny uživatele (admin), nebo pro jednotlivé uživatele.OpenWebUI podporuje MCP servery na dvoch úrovniach - globálne pre všetkých používateľov (admin), alebo pre jednotlivých používateľov.Az OpenWebUI két szinten támogatja az MCP szervereket - globálisan, minden felhasználó számára (admin), vagy az egyes felhasználók számára külön.

Admin-level (shared with all users)Admin úroveň (sdíleno se všemi uživateli)Admin úroveň (zdieľané so všetkými používateľmi)Admin szint (minden felhasználóval megosztva)

  1. Open Admin Panel -> Settings -> External ToolsOtevřete Admin Panel -> Settings -> External ToolsOtvorte Admin Panel -> Settings -> External ToolsNyissa meg az Admin Panel -> Settings -> External Tools menüpontot
  2. Click Add Connection, then click OpenAPI (it should switch to MCP Streamable HTTP)Klikněte na Add Connection, pak na OpenAPI (přepne se na MCP Streamable HTTP)Kliknite na Add Connection, potom na OpenAPI (prepne sa na MCP Streamable HTTP)Kattintson az Add Connection, majd az OpenAPI gombra (átvált MCP Streamable HTTP módra)
  3. Fill in URL, ID, and NameVyplňte URL, ID a NameVyplňte URL, ID a NameTöltse ki az URL, ID és Name mezőket
  4. For Bearer token auth, enter Bearer YOUR_TOKEN in the API Key fieldPro Bearer token zadejte Bearer YOUR_TOKEN do pole API KeyPre Bearer token zadajte Bearer YOUR_TOKEN do poľa API KeyBearer token esetén írja be a Bearer YOUR_TOKEN értéket az API Key mezőbe
  5. For OAuth, switch from Bearer to OAuth 2.1 and click Register ClientPro OAuth přepněte z Bearer na OAuth 2.1 a klikněte na Register ClientPre OAuth prepnite z Bearer na OAuth 2.1 a kliknite na Register ClientOAuth esetén váltson Bearerről OAuth 2.1-re, és kattintson a Register Client gombra

User-level (personal tools)Uživatelská úroveň (osobní nástroje)Používateľská úroveň (osobné nástroje)Felhasználói szint (személyes eszközök)

  1. Click your profile icon (bottom-left) -> Settings -> External ToolsKlikněte na ikonu profilu (vlevo dole) -> Settings -> External ToolsKliknite na ikonu profilu (vľavo dole) -> Settings -> External ToolsKattintson a profilikonra (bal alul) -> Settings -> External Tools
  2. Click Add ConnectionKlikněte na Add ConnectionKliknite na Add ConnectionKattintson az Add Connection gombra
  3. Fill in API Base URL with the MCP server URLDo pole API Base URL zadejte URL MCP serveruDo poľa API Base URL zadajte URL MCP serveraAz API Base URL mezőbe írja be az MCP szerver URL-jét
  4. Fill in the API Key field with your Personal Access Token (PAT)Do pole API Key zadejte váš Personal Access Token (PAT)Do poľa API Key zadajte váš Personal Access Token (PAT)Az API Key mezőbe írja be a Personal Access Tokenjét (PAT)
The admin must enable User MCP Connections in Admin Panel -> Settings -> External Tools for user-level connections to work.Admin musí povolit User MCP Connections v Admin Panel -> Settings -> External Tools, aby uživatelská připojení fungovala.Admin musí povoliť User MCP Connections v Admin Panel -> Settings -> External Tools, aby používateľské pripojenia fungovali.Az adminnak engedélyeznie kell a User MCP Connections beállítást az Admin Panel -> Settings -> External Tools menüben, hogy a felhasználói kapcsolatok működjenek.

Any MCP-compatible client can connect to Mergado MCP servers. The servers use the HTTP Streaming transport (Streamable HTTP). To connect, your client needs:Jakýkoli MCP-kompatibilní klient se může připojit k Mergado MCP serverům. Servery používají transport HTTP Streaming (Streamable HTTP). Pro připojení váš klient potřebuje:Akýkoľvek MCP-kompatibilný klient sa môže pripojiť k Mergado MCP serverom. Servery používajú transport HTTP Streaming (Streamable HTTP). Na pripojenie váš klient potrebuje:Bármely MCP-kompatibilis kliens csatlakozhat a Mergado MCP szerverekhez. A szerverek HTTP Streaming (Streamable HTTP) transzportot használnak. A csatlakozáshoz a kliensének a következőkre van szüksége:

  1. Server URL - e.g. https://mcp.mergado.comURL serveru - např. https://mcp.mergado.comURL servera - napr. https://mcp.mergado.comA szerver URL-je - például https://mcp.mergado.com
  2. Transport - HTTP Streaming (Streamable HTTP, sometimes listed as http or streamable-http)Transport - HTTP Streaming (Streamable HTTP, někdy označovaný jako http nebo streamable-http)Transport - HTTP Streaming (Streamable HTTP, niekedy označovaný ako http alebo streamable-http)Transzport - HTTP Streaming (Streamable HTTP, néha http vagy streamable-http néven szerepel)
  3. Authentication - Authorization: Bearer YOUR_TOKEN header, or sign in through MCP if the client supports itAutentizace - hlavička Authorization: Bearer YOUR_TOKEN, případně přihlášení přes MCP, pokud ho klient podporujeAutentifikácia - hlavička Authorization: Bearer YOUR_TOKEN, prípadne prihlásenie cez MCP, ak ho klient podporujeHitelesítés - Authorization: Bearer YOUR_TOKEN fejléc, vagy MCP-n keresztüli bejelentkezés, ha a kliens támogatja

For a list of known MCP clients and their capabilities, see the official MCP client list.Seznam známých MCP klientů a jejich možností najdete na oficiálním seznamu MCP klientů.Zoznam známych MCP klientov a ich možností nájdete na oficiálnom zozname MCP klientov.Az ismert MCP kliensek és képességeik listáját a hivatalos MCP kliens-listán találja.

MCP InspectorMCP InspectorMCP InspectorMCP Inspector

MCP Inspector is a tool for testing MCP servers interactively from your browser - handy when you want to try the server out without setting up a client.MCP Inspector je nástroj pro interaktivní testování MCP serverů přímo z prohlížeče - hodí se, pokud si chcete server vyzkoušet bez nastavování klienta.MCP Inspector je nástroj na interaktívne testovanie MCP serverov priamo z prehliadača - hodí sa, ak si chcete server vyskúšať bez nastavovania klienta.Az MCP Inspector egy eszköz az MCP szerverek interaktív teszteléséhez, közvetlenül a böngészőből - jól jön, ha kliens beállítása nélkül szeretné kipróbálni a szervert.

PrerequisitesPožadavkyPožiadavkyKövetelmények

How to useJak používatAko používaťHasználata

  1. Run in your terminal:Ve svém terminálu spusťte:Vo svojom termináli spustite:Futtassa a termináljában: 
    npx @modelcontextprotocol/inspector
  2. The Inspector UI will open in your browserV prohlížeči se otevře rozhraní InspectoruV prehliadači sa otvorí rozhranie InspectoraA böngészőben megnyílik az Inspector felülete
  3. Set Transport Type to Streamable HTTPJako Transport Type zvolte Streamable HTTPAko Transport Type zvoľte Streamable HTTPTransport Type értéknek válassza a Streamable HTTP lehetőséget
  4. Enter https://mcp.mergado.com in the URL fieldDo pole URL vložte https://mcp.mergado.comDo poľa URL vložte https://mcp.mergado.comAz URL mezőbe illessze be ezt: https://mcp.mergado.com
  5. For authentication, add an Authorization header with the value Bearer YOUR_TOKEN (your Personal Access Token)Pro autentizaci přidejte hlavičku Authorization s hodnotou Bearer YOUR_TOKEN (váš Personal Access Token)Pre autentifikáciu pridajte hlavičku Authorization s hodnotou Bearer YOUR_TOKEN (váš Personal Access Token)A hitelesítéshez adjon hozzá egy Authorization fejlécet Bearer YOUR_TOKEN értékkel (ez az Ön Personal Access Tokenje)
  6. Click ConnectKlikněte na ConnectKliknite na ConnectKattintson a Connect gombra

Official Inspector documentation ->Oficiální dokumentace Inspectoru ->Oficiálna dokumentácia Inspectora ->Az Inspector hivatalos dokumentációja ->

Available toolsDostupné nástrojeDostupné nástrojeElérhető eszközök

231

Below is the full list of tools this MCP server provides to connected AI assistants. Select a tool to see what it does, its input parameters, and whether it only reads or also writes data.Níže je úplný seznam nástrojů, které tento MCP server poskytuje připojeným AI asistentům. Rozkliknutím nástroje zobrazíte, co dělá, jeho vstupní parametry a zda data pouze čte, nebo také zapisuje.Nižšie je úplný zoznam nástrojov, ktoré tento MCP server poskytuje pripojeným AI asistentom. Rozkliknutím nástroja zobrazíte, čo robí, jeho vstupné parametre a či dáta iba číta, alebo aj zapisuje.Az alábbiakban a teljes lista látható azokról az eszközökről, amelyeket ez az MCP szerver a csatlakoztatott AI asszisztensek rendelkezésére bocsát. Egy eszközre kattintva megjelenik, hogy mit csinál, milyen bemeneti paramétereket vár, és hogy csak olvassa vagy írja is az adatokat.

app_biddingfox_control_settings Bidding Fox Writes dataZapisuje dataZapisuje dátaAdatot ír
Controls existing bidding strategies of the project: delete, pause, start and reorder (which reorders them by the order of ids). Strategy IDs can be obtained from the list_strategies tool. For creating and updating strategies use the manage_settings tool.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • action string requiredpovinnépovinnékötelező
    Action: delete, pause, start or reorder.
  • ids array requiredpovinnépovinnékötelező
    Array of strategy IDs. For action=reorder the array order determines the resulting priority.
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
app_biddingfox_create_product_tag Bidding Fox Writes dataZapisuje dataZapisuje dátaAdatot ír
Creates a new product tag in the project. Returns the current list of tags.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • background string requiredpovinnépovinnékötelező
    Tag background colour as a hex value including the hash, e.g. "#ff0000".
  • color string requiredpovinnépovinnékötelező
    Tag text colour as a hex value including the hash, e.g. "#ffffff".
  • name string requiredpovinnépovinnékötelező
    Tag name.
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
app_biddingfox_get_project_overview Bidding Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns a project overview of the chosen type: "metrics" (metrics over time), "analytics" (analytics data and landing pages) or "diagnostics" (problem diagnostics).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
  • type string requiredpovinnépovinnékötelező
    Overview type: "metrics", "analytics" or "diagnostics".
  • date_from string optionalvolitelnévoliteľnéválasztható
    Only for type=metrics. Start of the period in YYYY-MM-DD format, defaults to 30 days ago.
  • date_to string optionalvolitelnévoliteľnéválasztható
    Only for type=metrics. End of the period in YYYY-MM-DD format, defaults to today.
  • filters object optionalvolitelnévoliteľnéválasztható
    Only for type=analytics and type=diagnostics. Filters for the metrics calculation, e.g. {"settings": "12|34"} to limit it to specific strategies.
  • source string optionalvolitelnévoliteľnéválasztható
    Only for type=metrics. "project" (default) for project-level metrics, "settings" for metrics broken down by individual strategies.
app_biddingfox_get_project_settings Bidding Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the project configuration - data sources, report setup, credit limits and other options. This is not the list of bidding strategies, that one is returned by list_strategies.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
app_biddingfox_get_project_settings_history Bidding Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the change history of the project configuration including the record count. The newest record is the current configuration. This is not the history of a bidding strategy, that one is returned by get_setting_history.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
app_biddingfox_get_report Bidding Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the project performance report for a given period. Use page to fetch a single section (1 = summary metrics, 2 = strategies, 3 = best and worst products); without page it returns all sections at once. Supplying date_from_compare and date_to_compare adds a second period for comparison.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
  • date_from string optionalvolitelnévoliteľnéválasztható
    Start of the period in YYYY-MM-DD format. Defaults to 30 days ago.
  • date_from_compare string optionalvolitelnévoliteľnéválasztható
    Start of the comparison period in YYYY-MM-DD format. Must be supplied together with date_to_compare.
  • date_to string optionalvolitelnévoliteľnéválasztható
    End of the period in YYYY-MM-DD format. Defaults to today.
  • date_to_compare string optionalvolitelnévoliteľnéválasztható
    End of the comparison period in YYYY-MM-DD format. Must be supplied together with date_from_compare.
  • page integer optionalvolitelnévoliteľnéválasztható
    Report section: 1 = summary metrics, 2 = strategies, 3 = best and worst products. Omit to get all sections.
app_biddingfox_get_setting_history Bidding Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the change history of a single bidding strategy including the record count.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
  • settings_id integer requiredpovinnépovinnékötelező
    ID of the strategy whose history to return. Obtain it from the list_strategies tool.
app_biddingfox_get_setting_metrics_history Bidding Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the daily metrics history of a single strategy including period totals. Without a period it returns the last 30 days. For a quick overview use last_only=true, which returns only the totals and the last day instead of every day.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
  • settings_id integer requiredpovinnépovinnékötelező
    Strategy ID. Obtain it from the list_strategies tool.
  • date_from string optionalvolitelnévoliteľnéválasztható
    Start of the period in YYYY-MM-DD format. Defaults to 30 days ago.
  • date_to string optionalvolitelnévoliteľnéválasztható
    End of the period in YYYY-MM-DD format. Defaults to today.
  • last_only boolean optionalvolitelnévoliteľnéválasztható
    Return only the period totals and the last day instead of every day. Defaults to false.
app_biddingfox_list_competitors Bidding Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Lists the competitors of the project on Heureka or Zbozi.cz including top producers and categories. Paginated by 10 items.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • engine string requiredpovinnépovinnékötelező
    Comparison engine: "heureka" or "zbozi".
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
  • page integer optionalvolitelnévoliteľnéválasztható
    Page number, defaults to 1.
  • sort object optionalvolitelnévoliteľnéválasztható
    Result ordering. Defaults to {"column": "", "direction": "desc"}.
  • watched_only boolean optionalvolitelnévoliteľnéválasztható
    Return only watched competitors.
app_biddingfox_list_events Bidding Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Lists the project events, newest first. Paginated by 10 items.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
  • annotations_only boolean optionalvolitelnévoliteľnéválasztható
    Return only events that have an annotation.
  • page integer optionalvolitelnévoliteľnéválasztható
    Page number, defaults to 1.
  • search string optionalvolitelnévoliteľnéválasztható
    Text to search for in the event name or body.
  • type string optionalvolitelnévoliteľnéválasztható
    Event type filter. Multiple types can be separated by a pipe, e.g. "apply|settings_changed".
app_biddingfox_list_exports Bidding Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Lists the exports of the project. By default it returns generated exports; with scheduled=true it returns scheduled exports.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
  • scheduled boolean optionalvolitelnévoliteľnéválasztható
    True returns scheduled exports instead of generated ones. Defaults to false.
app_biddingfox_list_product_filters Bidding Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Lists the saved product filters of the project ordered by priority.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
app_biddingfox_list_product_tags Bidding Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Lists the product tags of the project, newest first.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
app_biddingfox_list_products Bidding Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Lists the products of the project with their statistics. Paginated by 20 items.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
  • date_from string optionalvolitelnévoliteľnéválasztható
    Start of the statistics period in YYYY-MM-DD format. Defaults to 7 days ago.
  • date_to string optionalvolitelnévoliteľnéválasztható
    End of the statistics period in YYYY-MM-DD format. Defaults to today.
  • page integer optionalvolitelnévoliteľnéválasztható
    Page number, defaults to 1.
app_biddingfox_list_setting_metrics Bidding Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the daily metrics of all active strategies of the project. Without a period it returns the last 30 days.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
  • date_from string optionalvolitelnévoliteľnéválasztható
    Start of the period in YYYY-MM-DD format. Defaults to 30 days ago.
  • date_to string optionalvolitelnévoliteľnéválasztható
    End of the period in YYYY-MM-DD format. Defaults to today.
app_biddingfox_list_strategies Bidding Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Lists all bidding strategies of the project.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_biddingfox_manage_product_filter Bidding Fox Writes dataZapisuje dataZapisuje dátaAdatot ír
Creates, updates or deletes a product filter of the project. Returns the current list of project filters. With action="update" both the name and the conditions are always overwritten by the supplied values, so both must be sent.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • action string requiredpovinnépovinnékötelező
    Action: "create", "update" or "delete".
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
  • filter_id integer optionalvolitelnévoliteľnéválasztható
    ID of the filter to update. Required for update.
  • filter_ids array optionalvolitelnévoliteľnéválasztható
    IDs of the filters to delete. Required for delete.
  • filters object optionalvolitelnévoliteľnéválasztható
    Filter conditions. Required for create and update.
  • name string optionalvolitelnévoliteľnéválasztható
    Filter name. Required for create and update.
app_biddingfox_manage_settings Bidding Fox Writes dataZapisuje dataZapisuje dátaAdatot ír
Creates and updates bidding strategies of the project: create (adds new ones), update (modifies existing ones) and validate (only checks the data without saving). Calling validate first and writing afterwards is recommended. For deleting, pausing, starting and reordering use the control_settings tool.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • action string requiredpovinnépovinnékötelező
    Action: create, update or validate.
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
  • settings array requiredpovinnépovinnékötelező
    Array of strategies. Each item needs name, strategy (always_first|last_top|pno|position), target_positions, apply_to (all|filters|queries), max_cpc or max_cpc_percent_price, with_vat, and vat_value when with_vat=true. For apply_to=queries also queries, for apply_to=filters also filters. For action=update each item must contain id.
app_biddingfox_validate_project_settings Bidding Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Checks a project configuration payload without saving anything. Returns valid=true when the payload passes, otherwise valid=false together with the per-field errors. Use get_project_settings to read the current configuration first.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    Project ID.
  • settings object requiredpovinnépovinnékötelező
    The configuration payload to validate. Required keys: sales_source, costs_source and clicks_source, each one of analytics, heureka-conversion, zbozi-stats or ga4. Optional keys include reports_emails, url_remove_hash, url_remove_utm, url_regex_find, url_regex_replace, landing_page_plus_query, pairing_mergado_element, ga4_pairing_element, ga_dimensions, ga_source, ga_medium and default_vat.
app_feedimageeditor_custom_images_upload Feed Image Editor Writes dataZapisuje dataZapisuje dátaAdatot ír
Upload a custom image (e.g. a logo or watermark) to a project from image_url, so it becomes available for use as an "uploaded image" layer. image_url must be a publicly reachable direct image URL — a chat-pasted image or a local file cannot be uploaded this way. There's no retry/backoff: sources that block hotlinking or bots (confirmed repeatedly with Wikimedia, HTTP 429) fail with a raw PHP error instead of a clear message — if it fails, try a different, more permissive host rather than retrying the same URL. Returns custom_set_id/custom_set_file_id — pass those into templates_layers_create (type: 'customSet') to actually place the image on a template as a layer, or use the templates_layers_add_custom_image prompt to do both steps in one go.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • image_url string requiredpovinnépovinnékötelező
    uploaded image URI
  • project_id number requiredpovinnépovinnékötelező
    project id
app_feedimageeditor_sizes_list Feed Image Editor Read-onlyPouze čteníIba čítanieCsak olvasás
List the output sizes available in a project: built-in presets and any custom sizes already saved as part of existing templates. Presets are only tagged with a channel `format` (e.g. `facebook`, `google`) and raw dimensions — not a placement/purpose (e.g. `carousel` vs. `story` vs. `feed`), so for a specific placement you may need to determine the right pixel size yourself before creating/sizing a template. Use before `templates.create` or `templates.set-size` to pick a `size_id`, or to decide between a preset and a custom width/height.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id number requiredpovinnépovinnékötelező
    project id
app_feedimageeditor_templates_ai_params Feed Image Editor Writes dataZapisuje dataZapisuje dátaAdatot ír
Enable or disable AI-based feed enrichment for a template: automatically generates product attributes (e.g. color, material, pattern, style) from each matching product's image and writes them into the feed as new elements.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • ai_params_enabled boolean requiredpovinnépovinnékötelező
    Is AI Params enabled
  • project_id number requiredpovinnépovinnékötelező
    project id
  • template_id number requiredpovinnépovinnékötelező
    template id to be renamed
app_feedimageeditor_templates_copy_from_project_to_project Feed Image Editor Writes dataZapisuje dataZapisuje dátaAdatot ír
Copy one template (or, if `template_id` is omitted, every template in `from_project_id`) into another project (`project_id`), including its size, layers, and AI settings. **This writes new templates into the destination project — it does not just read data**, despite the tool's current `readOnlyHint`. Typically used when a new project/client should reuse an existing template setup.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • from_project_id number requiredpovinnépovinnékötelező
    source project id
  • project_id number requiredpovinnépovinnékötelező
    destination project id
  • template_id number optionalvolitelnévoliteľnéválasztható
    Template id to be exported. If null, exports all the templates from the project.
app_feedimageeditor_templates_create Feed Image Editor Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a new template in a project: name, output size (width/height, or omit to use a project default), background color, an optional AI effect (Upscale, Outpainting, or Background removal), and the product selection (queries) it applies to.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • name string requiredpovinnépovinnékötelező
    Name of the new template
  • project_id number requiredpovinnépovinnékötelező
    project id
  • queries array requiredpovinnépovinnékötelező
    Product filter queries assigned to the template
  • ai_type enum optionalvolitelnévoliteľnéválasztható
    AI type of the template
  • background string optionalvolitelnévoliteľnéválasztható
    Background color in hex format, e.g. #ffffff
  • height number optionalvolitelnévoliteľnéválasztható
    Height of the template
  • is_active boolean optionalvolitelnévoliteľnéválasztható
    Whether the template should be active
  • width number optionalvolitelnévoliteľnéválasztható
    Width of the template
app_feedimageeditor_templates_delete Feed Image Editor Writes dataZapisuje dataZapisuje dátaAdatot ír
Permanently delete a template from a project. This cannot be un-done. Confirm with the user before calling; consider `templates_copy_from_project_to_project` first if the template might still be needed elsewhere.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id number requiredpovinnépovinnékötelező
    project id
  • template_id number requiredpovinnépovinnékötelező
    template id to be deleted
app_feedimageeditor_templates_detail Feed Image Editor Read-onlyPouze čteníIba čítanieCsak olvasás
Get one template's configuration: size, background, product selection (queries), scheduled active window (`active_from`/`active_to`), and priority. The raw response carries many more fields than documented (`effect_id`, `effect_sensitivity`, collage/shadow/reflection settings, etc.) — treat anything not in `outputSchema` as unreliable/undocumented. In particular, the AI effect is only exposed as an undocumented numeric `type` — it is not returned as the same `ai_type` string (Upscale/Outpainting/Background removal) used to set it, and `effect_id`/`effect_sensitivity` stay `null` even when an effect is active, so don't rely on any of these to report a template's AI effect to the user. After changing a template's product selection via the Mergado-rule workaround, expect this to show stale data for a while (cache/sync lag, not a failed change). Use after `templates_list` to inspect a specific template before changing it.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id number requiredpovinnépovinnékötelező
    project id
  • template_id number requiredpovinnépovinnékötelező
    template id to be viewed
app_feedimageeditor_templates_duplicate Feed Image Editor Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a copy of an existing template in the same project, including its size, layers, AI settings, and product selection. The copy is appended after the original in priority order. **The response currently echoes the source template's id, not the new copy's** — always confirm the new template's actual id with `templates_list` afterward before referencing it in another call. Use before experimental changes you may want to revert, or to build an A/B variant.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id number requiredpovinnépovinnékötelező
    project id
  • template_id number requiredpovinnépovinnékötelező
    template id to be duplicated
app_feedimageeditor_templates_get_size Feed Image Editor Read-onlyPouze čteníIba čítanieCsak olvasás
Get a template's current output size — explicit width/height, or the preset it uses.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id number requiredpovinnépovinnékötelező
    project id
  • template_id number requiredpovinnépovinnékötelező
    template id
app_feedimageeditor_templates_get_status Feed Image Editor Read-onlyPouze čteníIba čítanieCsak olvasás
Report whether a template's images have finished generating for its currently assigned products. Use after creating, activating, or reassigning a template's product selection, before assuming its output images are ready.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id number requiredpovinnépovinnékötelező
    project id
  • template_id number requiredpovinnépovinnékötelező
    template id
app_feedimageeditor_templates_layers_create Feed Image Editor Writes dataZapisuje dataZapisuje dátaAdatot ír
Add a new layer to a template's canvas. type decides which other fields are required: plain text (text) needs text_content; feed-bound text (textWithElements/dynamicText) and rating (rating) need the matching *_xml_element field(s) — must be an element that actually exists in the project; a previously uploaded image (customSet) needs the custom_set_id/custom_set_file_id returned by custom_images_upload; a feed-bound image (imageFromElements) needs image_xml_element. x/y/width/height (all required) position and size it on the canvas. A feed-bound (is_dynamic) layer must end up stacked above static layers — see templates_layers_reorder.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • height number requiredpovinnépovinnékötelező
    layer height
  • project_id number requiredpovinnépovinnékötelező
    project id
  • template_id number requiredpovinnépovinnékötelező
    template_id
  • type enum requiredpovinnépovinnékötelező
    New shape type
  • width number requiredpovinnépovinnékötelező
    layer width
  • x number requiredpovinnépovinnékötelező
    x position
  • y number requiredpovinnépovinnékötelező
    y position
  • angle number optionalvolitelnévoliteľnéválasztható
    rotation angle in degrees (0-360)
  • background string optionalvolitelnévoliteľnéválasztható
    background color (hex)
  • color string optionalvolitelnévoliteľnéválasztható
    fill color (hex)
  • custom_set_file_id number optionalvolitelnévoliteľnéválasztható
    custom image set file id, required for type: customSet
  • custom_set_id number optionalvolitelnévoliteľnéválasztható
    custom image set id
  • gradient_id number optionalvolitelnévoliteľnéválasztható
    gradient id
  • has_reflection boolean optionalvolitelnévoliteľnéválasztható
    whether the layer has a reflection effect
  • image_xml_element string optionalvolitelnévoliteľnéválasztható
    feed XML element for the image, required for type: imageFromElements. Must be one of the elements available for the project.
  • is_flip boolean optionalvolitelnévoliteľnéválasztható
    flip vertically
  • is_flop boolean optionalvolitelnévoliteľnéválasztható
    flip horizontally
  • is_hidden boolean optionalvolitelnévoliteľnéválasztható
    whether the layer is hidden
  • letter_case enum optionalvolitelnévoliteľnéválasztható
    letter case transform: 0 = keep, 1 = strtoupper, 2 = strtolower, 3 = ucfirst, 4 = lcfirst, 5 = ucwords
  • letter_spacing number optionalvolitelnévoliteľnéválasztható
    letter spacing
  • line_spacing number optionalvolitelnévoliteľnéválasztható
    line spacing
  • name string optionalvolitelnévoliteľnéválasztható
    layer name
  • opacity number optionalvolitelnévoliteľnéválasztható
    opacity (0-100)
  • priority number optionalvolitelnévoliteľnéválasztható
    priority
  • rating_count_xml_element string optionalvolitelnévoliteľnéválasztható
    feed XML element for the rating count. Must be one of the elements available for the project.
  • rating_hide_empty boolean optionalvolitelnévoliteľnéválasztható
    hide empty stars
  • rating_max_value number optionalvolitelnévoliteľnéválasztható
    maximum possible rating value from the feed
  • rating_min_stars number optionalvolitelnévoliteľnéválasztható
    minimum number of stars to display
  • rating_xml_element string optionalvolitelnévoliteľnéválasztható
    feed XML element for the rating value, required for type: rating. Must be one of the elements available for the project.
  • reflection_angle number optionalvolitelnévoliteľnéválasztható
    reflection angle
  • reflection_flip boolean optionalvolitelnévoliteľnéválasztható
    flip the reflection
  • reflection_offset number optionalvolitelnévoliteľnéválasztható
    reflection offset
  • reflection_opacity number optionalvolitelnévoliteľnéválasztható
    reflection opacity
  • scale number optionalvolitelnévoliteľnéválasztható
    scale factor
  • shadow_color string optionalvolitelnévoliteľnéválasztható
    shadow color (hex)
  • shadow_opacity number optionalvolitelnévoliteľnéválasztható
    shadow opacity (0-100)
  • shadow_sigma number optionalvolitelnévoliteľnéválasztható
    shadow blur sigma
  • shadow_xoffset number optionalvolitelnévoliteľnéválasztható
    shadow x offset
  • shadow_yoffset number optionalvolitelnévoliteľnéválasztható
    shadow y offset
  • star_symbol enum optionalvolitelnévoliteľnéválasztható
    star symbol index
  • stroke_color string optionalvolitelnévoliteľnéválasztható
    shape stroke color (hex)
  • stroke_width number optionalvolitelnévoliteľnéválasztható
    shape stroke width
  • text_align enum optionalvolitelnévoliteľnéválasztható
    horizontal text alignment: -1 = left, 0 = center, 1 = right
  • text_background_color string optionalvolitelnévoliteľnéválasztható
    text background color (hex)
  • text_background_type enum optionalvolitelnévoliteľnéválasztható
    text background shape type
  • text_color string optionalvolitelnévoliteľnéválasztható
    text color (hex)
  • text_content string optionalvolitelnévoliteľnéválasztható
    text content, required for type: text, textWithElements
  • text_decoration enum optionalvolitelnévoliteľnéválasztható
    text decoration: 1 = no, 3 = overline, 4 = linethrough, 2 = underline
  • text_decoration_color string optionalvolitelnévoliteľnéválasztható
    text decoration color (hex)
  • text_decoration_lineoverlap number optionalvolitelnévoliteľnéválasztható
    text decoration line overlap (0-10)
  • text_decoration_linethickness number optionalvolitelnévoliteľnéválasztható
    text decoration line thickness (0-10)
  • text_direction enum optionalvolitelnévoliteľnéválasztható
    text direction: 0 = clockwise, 1 = counter-clockwise
  • text_fontfamily string optionalvolitelnévoliteľnéválasztható
    font family
  • text_fontsize number optionalvolitelnévoliteľnéválasztható
    font size, required for type: text, dynamicText, textWithElements, rating
  • text_orientation enum optionalvolitelnévoliteľnéválasztható
    text orientation: 0 = horizontal, 1 = vertical
  • text_overflow enum optionalvolitelnévoliteľnéválasztható
    text overflow behaviour: 0 = keep, 1 = fontsize, 2 = layersize
  • text_padding number optionalvolitelnévoliteľnéválasztható
    text padding
  • text_stroke_color string optionalvolitelnévoliteľnéválasztható
    text stroke color (hex)
  • text_stroke_width number optionalvolitelnévoliteľnéválasztható
    text stroke width
  • text_valign enum optionalvolitelnévoliteľnéválasztható
    vertical text alignment: -1 = start, 0 = middle, 1 = end
  • text_wrap boolean optionalvolitelnévoliteľnéválasztható
    wrap text onto multiple lines
  • text_xml_element string optionalvolitelnévoliteľnéválasztható
    feed XML element for the text content, required for type: dynamicText. Must be one of the elements available for the project.
app_feedimageeditor_templates_layers_delete Feed Image Editor Writes dataZapisuje dataZapisuje dátaAdatot ír
Permanently delete one layer from a template, identified by layer_id (get it from templates_layers_list). This cannot be undone — confirm with the user before calling. Returns the deleted layer's last known state.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • layer_id number requiredpovinnépovinnékötelező
    layer_id
  • project_id number requiredpovinnépovinnékötelező
    project id
  • template_id number requiredpovinnépovinnékötelező
    template_id
app_feedimageeditor_templates_layers_list Feed Image Editor Read-onlyPouze čteníIba čítanieCsak olvasás
List a template's layers (text, feed elements, graphics, shapes, emoji, uploaded images) in their current stacking order. Call before `templates_layers_reorder` to see the current order and layer count, and again afterward to confirm the result actually applied.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id number requiredpovinnépovinnékötelező
    project id
  • template_id number requiredpovinnépovinnékötelező
    template_id
app_feedimageeditor_templates_layers_reorder Feed Image Editor Writes dataZapisuje dataZapisuje dátaAdatot ír
Change the stacking order of a template's layers via ordered_layer_ids (renamed from new_order) — one entry per existing layer, position defines order. New documented rule: layers with is_dynamic: true (feed-bound) must end up stacked above static layers — this may explain why a sourceImage layer (static) has been observed always forcing itself to the last position. Still unreliable overall: repeated calls with the same/similar order have produced different results beyond just this rule. Get current layer ids + is_dynamic from templates_layers_list first, and re-check afterward — don't assume the call did what was asked.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • ordered_layer_ids array requiredpovinnépovinnékötelező
    Array of newly ordered layers ids. See `templates_layers_list` to get layer `id`s and `is_dynamic`. The dynamic layers will be always placed above static layers, so dynamic layers should go before the static layers.
  • project_id number requiredpovinnépovinnékötelező
    project id
  • template_id number requiredpovinnépovinnékötelező
    template_id
app_feedimageeditor_templates_layers_update Feed Image Editor Writes dataZapisuje dataZapisuje dátaAdatot ír
Intended to update an existing layer's properties (position, size, text, styling — same fields as templates_layers_create). Currently unusable for its stated purpose: the input schema has no layer_id (or any other layer identifier), so there is no way to say which layer on the template to update. Until this is fixed, don't rely on it to modify a specific layer — recreate the layer via templates_layers_create and remove the old one via templates_layers_delete instead.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id number requiredpovinnépovinnékötelező
    project id
  • template_id number requiredpovinnépovinnékötelező
    template_id
  • angle number optionalvolitelnévoliteľnéválasztható
    rotation angle in degrees (0-360)
  • background string optionalvolitelnévoliteľnéválasztható
    background color (hex)
  • color string optionalvolitelnévoliteľnéválasztható
    fill color (hex)
  • custom_set_file_id number optionalvolitelnévoliteľnéválasztható
    custom image set file id, required for type: customSet
  • custom_set_id number optionalvolitelnévoliteľnéválasztható
    custom image set id
  • gradient_id number optionalvolitelnévoliteľnéválasztható
    gradient id
  • has_reflection boolean optionalvolitelnévoliteľnéválasztható
    whether the layer has a reflection effect
  • height number optionalvolitelnévoliteľnéválasztható
    layer height
  • image_xml_element string optionalvolitelnévoliteľnéválasztható
    feed XML element for the image, required for type: imageFromElements. Must be one of the elements available for the project.
  • is_flip boolean optionalvolitelnévoliteľnéválasztható
    flip vertically
  • is_flop boolean optionalvolitelnévoliteľnéválasztható
    flip horizontally
  • is_hidden boolean optionalvolitelnévoliteľnéválasztható
    whether the layer is hidden
  • letter_case enum optionalvolitelnévoliteľnéválasztható
    letter case transform: 0 = keep, 1 = strtoupper, 2 = strtolower, 3 = ucfirst, 4 = lcfirst, 5 = ucwords
  • letter_spacing number optionalvolitelnévoliteľnéválasztható
    letter spacing
  • line_spacing number optionalvolitelnévoliteľnéválasztható
    line spacing
  • name string optionalvolitelnévoliteľnéválasztható
    layer name
  • opacity number optionalvolitelnévoliteľnéválasztható
    opacity (0-100)
  • priority number optionalvolitelnévoliteľnéválasztható
    priority
  • rating_count_xml_element string optionalvolitelnévoliteľnéválasztható
    feed XML element for the rating count. Must be one of the elements available for the project.
  • rating_hide_empty boolean optionalvolitelnévoliteľnéválasztható
    hide empty stars
  • rating_max_value number optionalvolitelnévoliteľnéválasztható
    maximum possible rating value from the feed
  • rating_min_stars number optionalvolitelnévoliteľnéválasztható
    minimum number of stars to display
  • rating_xml_element string optionalvolitelnévoliteľnéválasztható
    feed XML element for the rating value, required for type: rating. Must be one of the elements available for the project.
  • reflection_angle number optionalvolitelnévoliteľnéválasztható
    reflection angle
  • reflection_flip boolean optionalvolitelnévoliteľnéválasztható
    flip the reflection
  • reflection_offset number optionalvolitelnévoliteľnéválasztható
    reflection offset
  • reflection_opacity number optionalvolitelnévoliteľnéválasztható
    reflection opacity
  • scale number optionalvolitelnévoliteľnéválasztható
    scale factor
  • shadow_color string optionalvolitelnévoliteľnéválasztható
    shadow color (hex)
  • shadow_opacity number optionalvolitelnévoliteľnéválasztható
    shadow opacity (0-100)
  • shadow_sigma number optionalvolitelnévoliteľnéválasztható
    shadow blur sigma
  • shadow_xoffset number optionalvolitelnévoliteľnéválasztható
    shadow x offset
  • shadow_yoffset number optionalvolitelnévoliteľnéválasztható
    shadow y offset
  • star_symbol enum optionalvolitelnévoliteľnéválasztható
    star symbol index
  • stroke_color string optionalvolitelnévoliteľnéválasztható
    shape stroke color (hex)
  • stroke_width number optionalvolitelnévoliteľnéválasztható
    shape stroke width
  • text_align enum optionalvolitelnévoliteľnéválasztható
    horizontal text alignment: -1 = left, 0 = center, 1 = right
  • text_background_color string optionalvolitelnévoliteľnéválasztható
    text background color (hex)
  • text_background_type enum optionalvolitelnévoliteľnéválasztható
    text background shape type
  • text_color string optionalvolitelnévoliteľnéválasztható
    text color (hex)
  • text_content string optionalvolitelnévoliteľnéválasztható
    text content, required for type: text, textWithElements
  • text_decoration enum optionalvolitelnévoliteľnéválasztható
    text decoration: 1 = no, 3 = overline, 4 = linethrough, 2 = underline
  • text_decoration_color string optionalvolitelnévoliteľnéválasztható
    text decoration color (hex)
  • text_decoration_lineoverlap number optionalvolitelnévoliteľnéválasztható
    text decoration line overlap (0-10)
  • text_decoration_linethickness number optionalvolitelnévoliteľnéválasztható
    text decoration line thickness (0-10)
  • text_direction enum optionalvolitelnévoliteľnéválasztható
    text direction: 0 = clockwise, 1 = counter-clockwise
  • text_fontfamily string optionalvolitelnévoliteľnéválasztható
    font family
  • text_fontsize number optionalvolitelnévoliteľnéválasztható
    font size, required for type: text, dynamicText, textWithElements, rating
  • text_orientation enum optionalvolitelnévoliteľnéválasztható
    text orientation: 0 = horizontal, 1 = vertical
  • text_overflow enum optionalvolitelnévoliteľnéválasztható
    text overflow behaviour: 0 = keep, 1 = fontsize, 2 = layersize
  • text_padding number optionalvolitelnévoliteľnéválasztható
    text padding
  • text_stroke_color string optionalvolitelnévoliteľnéválasztható
    text stroke color (hex)
  • text_stroke_width number optionalvolitelnévoliteľnéválasztható
    text stroke width
  • text_valign enum optionalvolitelnévoliteľnéválasztható
    vertical text alignment: -1 = start, 0 = middle, 1 = end
  • text_wrap boolean optionalvolitelnévoliteľnéválasztható
    wrap text onto multiple lines
  • text_xml_element string optionalvolitelnévoliteľnéválasztható
    feed XML element for the text content, required for type: dynamicText. Must be one of the elements available for the project.
  • type enum optionalvolitelnévoliteľnéválasztható
    New shape type
  • width number optionalvolitelnévoliteľnéválasztható
    layer width
  • x number optionalvolitelnévoliteľnéválasztható
    x position
  • y number optionalvolitelnévoliteľnéválasztható
    y position
app_feedimageeditor_templates_list Feed Image Editor Read-onlyPouze čteníIba čítanieCsak olvasás
List all templates in a project, with name, output size, assigned product selection (query ids), AI type, and active/inactive state. Call this first to see what already exists before creating, modifying, or reordering templates.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id number requiredpovinnépovinnékötelező
    project id
app_feedimageeditor_templates_previews Feed Image Editor Read-onlyPouze čteníIba čítanieCsak olvasás
Render preview images of a template applied to sample products — either a random sample (up to `limit`, default 10) or one specific product (`product_id` or `item_id`). **Without `product_id`, this silently returns an empty result for freshly created, just-reconfigured, or inactive templates** (the product association hasn't been (re)computed yet) — an empty result doesn't necessarily mean " no matching products." Prefer passing an explicit `product_id` (from Mergado's `list_project_products`) for a reliable result, especially right after creating or changing a template.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id number requiredpovinnépovinnékötelező
    project id
  • template_id number requiredpovinnépovinnékötelező
    template id to be previewed
  • item_id number optionalvolitelnévoliteľnéválasztható
    item id to get preview
  • limit number optionalvolitelnévoliteľnéválasztható
    Maximum number of preview images (default 10)
  • product_id number optionalvolitelnévoliteľnéválasztható
    product id to get preview
app_feedimageeditor_templates_rename Feed Image Editor Writes dataZapisuje dataZapisuje dátaAdatot ír
Rename an existing template. Does not affect its size, layers, AI settings, or product selection.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • name string requiredpovinnépovinnékötelező
    New name of the template
  • project_id number requiredpovinnépovinnékötelező
    project id
  • template_id number requiredpovinnépovinnékötelező
    template id to be renamed
app_feedimageeditor_templates_reorder Feed Image Editor Writes dataZapisuje dataZapisuje dátaAdatot ír
Change the priority order of all templates in a project via new_templates_order_ids (renamed from new_order). When several templates' product selections overlap for the same product, this order decides which template's output wins — templates earlier in the array take precedence. Must include every existing template id in the project.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • new_templates_order_ids array requiredpovinnépovinnékötelező
    Array of ordered template ids. See `templates_list` to get template ids first.
  • project_id number requiredpovinnépovinnékötelező
    project id
app_feedimageeditor_templates_set_activity Feed Image Editor Writes dataZapisuje dataZapisuje dátaAdatot ír
Activate, pause, or schedule a template. Either set `active` (immediate on/off) on its own, or set `from`/`to` (a scheduled activation window — one or both) on their own; `active` cannot be combined with `from`/`to` in the same call. `from`/`to` must not be in the past.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id number requiredpovinnépovinnékötelező
    project id
  • template_id number requiredpovinnépovinnékötelező
    the template id to be paused or resumed
  • active boolean optionalvolitelnévoliteľnéválasztható
    Set template active or inactive. Cannot be combined with from/to; provide active on its own, or from and/or to on their own.
  • from string optionalvolitelnévoliteľnéválasztható
    Date/time from which the template becomes active. Format: Y-m-d H:i:s. Must not be in the past. Cannot be combined with active; provide from and/or to on their own, or active on its own.
  • to string optionalvolitelnévoliteľnéválasztható
    Date/time until which the template stays active. Format: Y-m-d H:i:s. Must not be in the past. Cannot be combined with active; provide from and/or to on their own, or active on its own.
app_feedimageeditor_templates_set_ai_type Feed Image Editor Writes dataZapisuje dataZapisuje dátaAdatot ír
Switch which AI effect a template applies to its matching product images: Background removal (remove_background), Outpainting, or Upscale (upscale). Pass null to turn the effect off. The tool's own description says the Outpainting value is outpainting, but the actual enum requires the typo'd outpaintinging — trust the schema, not the prose. There is currently no way to read this setting back in the same form — see templates_detail.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id number requiredpovinnépovinnékötelező
    project id
  • template_id number requiredpovinnépovinnékötelező
    template id
  • ai_type enum optionalvolitelnévoliteľnéválasztható
    AI type of the template.
app_feedimageeditor_templates_set_size Feed Image Editor Writes dataZapisuje dataZapisuje dátaAdatot ír
Set a template's output size, either as explicit `width`/`height` in pixels or by referencing an existing preset via `size_id` (see `sizes_list`), or pass `keep_original_size: true` to keep each product's original image dimensions. Does not change the template's AI settings or product selection; check `templates_layers_list` and `templates.previews` afterward, since layer placement is relative to the canvas dimensions.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id number requiredpovinnépovinnékötelező
    project id
  • template_id number requiredpovinnépovinnékötelező
    template id
  • height number optionalvolitelnévoliteľnéválasztható
    height in pixels (used together with width, unless size_id is provided)
  • keep_original_size boolean optionalvolitelnévoliteľnéválasztható
    Keep original image size. Layers are not supported in this mode and will be removed.
  • size_id string | number optionalvolitelnévoliteľnéválasztható
    id of an existing size, see tools/sizes_list
  • width number optionalvolitelnévoliteľnéválasztható
    width in pixels (used together with height, unless size_id is provided)
app_feedimageeditor_templates_visual_similarity Feed Image Editor Writes dataZapisuje dataZapisuje dátaAdatot ír
Enable or disable visual similarity matching for a template: finds products with visually similar images elsewhere in the feed and links them to each product. `visual_similarity_threshold` sets the minimum similarity score (0–1), `visual_similarity_n` how many similar products to attach (default 5), `visual_similarity_templateids` restricts the search to images produced by specific templates.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id number requiredpovinnépovinnékötelező
    project id
  • template_id number requiredpovinnépovinnékötelező
    template id on which enabled visual similarity
  • visual_similarity_enabled boolean requiredpovinnépovinnékötelező
    is Visual Similarity enabled
  • visual_similarity_n number optionalvolitelnévoliteľnéválasztható
    similar images count
  • visual_similarity_templateids array optionalvolitelnévoliteľnéválasztható
    list of template ids where to find similar images
  • visual_similarity_threshold number optionalvolitelnévoliteľnéválasztható
    threshold 0-1
app_mergadodepots_get_eshop_review Mergado Depots Read-onlyPouze čteníIba čítanieCsak olvasás
Fetch a single eshop (seller) review by platform and id. Only needed to re-fetch a review already identified by search_eshop_reviews (search results are complete). Errors if the eshop has no such review.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • external_id string requiredpovinnépovinnékötelező
    The review's id on its platform — returned as `id` by the search tools.
  • source object requiredpovinnépovinnékötelező
    Review platform the review comes from.
  • eshop_id string optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) id the call targets. Omit with a shop or project token — it defaults to the token's own eshop. Required with a user token (resolve it via Mergado's list_user_eshops); access to the eshop is verified with Mergado.
app_mergadodepots_get_product_review Mergado Depots Read-onlyPouze čteníIba čítanieCsak olvasás
Fetch a single product review by platform and id. Only needed to re-fetch a review already identified by search_product_reviews (search results are complete). Errors if the eshop has no such review.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • external_id string requiredpovinnépovinnékötelező
    The review's id on its platform — returned as `id` by the search tools.
  • source object requiredpovinnépovinnékötelező
    Review platform the review comes from.
  • eshop_id string optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) id the call targets. Omit with a shop or project token — it defaults to the token's own eshop. Required with a user token (resolve it via Mergado's list_user_eshops); access to the eshop is verified with Mergado.
app_mergadodepots_list_review_sources Mergado Depots Read-onlyPouze čteníIba čítanieCsak olvasás
Show per platform whether reviews are being downloaded for the eshop and whether the download is healthy. `unavailable` means the platform isn't connected in the Mergado keychain yet — connecting it is a manual step in Mergado, not something a tool can do.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • eshop_id string optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) id the call targets. Omit with a shop or project token — it defaults to the token's own eshop. Required with a user token (resolve it via Mergado's list_user_eshops); access to the eshop is verified with Mergado.
app_mergadodepots_search_eshop_reviews Mergado Depots Read-onlyPouze čteníIba čítanieCsak olvasás
List reviews of the eshop as a whole (seller reviews: service, delivery, communication — not individual products) from all platforms in one unified format, newest first. Use when the user asks how their shop is rated. `total_results` is the overall match count — page with limit/offset.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • created_from string optionalvolitelnévoliteľnéválasztható
    Only reviews created at/after this ISO 8601 date-time; no timezone means UTC.
  • created_to string optionalvolitelnévoliteľnéválasztható
    Only reviews created at/before this ISO 8601 date-time; no timezone means UTC.
  • eshop_id string optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) id the call targets. Omit with a shop or project token — it defaults to the token's own eshop. Required with a user token (resolve it via Mergado's list_user_eshops); access to the eshop is verified with Mergado.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Max reviews per page.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Results to skip, for paging beyond the first page.
  • source object optionalvolitelnévoliteľnéválasztható
    Review platform to filter by (`heureka.cz`, `heureka.sk`, `zbozi.cz`); omit to search all platforms.
app_mergadodepots_search_product_reviews Mergado Depots Read-onlyPouze čteníIba čítanieCsak olvasás
List the eshop's product reviews (customer opinions on individual products) from all platforms in one unified format, newest first. Use when the user asks what customers say about their products. `total_results` is the overall match count — page with limit/offset.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • created_from string optionalvolitelnévoliteľnéválasztható
    Only reviews created at/after this ISO 8601 date-time; no timezone means UTC.
  • created_to string optionalvolitelnévoliteľnéválasztható
    Only reviews created at/before this ISO 8601 date-time; no timezone means UTC.
  • ean string optionalvolitelnévoliteľnéválasztható
    Filter to one product by its EAN.
  • eshop_id string optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) id the call targets. Omit with a shop or project token — it defaults to the token's own eshop. Required with a user token (resolve it via Mergado's list_user_eshops); access to the eshop is verified with Mergado.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Max reviews per page.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Results to skip, for paging beyond the first page.
  • source object optionalvolitelnévoliteľnéválasztható
    Review platform to filter by (`heureka.cz`, `heureka.sk`, `zbozi.cz`); omit to search all platforms.
  • url string optionalvolitelnévoliteľnéválasztható
    Filter to one product by its URL on the eshop (not the review platform's URL).
app_mergadodepots_set_review_source_enabled Mergado Depots Writes dataZapisuje dataZapisuje dátaAdatot ír
Turn downloading of an eshop's reviews from one platform on or off. Affects future downloads only — already-downloaded reviews stay searchable. Requires the `shop.write` scope. Fails if the platform isn't connected in the Mergado keychain (see list_review_sources).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • enabled boolean requiredpovinnépovinnékötelező
    true to download the platform's reviews, false to stop.
  • source object requiredpovinnépovinnékötelező
    Platform to switch: `heureka` (covers heureka.cz and heureka.sk) or `zbozi`.
  • eshop_id string optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) id the call targets. Omit with a shop or project token — it defaults to the token's own eshop. Required with a user token (resolve it via Mergado's list_user_eshops); access to the eshop is verified with Mergado.
app_ordelogyproducts_create_campaign Mergado Marketplaces Writes dataZapisuje dataZapisuje dátaAdatot ír
Creates a LIVE marketplace campaign — on success a full product-feed sync is enqueued immediately and offers start listing on the marketplace. Only call after validate_campaign_data passes AND the user explicitly confirmed they want the campaign live; to hand over for review in the app instead, use save_campaign_draft. Campaign names must be unique per eshop.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Campaign data in the wizard shape: name, target_datasource{id, storefront?, user_documents?, additional_storefronts?, shipping_group?, reconnect_to_existing_offers?}, source_datasource{type, project, query}, mapped_elements {ORDELOGY_ELEMENT: feed element name or list}, global_elements, availability_feed{url | product_feed_url}. Source valid values from get_campaign_requirements and describe_mergado_project; query ids and feed element names from the Mergado hub's list_project_queries / list_project_elements.
  • draft_id integer optionalvolitelnévoliteľnéválasztható
    Draft the campaign was assembled from — deleted automatically once the campaign is created.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
  • ignore_missing_products boolean optionalvolitelnévoliteľnéválasztható
    Skip the check that availability-feed products match the product feed — the wizard's 'continue anyway' confirmation.
app_ordelogyproducts_delete_pause_scheduler Mergado Marketplaces Writes dataZapisuje dataZapisuje dátaAdatot ír
Cancels the campaign's scheduled sales pause; if sales are currently paused by the scheduler, they resume immediately.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • campaign_id integer requiredpovinnépovinnékötelező
    Internal campaign ID — resolve it via list_campaigns.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
app_ordelogyproducts_describe_mergado_project Mergado Marketplaces Writes dataZapisuje dataZapisuje dátaAdatot ír
What Ordelogy Products makes of one Mergado project: whether its output format is usable as a campaign product feed (`product_feed_type` MERGADO/GMC, else null), the derived `product_feed_url` for `availability_feed`, and an automatic `mapped_elements` proposal to start from (verify it with validate_campaign_data). The proposal exists only for Mergado Marketplaces and GMC output formats — for any other format (`suggested_mapping_error`, e.g. Heureka) build the mapping yourself: take the required and identifier ordelogy elements from get_campaign_requirements, sample the feed with sample_project_element_values and match on names AND values (values disambiguate look-alikes — which price includes VAT, EAN vs internal code), then present the complete proposed mapping to the user for review before validating. If no feed element convincingly matches a required ordelogy element, do NOT force the closest look-alike — tell the user what's missing and ask (HANDLING_TIME/CONDITION can be supplied as global_elements instead). Raw project data comes from the Mergado hub tools: list_shop_projects (project ids), list_project_queries (`source_datasource.query` ids), list_project_elements (valid `mapped_elements` feed element names).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id integer requiredpovinnépovinnékötelező
    Mergado project ID — resolve it via the Mergado hub's list_shop_projects.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
  • include_suggested_mapping boolean optionalvolitelnévoliteľnéválasztható
    Also compute the automatic ordelogy-element → feed-element mapping proposal (slower — samples element values from the feed).
app_ordelogyproducts_get_campaign_drafts Mergado Marketplaces Read-onlyPouze čteníIba čítanieCsak olvasás
The eshop's saved campaign drafts (id, wizard step, name, marketplace, last modification; max 3 per eshop). Pass draft_id to fetch one draft with its full data blob — use that to resume work on it.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • draft_id integer optionalvolitelnévoliteľnéválasztható
    Return this single draft including its full data blob; omit to list all drafts.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
app_ordelogyproducts_get_campaign_history Mergado Marketplaces Read-onlyPouze čteníIba čítanieCsak olvasás
The campaign's event history: syncs, settings changes, errors — what happened and when. Call when the user says something used to work or asks what changed. Paginated — page through for more.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • campaign_id integer requiredpovinnépovinnékötelező
    Internal campaign ID — resolve it via list_campaigns.
  • date_from string optionalvolitelnévoliteľnéválasztható
    Only events on or after this date (YYYY-MM-DD).
  • date_to string optionalvolitelnévoliteľnéválasztható
    Only events on or before this date (YYYY-MM-DD).
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
  • history_type string optionalvolitelnévoliteľnéválasztható
    Event type group filter; one of: EDIT_CAMPAIGN, EDIT_OFFER, OFFER_STATUSES_SYNC, AVAILABILITY_FEED_SYNC, PRODUCT_FEED_SYNC, PRODUCT_LISTING, PRODUCT_EDITING, ADD_MISSING_PARAMETERS, CONNECTION_STATUS, CAMPAIGN_STATISTICS, PAUSING_OFFERS.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Events per page (1-50).
  • page integer optionalvolitelnévoliteľnéválasztható
    Results page, 1-based.
  • severity_type string optionalvolitelnévoliteľnéválasztható
    Severity group filter; one of: FAILED, EDIT, SUCCESS, UNCHANGED.
app_ordelogyproducts_get_campaign_last_syncs Mergado Marketplaces Read-onlyPouze čteníIba čítanieCsak olvasás
Timestamps of the campaign's last successful product-feed, availability-feed and offer-statuses syncs. Call when the user asks whether data is fresh, when the last export ran, or why the marketplace shows stale prices/stock.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • campaign_id integer requiredpovinnépovinnékötelező
    Internal campaign ID — resolve it via list_campaigns.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
app_ordelogyproducts_get_campaign_requirements Mergado Marketplaces Read-onlyPouze čteníIba čítanieCsak olvasás
Everything one marketplace connection requires for a valid campaign: required and identifier elements, global elements, storefront choices, whether Allegro user documents / additional storefronts are needed (with the actual document choices), allowed CONDITION values, availability-feed suggestions and — for Kaufland with `storefront` set — shipping groups. Call right after list_connections when preparing a campaign. Sections that fail to load appear in `section_errors`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • connection_id integer requiredpovinnépovinnékötelező
    Marketplace connection ID — resolve it via list_connections.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
  • storefront string optionalvolitelnévoliteľnéválasztható
    Kaufland storefront (country) code, e.g. CZ — when provided, the response also includes the shipping groups available on it.
app_ordelogyproducts_get_campaign_stocks Mergado Marketplaces Read-onlyPouze čteníIba čítanieCsak olvasás
Stock levels of the campaign's non-deleted offers, keyed by PRODUCT_ID or EAN. Without `identifier` returns the paginated bulk list (with by=ean, offers without an EAN are skipped); with `identifier` returns that single product's stock (404 if not found). Call when the user asks how many pieces are exported to a marketplace.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • campaign_id integer requiredpovinnépovinnékötelező
    Internal campaign ID — resolve it via list_campaigns.
  • by enum optionalvolitelnévoliteľnéválasztható
    Which product identifier to use: 'product_id' = the source-feed PRODUCT_ID, 'ean' = the offer's EAN.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
  • identifier string optionalvolitelnévoliteľnéválasztható
    Look up a single product by this identifier value (a PRODUCT_ID or an EAN, per `by`); omit for the paginated bulk list.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Items per page in bulk mode (1-1000).
  • page integer optionalvolitelnévoliteľnéválasztható
    Results page, 1-based.
app_ordelogyproducts_get_campaign_validation Mergado Marketplaces Read-onlyPouze čteníIba čítanieCsak olvasás
Validator errors for one export campaign, grouped by error code with counts and English messages. Call when the user asks why offers are invalid, rejected or missing from a marketplace. Resolve campaign_id via list_campaigns first.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • campaign_id integer requiredpovinnépovinnékötelező
    Internal campaign ID — resolve it via list_campaigns.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
app_ordelogyproducts_get_gmc_account_issues Mergado Marketplaces Read-onlyPouze čteníIba čítanieCsak olvasás
Account-level Google Merchant Center issues (suspensions, policy problems) recorded by the periodic account check. Call when GMC exports fail without campaign-level validation errors. Errors with 404 when the eshop has no GMC connection.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
app_ordelogyproducts_get_offer Mergado Marketplaces Read-onlyPouze čteníIba čítanieCsak olvasás
One offer in full detail: every exported element, per-offer errors and protected elements. Resolve offer_id via list_offers first. Set include_marketplace_url=true to also fetch the offer's public marketplace URL (slower — live marketplace API call; null when unresolvable).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • campaign_id integer requiredpovinnépovinnékötelező
    Internal campaign ID — resolve it via list_campaigns.
  • offer_id integer requiredpovinnépovinnékötelező
    Internal offer ID — resolve it via list_offers.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
  • include_marketplace_url boolean optionalvolitelnévoliteľnéválasztható
    Also resolve the offer's public marketplace URL — slower (live marketplace API call); null when unresolvable.
  • storefront string optionalvolitelnévoliteľnéválasztható
    Storefront (country) code for the marketplace URL, e.g. CZ; defaults to the campaign's storefront.
app_ordelogyproducts_get_order Mergado Marketplaces Read-onlyPouze čteníIba čítanieCsak olvasás
Full detail of one order: products, prices, customer, shipping, payment, documents, history and sync errors. Resolve order_id (the internal id) via list_orders first.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • order_id integer requiredpovinnépovinnékötelező
    Internal order ID — resolve it via list_orders.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
app_ordelogyproducts_get_orders_statistics Mergado Marketplaces Read-onlyPouze čteníIba čítanieCsak olvasás
Order statistics for the eshop: order/return counts, profit, averages and a profit/amount time series, with growth vs the previous period. Filter by marketplace, order status or period (custom_date preset or date_from/date_to in YYYY-MM-DD). Call when the user asks how sales are going.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • currency string optionalvolitelnévoliteľnéválasztható
    Currency for monetary figures; one of: CZK, PLN, EUR, HUF, USD.
  • custom_date string optionalvolitelnévoliteľnéválasztható
    Preset time period; one of: WEEK, TWO_WEEKS, ONE_MONTH, TWO_MONTHS, THREE_MONTHS, SIX_MONTHS, YEAR. Alternative to date_from/date_to.
  • date_from string optionalvolitelnévoliteľnéválasztható
    Period start (YYYY-MM-DD); use with date_to.
  • date_to string optionalvolitelnévoliteľnéválasztható
    Period end (YYYY-MM-DD); use with date_from.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
  • marketplace string optionalvolitelnévoliteľnéválasztható
    Marketplace filter; one of: ALLEGRO, KAUFLAND, GOOGLE_MERCHANT_CENTER, AMAZON.
  • status string optionalvolitelnévoliteľnéválasztható
    Order status filter; one of: OPEN, READY, PROCESSING, SENT, ONHOLD, RETURNED, CANCELLED, UNKNOWN.
app_ordelogyproducts_get_seller_rating Mergado Marketplaces Read-onlyPouze čteníIba čítanieCsak olvasás
Seller quality score of an ALLEGRO campaign, fetched live from Allegro. Other marketplaces do not publish one and return an error. Call when the user asks about their Allegro seller rating or account quality.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • campaign_id integer requiredpovinnépovinnékötelező
    Internal campaign ID — resolve it via list_campaigns.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
app_ordelogyproducts_list_campaigns Mergado Marketplaces Read-onlyPouze čteníIba čítanieCsak olvasás
List the eshop's marketplace export campaigns in Ordelogy Products: id, name, marketplace, storefront, last sync, alerts and offer-status counts. Call this first to resolve the campaign_id needed by other tools, or when the user asks what they export where. Paginated — page through for more.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Campaigns per page (1-50).
  • page integer optionalvolitelnévoliteľnéválasztható
    Results page, 1-based.
app_ordelogyproducts_list_connections Mergado Marketplaces Read-onlyPouze čteníIba čítanieCsak olvasás
All marketplace/eshop/ERP connections of the eshop with their IDs, linked campaigns, failed flags and masked credentials. Call to resolve the connection_id needed for campaign creation, or when the user asks what is connected, whether a marketplace connection is failing or why exports stopped. Never returns usable credentials.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
app_ordelogyproducts_list_offers Mergado Marketplaces Read-onlyPouze čteníIba čítanieCsak olvasás
The campaign's offers with statuses and errors — find a product by PRODUCT_ID or free text, or filter by marketplace status, sync flags or error code/severity. Call when the user asks which products are rejected, missing or failing. Paginated — page through for more.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • campaign_id integer requiredpovinnépovinnékötelező
    Internal campaign ID — resolve it via list_campaigns.
  • app_error_code string optionalvolitelnévoliteľnéválasztható
    Only offers failing with this validator error code (codes come from get_campaign_validation).
  • error_severity string optionalvolitelnévoliteľnéválasztható
    Error severity group filter; one of: FATAL, WARNING, ACTIVE_ERROR.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
  • has_protected_elements boolean optionalvolitelnévoliteľnéválasztható
    Only offers with (true) / without (false) protected elements — values locked against feed overwrites.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Offers per page (1-49).
  • page integer optionalvolitelnévoliteľnéválasztható
    Results page, 1-based.
  • product_id string optionalvolitelnévoliteľnéválasztható
    Exact source-feed PRODUCT_ID of the offer.
  • search_text string optionalvolitelnévoliteľnéválasztható
    Free-text search in product names and identifiers.
  • status string optionalvolitelnévoliteľnéválasztható
    Offer status filter; one of: ACTIVATING, ACTIVE, ACTIVE_ERROR, APPROVED, AVAILABLE, BUYABLE, DISCOVERABLE, ENDED, FAILED, INACTIVE, INCOMPLETE, NOT_APPROVED, ONHOLD, PAUSED, UNDER_REVIEW, UNKNOWN.
  • up_to_date boolean optionalvolitelnévoliteľnéválasztható
    Only offers whose exported data is (true) / is not (false) up to date with the source feed.
  • uploaded_to_marketplace boolean optionalvolitelnévoliteľnéválasztható
    Only offers that were (true) / were not (false) successfully uploaded to the marketplace.
app_ordelogyproducts_list_orders Mergado Marketplaces Read-onlyPouze čteníIba čítanieCsak olvasás
Marketplace orders of the eshop with status statistics: customer, products, prices and sync errors (English). Call when the user asks about orders, their sync into the eshop, or order errors. Paginated — page through for more.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • date_from string optionalvolitelnévoliteľnéválasztható
    Only orders created on or after this date (YYYY-MM-DD).
  • date_to string optionalvolitelnévoliteľnéválasztható
    Only orders created on or before this date (YYYY-MM-DD).
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
  • is_synced boolean optionalvolitelnévoliteľnéválasztható
    Filter by whether the order was successfully synced into the eshop platform.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Orders per page (1-100).
  • marketplace string optionalvolitelnévoliteľnéválasztható
    Marketplace filter; one of: ALLEGRO, KAUFLAND, GOOGLE_MERCHANT_CENTER, AMAZON.
  • page integer optionalvolitelnévoliteľnéválasztható
    Results page, 1-based.
  • search_text string optionalvolitelnévoliteľnéválasztható
    Free-text search across order number, customer and product names.
  • status string optionalvolitelnévoliteľnéválasztható
    Order status filter; one of: OPEN, READY, PROCESSING, SENT, ONHOLD, RETURNED, CANCELLED, UNKNOWN.
  • storefront string optionalvolitelnévoliteľnéválasztható
    Storefront (country) code filter, e.g. CZ, SK, DE.
app_ordelogyproducts_pause_campaign_offers Mergado Marketplaces Writes dataZapisuje dataZapisuje dátaAdatot ír
Pauses sales of ALL offers in a campaign (activate=true resumes them). Affects the whole campaign on the live marketplace — confirm with the user before pausing. Refused while a pause scheduler is active on the campaign.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • campaign_id integer requiredpovinnépovinnékötelező
    Internal campaign ID — resolve it via list_campaigns.
  • activate boolean optionalvolitelnévoliteľnéválasztható
    false = pause sales, true = resume them.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
app_ordelogyproducts_sample_project_element_values Mergado Marketplaces Writes dataZapisuje dataZapisuje dátaAdatot ír
Sample output values per feed element of a Mergado project, in one call — the evidence for building `mapped_elements` yourself when describe_mergado_project returns no suggested_mapping (unsupported feed format). Match ordelogy elements (from get_campaign_requirements) to feed elements on names AND sampled values — values disambiguate look-alikes (which price includes VAT, EAN vs internal code) — then present the complete proposed mapping to the user for review and verify it with validate_campaign_data. If no feed element convincingly matches a required ordelogy element, do NOT force the closest look-alike — tell the user what's missing and ask (HANDLING_TIME/CONDITION can be supplied as global_elements instead). Elements whose fetch fails are omitted from the result; an empty list means the element exists but has no output values (don't map it). May take tens of seconds when sampling a whole project.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id integer requiredpovinnépovinnékötelező
    Mergado project ID — resolve it via the Mergado hub's list_shop_projects.
  • elements array optionalvolitelnévoliteľnéválasztható
    Feed element names to sample (nested paths as 'parent | child'); omit to sample every non-hidden element in the project.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
app_ordelogyproducts_save_campaign_draft Mergado Marketplaces Writes dataZapisuje dataZapisuje dátaAdatot ír
Saves assembled campaign data as a draft the user can review, finish and launch in the app's campaign wizard — the safe default handoff of agent-assisted campaign creation (use create_campaign only when the user explicitly wants the campaign live immediately). Validate with validate_campaign_data first. Without draft_id creates a new draft (fails when the eshop already has 3); with draft_id overwrites that draft.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Campaign data in the wizard shape: name, target_datasource{id, storefront?, user_documents?, additional_storefronts?, shipping_group?, reconnect_to_existing_offers?}, source_datasource{type, project, query}, mapped_elements {ORDELOGY_ELEMENT: feed element name or list}, global_elements, availability_feed{url | product_feed_url}. Source valid values from get_campaign_requirements and describe_mergado_project; query ids and feed element names from the Mergado hub's list_project_queries / list_project_elements.
  • step integer requiredpovinnépovinnékötelező
    Campaign-wizard step the draft is at (1-4).
  • draft_id integer optionalvolitelnévoliteľnéválasztható
    Existing draft to overwrite; omit to create a new draft.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
app_ordelogyproducts_set_pause_scheduler Mergado Marketplaces Writes dataZapisuje dataZapisuje dátaAdatot ír
Schedules a sales pause for the campaign (e.g. over holidays): offers pause at pause_from and resume at pause_to. Timestamps are ISO format (YYYY-MM-DDTHH:MM:SS); omit pause_to to pause until manually resumed. Calling again overwrites the existing schedule.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • campaign_id integer requiredpovinnépovinnékötelező
    Internal campaign ID — resolve it via list_campaigns.
  • pause_from string requiredpovinnépovinnékötelező
    When sales pause — ISO datetime, YYYY-MM-DDTHH:MM:SS.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
  • pause_to string optionalvolitelnévoliteľnéválasztható
    When sales resume (ISO datetime); omit to pause until manually resumed.
app_ordelogyproducts_toggle_offer_pause Mergado Marketplaces Writes dataZapisuje dataZapisuje dátaAdatot ír
Pauses an active offer or resumes a paused one on the marketplace — the same switch as the UI pause button; the response says which happened. Use for a single product ("take this off Kaufland now"); the change is reversible by calling again. Resolve offer_id via list_offers first.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • campaign_id integer requiredpovinnépovinnékötelező
    Internal campaign ID — resolve it via list_campaigns.
  • offer_id integer requiredpovinnépovinnékötelező
    Internal offer ID — resolve it via list_offers.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
app_ordelogyproducts_trigger_product_feed_sync Mergado Marketplaces Writes dataZapisuje dataZapisuje dátaAdatot ír
Triggers a full product-feed synchronization of the campaign now, instead of waiting for the schedule — use after the user fixed their feed. Refused when the campaign is paused, already syncing, or its connection is failed.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • campaign_id integer requiredpovinnépovinnékötelező
    Internal campaign ID — resolve it via list_campaigns.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
app_ordelogyproducts_update_order_internal_note Mergado Marketplaces Writes dataZapisuje dataZapisuje dátaAdatot ír
Sets the internal (staff-only) note of an order — overwrites any existing note; the customer never sees it. Resolve order_id via list_orders first.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • internal_note string requiredpovinnépovinnékötelező
    New note text — overwrites the existing note. Staff-only, never shown to the customer.
  • order_id integer requiredpovinnépovinnékötelező
    Internal order ID — resolve it via list_orders.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
app_ordelogyproducts_validate_campaign_data Mergado Marketplaces Writes dataZapisuje dataZapisuje dátaAdatot ír
Validates (partial) campaign data exactly like the app's creation wizard — nothing is saved. On failure the error message names the problem and the wizard step (0 name, 1 marketplace, 2 feed+mapping, 3 availability feed); fix and call again until it passes. May take tens of seconds — it downloads and checks the availability feed.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Campaign data in the wizard shape: name, target_datasource{id, storefront?, user_documents?, additional_storefronts?, shipping_group?, reconnect_to_existing_offers?}, source_datasource{type, project, query}, mapped_elements {ORDELOGY_ELEMENT: feed element name or list}, global_elements, availability_feed{url | product_feed_url}. Source valid values from get_campaign_requirements and describe_mergado_project; query ids and feed element names from the Mergado hub's list_project_queries / list_project_elements.
  • eshop_id integer optionalvolitelnévoliteľnéválasztható
    Mergado eshop (shop) ID the call targets. Omit when authenticated with a shop token — it defaults to the token's own shop. User and project tokens must always provide it; their access to the shop is verified with Mergado.
  • ignore_missing_products boolean optionalvolitelnévoliteľnéválasztható
    Skip the check that availability-feed products match the product feed — the wizard's 'continue anyway' confirmation.
  • last_step integer optionalvolitelnévoliteľnéválasztható
    Validate only wizard steps up to this one (1-4); omit to validate everything provided.
app_pricingfox_clone_rules Pricing Fox Writes dataZapisuje dataZapisuje dátaAdatot ír
Clones (duplicates) one or more pricing rules.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
  • rule_ids array optionalvolitelnévoliteľnéválasztható
    Array of IDs of the rules to clone (1-100 items).
app_pricingfox_create_rule Pricing Fox Writes dataZapisuje dataZapisuje dátaAdatot ír
Creates a new pricing rule in the project.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • apply_to string optionalvolitelnévoliteľnéválasztható
    What the rule applies to: all (all products), queries (mergado queries – then fill in mergado_queries), filters (product filters – then fill in filters).
  • condition_join_operator string optionalvolitelnévoliteľnéválasztható
    Operator joining the conditions: and or or. Default: and.
  • condition_selector string optionalvolitelnévoliteľnéválasztható
    How to pick the price from the conditions: min (lowest), max (highest), avg (average), first (first matching).
  • conditions array optionalvolitelnévoliteľnéválasztható
    Rule conditions. Each condition must contain: source (heureka|mergado|input_price|import_price|kaufland|zbozi|gmc), type, operator, value (array of values).
  • diff_type string optionalvolitelnévoliteľnéválasztható
    Difference type: relative (percentage), absolute (absolute amount in the project currency).
  • diff_value number optionalvolitelnévoliteľnéválasztható
    Price change value. Required unless type is equals.
  • filters array optionalvolitelnévoliteľnéválasztható
    Array of product filter IDs. Required when apply_to=filters.
  • final boolean optionalvolitelnévoliteľnéválasztható
    If true, no further rules are evaluated once this rule is applied.
  • is_margin boolean optionalvolitelnévoliteľnéválasztható
    The rule works with the margin instead of the price.
  • is_test boolean optionalvolitelnévoliteľnéválasztható
    Test rule – it is not calculated into the feed output.
  • manual_limit_max_price number optionalvolitelnévoliteľnéválasztható
    Maximum absolute product price after the rule is applied.
  • manual_limit_min_price number optionalvolitelnévoliteľnéválasztható
    Minimum absolute product price after the rule is applied.
  • margin_limit_max number optionalvolitelnévoliteľnéválasztható
    Maximum margin in percent.
  • margin_limit_min number optionalvolitelnévoliteľnéválasztható
    Minimum margin in percent.
  • mergado_queries array optionalvolitelnévoliteľnéválasztható
    Array of mergado query IDs. Required when apply_to=queries.
  • name string optionalvolitelnévoliteľnéválasztható
    Rule name.
  • overcharge_limit_max number optionalvolitelnévoliteľnéválasztható
    Maximum markup against the competition in percent.
  • overcharge_limit_min number optionalvolitelnévoliteľnéválasztható
    Minimum markup against the competition in percent.
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
  • rounding_type string optionalvolitelnévoliteľnéválasztható
    How to round the resulting price: ceil (up), floor (down), round (standard).
  • rounding_value integer optionalvolitelnévoliteľnéválasztható
    Round to the nearest multiple (1 = units, 10 = tens, 100 = hundreds).
  • skip_reference boolean optionalvolitelnévoliteľnéválasztható
    Skip the reference price when applying the rule.
  • start_at string optionalvolitelnévoliteľnéválasztható
    Date when the rule becomes active, in the YYYY-MM-DD format.
  • stop_at string optionalvolitelnévoliteľnéválasztható
    Date when the rule is deactivated, in the YYYY-MM-DD format.
  • type string optionalvolitelnévoliteľnéválasztható
    Rule type: plus (add to the price), minus (subtract from the price), equals (set to an exact value).
app_pricingfox_disable_connector Pricing Fox Writes dataZapisuje dataZapisuje dátaAdatot ír
Deactivates a specific connector of the project.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • connector string optionalvolitelnévoliteľnéválasztható
    Connector name (e.g. heureka-api).
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_edit_rule Pricing Fox Writes dataZapisuje dataZapisuje dátaAdatot ír
Edits an existing pricing rule in the project. All required fields must always be sent (not just the changed ones) – load the current rule via list_rules first and resend the unchanged values as they are.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • condition_selector string requiredpovinnépovinnékötelező
    How to pick the price from the conditions: min (lowest), max (highest), avg (average), first (first matching).
  • conditions array requiredpovinnépovinnékötelező
    New rule conditions (they replace the existing ones). Each condition must contain: source (heureka|mergado|input_price|import_price|kaufland|zbozi|gmc), type, operator, value (array of values).
  • diff_type string requiredpovinnépovinnékötelező
    Difference type: relative (percentage), absolute (absolute amount in the project currency).
  • final boolean requiredpovinnépovinnékötelező
    If true, no further rules are evaluated once this rule is applied.
  • name string requiredpovinnépovinnékötelező
    New rule name.
  • rounding_type string requiredpovinnépovinnékötelező
    Rounding mode: ceil (up), floor (down), round (standard).
  • rounding_value integer requiredpovinnépovinnékötelező
    Round to the nearest multiple (1 = units, 10 = tens).
  • type string requiredpovinnépovinnékötelező
    Rule type: plus (add to the price), minus (subtract from the price), equals (set to an exact value).
  • active boolean optionalvolitelnévoliteľnéválasztható
    Activate or deactivate the rule.
  • apply_to string optionalvolitelnévoliteľnéválasztható
    What the rule applies to: all (all products), queries (mergado queries), filters (product filters).
  • condition_join_operator string optionalvolitelnévoliteľnéválasztható
    Operator joining the conditions: and or or.
  • diff_value number optionalvolitelnévoliteľnéválasztható
    Price change value.
  • filters array optionalvolitelnévoliteľnéválasztható
    Array of product filter IDs. Required when apply_to=filters.
  • is_margin boolean optionalvolitelnévoliteľnéválasztható
    The rule works with the margin instead of the price.
  • is_test boolean optionalvolitelnévoliteľnéválasztható
    Test rule – it is not calculated into the feed output.
  • manual_limit_max_price number optionalvolitelnévoliteľnéválasztható
    Maximum absolute product price after the rule is applied.
  • manual_limit_min_price number optionalvolitelnévoliteľnéválasztható
    Minimum absolute product price after the rule is applied.
  • margin_limit_max number optionalvolitelnévoliteľnéválasztható
    Maximum margin in percent.
  • margin_limit_min number optionalvolitelnévoliteľnéválasztható
    Minimum margin in percent.
  • mergado_queries array optionalvolitelnévoliteľnéválasztható
    Array of mergado query IDs. Required when apply_to=queries.
  • overcharge_limit_max number optionalvolitelnévoliteľnéválasztható
    Maximum markup against the competition in percent.
  • overcharge_limit_min number optionalvolitelnévoliteľnéválasztható
    Minimum markup against the competition in percent.
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
  • rule_id integer optionalvolitelnévoliteľnéválasztható
    ID of the rule to edit.
  • skip_reference boolean optionalvolitelnévoliteľnéválasztható
    Skip the reference price when applying the rule.
  • start_at string optionalvolitelnévoliteľnéválasztható
    Date when the rule becomes active, in the YYYY-MM-DD format.
  • stop_at string optionalvolitelnévoliteľnéválasztható
    Date when the rule is deactivated, in the YYYY-MM-DD format.
app_pricingfox_enable_connector Pricing Fox Writes dataZapisuje dataZapisuje dátaAdatot ír
Activates a specific connector of the project with the given settings.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • connector string optionalvolitelnévoliteľnéválasztható
    Connector name (e.g. heureka-api).
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
  • settings object optionalvolitelnévoliteľnéválasztható
    Connector configuration.
app_pricingfox_get_competitor Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns detailed data about a specific competitor, including their metrics history for the given period.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • competitor_slug string optionalvolitelnévoliteľnéválasztható
    Competitor slug.
  • date_from string optionalvolitelnévoliteľnéválasztható
    Start date of the competitor history in the Y-m-d format (optional, defaults to 30 days ago).
  • date_to string optionalvolitelnévoliteľnéválasztható
    End date of the competitor history in the Y-m-d format (optional, defaults to today).
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_get_export Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the detail of a single export.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • export_id integer optionalvolitelnévoliteľnéválasztható
    Export ID.
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_get_import Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the detail of a single import.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • import_id integer optionalvolitelnévoliteľnéválasztható
    Import ID.
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_get_insights Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the insights of the project – changes detected over the last 30 days (price changes, competitor and rule product counts, new and dropped products).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_get_keychain Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the detail of a single API key stored in the keychain.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • keychain_id integer optionalvolitelnévoliteľnéválasztható
    ID of the keychain record (API key).
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_get_product Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns detailed information about a single product.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • product_id integer optionalvolitelnévoliteľnéválasztható
    Unique product ID.
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_get_product_history Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the history of prices and other product data for the given period (defaults to the last 7 days).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • from string optionalvolitelnévoliteľnéválasztható
    Start date (YYYY-MM-DD).
  • product_id string optionalvolitelnévoliteľnéválasztható
    Product ID.
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
  • to string optionalvolitelnévoliteľnéválasztható
    End date (YYYY-MM-DD).
app_pricingfox_get_project Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns basic information about the project and its e-shop (name, currency, settings, filters, metrics).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_get_project_metrics Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the metrics of the project (product counts, performance, statistics). When rule_id or filter_id is passed, the metrics are returned for that rule or product filter instead.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • date_from string optionalvolitelnévoliteľnéválasztható
    Start date of the report in the Y-m-d format (optional).
  • date_to string optionalvolitelnévoliteľnéválasztható
    End date of the report in the Y-m-d format (optional).
  • filter_id integer optionalvolitelnévoliteľnéválasztható
    ID of a product filter to get the metrics for (optional).
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
  • rule_id integer optionalvolitelnévoliteľnéválasztható
    ID of a specific rule to get the metrics for (optional).
app_pricingfox_get_project_settings Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the current pricing settings of the project (rounding, limits, data sources).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_get_project_settings_history Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the history of all changes of the project settings (who changed what and when).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_get_report_data Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the data of a specific report type.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • payload object optionalvolitelnévoliteľnéválasztható
    Request body with the report parameters.
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
  • report_type enum optionalvolitelnévoliteľnéválasztható
    Report type.
app_pricingfox_get_report_flop_products Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the least performing (flop) products for the given report.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • payload object optionalvolitelnévoliteľnéválasztható
    Request parameters with the product filter.
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_get_report_top_products Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the best performing (top) products for the given report.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • payload object optionalvolitelnévoliteľnéválasztható
    Request parameters with the product filter.
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_get_rule_history Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the change history of a specific pricing rule.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
  • rule_id integer optionalvolitelnévoliteľnéválasztható
    Rule ID.
app_pricingfox_get_top_products Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the list of the best / worst performing products of the project.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • limit integer optionalvolitelnévoliteľnéválasztható
    Number of products. Note: the underlying API does not support it, the value is ignored.
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_list_competitors Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the list of the e-shop competitors. The watched competitors are listed in the response meta.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_list_connectors Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the list of all available data connectors (data sources) and their state in the project.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_list_exports Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the list of all data exports of the project.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_list_imports Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the list of all data imports of the project.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_list_keychains Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the list of all stored API keys and connections of the project.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_list_product_filters Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the list of all saved product filters of the project.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_list_products Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the list of products with optional advanced filtering and sorting (e.g. by price or name).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • f object optionalvolitelnévoliteľnéválasztható
    Additional filter parameters (often used for fulltext search).
  • filter object optionalvolitelnévoliteľnéválasztható
    Filters (e.g. {"report_products_groups": "best_sellers", "tag_ids": "10|12"}).
  • order object optionalvolitelnévoliteľnéválasztható
    Sorting (e.g. {"column": "price", "direction": "desc"}).
  • page integer optionalvolitelnévoliteľnéválasztható
    Page number.
  • per_page integer optionalvolitelnévoliteľnéválasztható
    Number of products per page.
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_list_rules Pricing Fox Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the list of all pricing rules of the project.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_pause_import Pricing Fox Writes dataZapisuje dataZapisuje dátaAdatot ír
Pauses the given data import and returns the updated list of imports.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • import_id integer optionalvolitelnévoliteľnéválasztható
    Import ID.
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_pause_rules Pricing Fox Writes dataZapisuje dataZapisuje dátaAdatot ír
Pauses one or more pricing rules.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
  • rule_ids array optionalvolitelnévoliteľnéválasztható
    Array of IDs of the rules to pause.
app_pricingfox_regenerate_export Pricing Fox Writes dataZapisuje dataZapisuje dátaAdatot ír
Triggers regeneration of the export and returns the updated list of exports.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • export_id integer optionalvolitelnévoliteľnéválasztható
    Export ID.
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_reorder_rules Pricing Fox Writes dataZapisuje dataZapisuje dátaAdatot ír
Changes the order (priority) of the rules according to the order in the given list.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
  • rule_ids array optionalvolitelnévoliteľnéválasztható
    Array of rule IDs in the desired order (the first one has the highest priority).
app_pricingfox_start_import Pricing Fox Writes dataZapisuje dataZapisuje dátaAdatot ír
Starts the given data import and returns the updated list of imports.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • import_id integer optionalvolitelnévoliteľnéválasztható
    Import ID.
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_start_rules Pricing Fox Writes dataZapisuje dataZapisuje dátaAdatot ír
Starts (activates) one or more pricing rules.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
  • rule_ids array optionalvolitelnévoliteľnéválasztható
    Array of IDs of the rules to start.
app_pricingfox_unwatch_competitor Pricing Fox Writes dataZapisuje dataZapisuje dátaAdatot ír
Stops watching a competitor (removes them from the watched competitors).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • competitor_slug string optionalvolitelnévoliteľnéválasztható
    Competitor slug.
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
app_pricingfox_watch_competitor Pricing Fox Writes dataZapisuje dataZapisuje dátaAdatot ír
Starts watching a competitor (adds them to the watched competitors).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • competitor_slug string optionalvolitelnévoliteľnéválasztható
    Competitor slug.
  • project_id string optionalvolitelnévoliteľnéválasztható
    Project ID.
apply_rules_to_traced_products Writes dataZapisuje dataZapisuje dátaAdatot ír
Runs the project's rules over its traced products only - the same task the regular "apply rules" action dispatches, restricted to the sample. Use to refresh what `preview_rule_changes` reports after editing rules or changing which products are traced. The run is dispatched to the background, so the returned apply log is a receipt (`status: in_progress`), not a result - poll `get_apply_log` with its `id` for the outcome. A project that is read-only because another process is already running for it answers with a conflict.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose rules to run over its traced products. Get from `list_shop_projects`.
assign_query_to_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Attaches an existing query to a rule, adding to its scope (the rule applies to the UNION of all attached queries). Use to scope a rule down after creating it, or to add another query. The query must already exist - create it first with `create_project_query`, then attach it here.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • query_id string requiredpovinnépovinnékötelező
    ID of existing query to assign. Query must exist or 400 is returned.
  • rule_id string requiredpovinnépovinnékötelező
    ID of the rule to assign query to
create_batch_copy_values_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Batch Copy Values' rule in a project. Copy the content of a source element into a target element for matching products. Multiple source -> target mappings can be specified in a single rule. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants to copy values from one element to another in bulk (also swaps via a temporary element).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"rows":[{"source_element_path":"g:title","target_element_path":"g:custom_label_0","position":0}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_batch_delivery_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Batch Delivery' rule in a project. Add delivery information (courier company, price, cash-on-delivery price) to products. Multiple delivery options can be specified in a single rule. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants shipping/delivery prices composed per carrier.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"rows":[{"type":"CESKA_POSTA","price":"99","price_cod":"129"}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_batch_param_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Batch Param' rule in a project. Add product parameters (name/value/unit triples) in bulk. This is used for shopping feed PARAM elements such as those on Heureka. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants product parameters added per query; the `ep_*` settings must be full nested element paths.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"settings":{"ep_param":"g:product_detail","ep_param_name":"g:product_detail | g:attribute_name","ep_param_value":"g:product_detail | g:attribute_value"},"rows":[{"queries":["<query_id>"],"params":[{"param_name":"Material","value":"Cotton"}]}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_batch_rewriting_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Batch Rewriting' rule in a project. Rewrite an element's content per query condition. Each row associates a query (filter) with the replacement value. Products matching the query receive the specified value. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants a different value written per query (per-product or per-segment writes in one rule).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"rows":[{"query_id":123456,"value":"New value","position":0}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_batch_rewriting_values_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Bulk Rewriting by Values' rule in a project. Looks up each product's value in a SOURCE element and, when it matches a row's input_value, writes the row's output_value into a DESTINATION element — a lookup/mapping table (e.g. map source categories to target names). CAUTION — the two element-path fields are counter-intuitive: the top-level `element_path` is the DESTINATION (written into), while `data.target_element_path` is the SOURCE (searched); swapping them silently writes into the wrong element. Provide this rule type's parameters in the typed `data` object. At least one query is required in `queries` (objects [{"id": "..."}]); use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants a lookup/mapping table (source value → output value).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"regex":false,"target_element_path":"CATEGORYTEXT","rows":[{"input_value":"Old","output_value":"New","position":0}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_batch_set_datetime_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Batch Set Datetime' rule in a project. Set a date element to today's date plus a configurable number of days, formatted using a strftime-style format string. Each row targets products matching the listed queries. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants a date (now + N days) written per query.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"date_format":"Y-m-d","rows":[{"query_ids":["<query_id>"],"number_of_days":7}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_bidding_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Bidding' rule in a project. Adjust a CPC element's value based on product price. Specify an absolute increment, a percentage factor, or both. At least one field must be non-null. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants CPC bidding values set.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"bidding_strategy":"pricePercentage","price_percentage":10}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_calc_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Calculation' rule in a project: evaluates a mathematical expression and writes the result into `element_path`, optionally rounded and formatted. Supports + - * / and parentheses with standard operator precedence (* and / bind before + and -), so a flat expression like `1-%COST%/%PRICE%*100` evaluates as `1-((%COST%/%PRICE%)*100)` — parenthesise anything beyond a single operation. `%element%` references resolve to the product's current value at runtime; a value written with a space thousands separator and a decimal comma ("1 234,56") parses correctly. Use when the user wants a computed numeric value — margins, VAT, price adjustments, currency conversion. Rounding and number formatting are built into this rule (`rounding_type`, `decimal_places`, `decimal_separator`, `thousand_separator`), so no second rule is needed for that; use `create_rounding_rule` only to reformat an existing value with no arithmetic. A product whose expression cannot be evaluated — a non-numeric operand, or division by zero — is skipped and keeps its previous value; the rule itself does not fail. With `rounding_type` unset the raw result is written (e.g. `371.9008264463`), which most feed formats reject. The call returns the created rule only; computed values appear in the output after the next rebuild.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload; the backend validates it authoritatively. `expression` (required) holds the formula. Optional: `rounding_type` — one of `mathematical`, `up`, `down`, `to0or05`, `ending09`, `ending099`; `decimal_places` — precision as a string ("2", "0", "-1"); `decimal_separator` and `thousand_separator` — output format only. Example: {"expression":"%PRICE_VAT% * 1.21","rounding_type":"mathematical"}
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_casechanging_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Case Changing' rule in a project. Transform the capitalisation of text in an element. Supported modes: `lower`, `upper`, `sentence`, `word`, `firstletter`, `titlelongwords`. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants to change the letter case of a value.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"case_type":"lower"}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_categories_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Categories' rule in a project. Rename product categories by partial (or exact) match. Each row maps an input pattern to an output replacement. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants to bulk-rename categories into the format's category element (it ignores a custom `element_path`).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"rows":[{"input":"Shop > Shoes","output":"Apparel & Accessories > Shoes","position":0}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_create_product_value_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create an 'Add a Value to a Multi-Value Element' rule in a project. Appends a NEW value to an element that can hold multiple values (e.g. `g:additional_image_link`, categories, PARAM, alternative URLs) WITHOUT overwriting existing values — it writes to the next free position (equivalent to a Rewriting rule with element path `ELEMENT {@@POSITION = @@MAX_POSITION + 1}`). Use when the user wants to append an additional value to a multi-value element (e.g. add a second image or an extra category) without replacing what is already there. On an empty element it creates the first value; on an element that already has values it adds one more. Mergado variable expressions (e.g. `%element%`) are supported. Provide this rule type's parameters in the typed `data` object. At least one query is required in `queries` (objects `[{"id": "..."}]`); use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • data object optionalvolitelnévoliteľnéválasztható
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"value":"summer_2026"}`
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_data_import_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Data Import' rule in a project. Import product data from an external CSV or XML file (via URL) or from a previously uploaded file. The imported data is matched against products and applied as additional element values. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants to enrich products from an external CSV/XML file matched by a key (use a public source URL; base64 upload is a silent no-op).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"file_type":"csv","data_source_type":"url","source_url":"https://docs.example.com/data.csv","matching_mode":"exact"}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_element Writes dataZapisuje dataZapisuje dátaAdatot ír
Creates a new element in a project. Use when adding an output element required by a target format (e.g. `g:gtin` for Google Shopping) that does not yet exist in the element tree. After creating it, use a rule (e.g. a `create_<type>_rule` tool) to fill it with values. Pass `parent_id` to nest it under an existing element (a child), or omit it for a top-level element.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • name string requiredpovinnépovinnékötelező
    Element name/tag (e.g. "CUSTOM_FIELD", "BRAND"). Must be valid XML tag name.
  • project_id string requiredpovinnépovinnékötelező
    ID of the project where element will be created
  • hidden boolean optionalvolitelnévoliteľnéválasztható
    Whether the element is hidden from UI
  • parent_id string optionalvolitelnévoliteľnéválasztható
    Optional ID of the parent element to nest this element under (creates a child element). Get the parent ID from `list_project_elements`. Omit to create a top-level element.
create_feedaudit Writes dataZapisuje dataZapisuje dátaAdatot ír
Creates and triggers a new asynchronous feed audit for a project to validate feed data against advertising channel standards (e.g. Heureka, Google, Zboží) and detect errors or missing attributes. Requires project_id (from list_shop_projects) and feed_url (the source XML/CSV feed URL from get_project). Optionally specify feed_types to target specific channel formats. Returns the created audit object with its id and initial status. Audits run asynchronously in the background — proceed by polling get_feedaudit with the returned id until status reaches "done", then inspect detected issues via list_feedaudit_issues.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • feed_url string requiredpovinnépovinnékötelező
    Source feed URL to audit. Required: the endpoint rejects a request without it (`400 Field 'feed_url' is not in required format`) despite the API docs implying otherwise. To audit the project's own feed, take the URL from `get_project`.
  • project_id string requiredpovinnépovinnékötelező
    ID of the project to audit. Get it from `list_shop_projects`.
  • feed_types array optionalvolitelnévoliteľnéválasztható
    Comparison-shopping formats to validate the feed against, e.g. ["heureka.cz", "zbozi.cz"]. Pass it. Omitted, Mergado guesses the formats from the feed's structure and does NOT consult the project's input format - measured on a `<SHOP>/<SHOPITEM>` heureka.cz feed in a heureka.cz project: the guess was `glami.ee`, so the audit validated against the GLAMI/Biano/Skrz family and reported 136 error-level findings for a missing DELIVERY_DATE, an element heureka.cz does not require. The same feed audited as `["heureka.cz"]` returned 1089 findings from heureka validators instead. Both audits are internally consistent, and only one of them answers the question the user asked, so take the formats from `get_project` (or from the user) rather than letting the guess decide which rulebook the feed is judged by.
  • parser_type string optionalvolitelnévoliteľnéválasztható
    Input-feed parser type, e.g. "heureka.cz" - how the feed is READ, where `feed_types` is what it is judged against. Auto-detected when omitted, and the detection is a structural guess that carries the same risk: feed families sharing the `<SHOP>/<SHOPITEM>` shape are told apart by their elements, not by the project, so a heureka.cz feed was read as `glami.ee`. Set it alongside `feed_types` when you know the format. The value the audit actually used comes back on the audit's `parser_type` - worth checking against what you expected before reporting the findings.
  • webhook_url string optionalvolitelnévoliteľnéválasztható
    URL pinged once the audit finishes. Optional.
create_hiding_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Hiding' rule in a project. Hide (remove from output) all products that match the rule's queries. No additional data fields are required. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants to remove whole products from the output feed.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • data object optionalvolitelnévoliteľnéválasztható
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{}`
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_params_remove_by_value_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Params Remove By Value' rule in a project. Hide specific parameter values (or entire parameters) from the output. Each row specifies a parameter name and the list of values to remove. An empty `values` list removes all values for that parameter. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants specific parameter values removed from a PARAM-style structure.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"ep_param":"PARAM","ep_param_name":"PARAM_NAME","ep_param_value":"VAL","rows":[{"param_name":"Color","values":["Red"]}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_product_grouping_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Product Grouping' rule in a project. Group variant products together into a single product with multiple variants. Specify which elements identify products and groups, and define per-element MERGE or EXTRACT actions. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). This rule type does not require any queries. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants product variants merged (a whole-feed rule).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"product_key_element_path":"g:id","group_key_element_path":"g:item_group_id"}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
  • queries array optionalvolitelnévoliteľnéválasztható
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
create_project Writes dataZapisuje dataZapisuje dátaAdatot ír
Creates a new project (output feed) inside an existing shop. A project fetches the source feed at `url`, transforms it via rules, and exports it in `output_format`. Only `name` and `url` are required, omit the optional fields to let Mergado auto-detect the input format and apply defaults. Get `shop_id` from `list_user_eshops` and discover valid format IDs via `list_supported_feed_formats`. Projects go live and start syncing right after creation — there is no draft state to review before it's live. Call `get_project` afterward to see whether it's already synced rather than assuming it from this response.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • input_format string requiredpovinnépovinnékötelező
    Format identifier of the source feed (e.g. "heureka.cz", "zbozi.cz", "google"). Native or custom. Call `list_supported_feed_formats` for the valid IDs and pick the one matching the feed at `url` - a Google Sheets link is "googlesheets.global", which reads the ordinary /edit link as it stands. Where the feed is not a recognisable channel feed, ask the user which format it follows rather than guessing: the wrong format imports nothing.
  • name string requiredpovinnépovinnékötelező
    Project name. Max 100 characters, must be unique within the shop. Shown in the Mergado UI and helps identify the project purpose (e.g. "Google Shopping Feed", "Heureka Export").
  • output_format string requiredpovinnépovinnékötelező
    Format the transformed feed is exported in (e.g. "heureka.cz", "billiger.de", "google"). Native or custom, discover valid IDs via `list_supported_feed_formats`. Ask the user which advertising channel this project is for if they have not said - it decides the shape of everything the project produces.
  • pairing_elements string requiredpovinnépovinnékötelező
    Element that identifies a product across synchronisations, e.g. "ITEM_ID", "EAN" or "URL". Mergado matches every re-import on it, so a project created without one imports no products at all. Name an element that actually exists in the source feed: read the feed to find its identifier column, and if there is no obvious one - or more than one candidate - ask the user which to pair on rather than guessing. Several elements are given separated by a comma.
  • shop_id string requiredpovinnépovinnékötelező
    ID of the shop (eshop) where this project will be created. Must be an existing shop ID from your account, get it from `list_user_eshops`.
  • url string requiredpovinnépovinnékötelező
    Source feed URL. Must use an http, https, or sftp scheme. This feed is fetched and transformed by Mergado (e.g. "https://example.com/products.xml"). Mergado also downloads it during creation, so it has to be reachable.
  • autohide_new_products boolean optionalvolitelnévoliteľnéválasztható
    Optional. When true, products newly appearing after a synchronisation are automatically hidden until reviewed. Defaults to false.
create_project_query Writes dataZapisuje dataZapisuje dátaAdatot ír
Creates a standalone, reusable query in a project (a saved MQL product selection) that can be attached to one or more rules with `assign_query_to_rule`. Even a query used by a single rule is created here first, then attached via `assign_query_to_rule`. Use to define which products a rule should target, or to verify a hypothesis about the data (check the match via `list_project_products` with the same `mql`). The query is re-evaluated on every project rebuild — write it as a condition over element values, not as a list of product IDs matching the condition today. Call workflow_element_paths_and_mql first for MQL limits and selection patterns.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • name string requiredpovinnépovinnékötelező
    Descriptive name for the query (e.g. "Products under $10", "Items without images"). Helps identify query purpose.
  • project_id string requiredpovinnépovinnékötelező
    ID of the project where this query will be created
  • query string requiredpovinnépovinnékötelező
    Query expression using MQL (Mergado Query Language). Can filter, aggregate, or transform data (e.g. "PRICE < 10", "CATEGORY = Electronics").
  • read_only boolean optionalvolitelnévoliteľnéválasztható
    Whether this query is read-only (cannot be modified)
  • search_output boolean optionalvolitelnévoliteľnéválasztható
    True to query output data (after rules), False to query input data
create_remove_diacritics_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Remove Diacritics' rule in a project. Remove diacritical marks (accents) from the content of the targeted element. Useful for generating URL-safe or ASCII-only values (e.g. image URLs). No additional configuration is required. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants accents/diacritics removed from a value.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • data object optionalvolitelnévoliteľnéválasztható
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{}`
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_replacing_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Replacing' rule in a project. Find and replace content within element values. Supports plain text and regular expressions. Multiple search/replacement pairs can be specified in `rows`. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants find-and-replace inside values (plain text or regex with `\1` group references).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"regex":false,"case_sensitive":false,"rows":[{"search":"old","replacement":"new","position":0}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_rewriting_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Rewriting' rule in a project. Replace the content of one or more product elements with a new value. Mergado variable expressions (e.g. `%ITEM_ID%`) are supported in `new_content`. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants to overwrite an element's content (supports `%element%` references).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"rows":[{"element_path":"g:title","new_content":"%MANUFACTURER% %g:title%"}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_rounding_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Rounding' rule in a project. Round a numeric element value to a fixed number of decimal places. The separators control how the formatted output looks. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants prices rounded
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"rounding_type":"mathematical","decimal_places":0}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_shop Writes dataZapisuje dataZapisuje dátaAdatot ír
Creates a new eshop (the top-level container that owns projects/feeds) for the current account. Only a `name` is required, Mergado trims it and converts it to title case. Use this during onboarding before creating any project, the returned `id` is the `shop_id` you pass to `create_project`. To configure the eshop's website or XML domain afterwards, use `update_shop`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • name string requiredpovinnépovinnékötelező
    E-shop name. Max 100 characters. The value is trimmed and converted to title case by Mergado (e.g. "example.com").
create_tagstripping_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Tag Stripping' rule in a project. Remove all HTML tags from the content of the targeted element. No additional configuration is required. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants HTML tags stripped from a value.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • data object optionalvolitelnévoliteľnéválasztható
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{}`
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_truncating_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Truncating' rule in a project. Shorten the content of an element to a specified maximum length. The intelligent flag attempts to truncate at a word boundary. The *append* string (e.g. `...`) is appended after the truncated text. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants values shortened to a length limit.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"max_length":150,"intelligent":true,"append":"…"}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_utm_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'UTM Parameters' rule in a project. Append UTM tracking parameters to product URLs. Mergado variable expressions (e.g. `%ITEM_ID%`) are supported in all text fields. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants UTM tracking parameters appended to product URLs.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • data object optionalvolitelnévoliteľnéválasztható
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"utm_source":"mergado","utm_medium":"cpc","utm_campaign":"summer_2026"}`
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path - it must already exist in the project. Take it verbatim from `element_path` in `list_project_elements`: a child element is written `PARENT | CHILD` and an attribute `PARENT | @ATTRIBUTE`, not as an XPath. The backend rejects a path the project does not have.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_variable Writes dataZapisuje dataZapisuje dátaAdatot ír
Creates a variable in a project. Use for: (a) named constants used by multiple rules (shipping_cost, vat_rate), (b) regex extraction (define a regex once, reference it in rules), or (c) computed values. The variable name becomes the reference token in rules: `{name}`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • element_path string requiredpovinnépovinnékötelező
    Element path from which the variable value is extracted (e.g. "ITEM | PRICE", "PARAM { NAME = 'color' } | VALUE")
  • name string requiredpovinnépovinnékötelező
    Variable name/identifier. Use clear, descriptive names (e.g. "shipping_cost", "vat_rate"). This will be referenced in rules and queries.
  • project_id string requiredpovinnépovinnékötelező
    ID of the project where this variable will be created and available for use
  • fragment_number integer optionalvolitelnévoliteľnéválasztható
    Optional regex group/fragment number to extract (used with regular_expression)
  • regular_expression string optionalvolitelnévoliteľnéválasztható
    Optional regex pattern to extract part of the element value
  • sample_text string optionalvolitelnévoliteľnéválasztható
    Optional sample text for UI/testing purposes
delete_element Writes dataZapisuje dataZapisuje dátaAdatot ír
Deletes an element AND all of its child elements. Any rules referencing this element will break. Get the user's explicit confirmation, especially for parent elements (e.g. PARAM, g:shipping). Check the `children` field from `list_project_elements` and list the affected children in the confirmation. Use only to remove an element you created (e.g. a helper element after a one-off import); ask the user before deleting anything else.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Element ID to delete. Get from `list_project_elements`. Deletes all child elements too.
delete_project Writes dataZapisuje dataZapisuje dátaAdatot ír
Returns the link to the Mergado page where the user deletes a project, together with the project's name so they can confirm it is the right one. Use when the user asks to delete, remove or get rid of a project. This tool deletes NOTHING and cannot: Mergado has no delete endpoint (`DELETE /projects/{id}/` answers 405), because removing a project takes a feed offline for every advertising channel reading it, and that decision is left to a human in front of the confirmation dialog. All this does is read the project - to check it exists and to name it - and build the address of that dialog. So do not report the project as deleted. Give the user the link, tell them it is the last step and that they still have to confirm it there, and say which project it is for. Deleting a project cannot be undone, and its rules, queries and history go with it.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID to delete. Get from `list_shop_projects`.
delete_query Writes dataZapisuje dataZapisuje dátaAdatot ír
Deletes a query. If the query is attached to a rule, that rule is left with one fewer scope query - or fails on the next apply if it was the only one (every rule must have at least one query). Check `list_rule_queries` for consumers first. System queries (`read_only=true`) cannot be deleted. Use to clean up queries you created; ask the user before deleting queries you did not create.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Query ID to delete. Get from `list_project_queries` or `list_rule_queries`. System queries (`read_only=true`) cannot be deleted.
delete_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Deletes a rule and all of its rule-level queries (project-level queries persist). Products previously affected by this rule revert to their pre-rule values on the next rebuild. Get the user's explicit confirmation first, especially for high-priority rules (applied first) or `format_converter` rules (essential for output). Rules with `is_deletable=false` cannot be deleted. Use to remove a rule after user confirmation. To change an existing rule's name or configuration prefer `update_rule` (keeps position and queries); delete + recreate only when changing the rule's type.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Rule ID to delete. Get from `list_project_rules`. Rules with `is_deletable=false` (system rules) cannot be deleted.
delete_variable Writes dataZapisuje dataZapisuje dátaAdatot ír
Deletes a variable. Rules referencing this variable will silently fail to expand the `{var_name}` token on the next rebuild - search rules for references first (`list_project_rules`). Use to clean up variables you created; ask the user before deleting others.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Variable ID to delete. Get from `list_project_variables`.
duplicate_project Writes dataZapisuje dataZapisuje dátaAdatot ír
Copies an existing project into the same shop, or into another shop when `shop_id` is given. Use when the user wants a second feed built on the same rules - the same products exported to another channel, or a copy to experiment on without touching the original. Copied: the project settings and project info, its elements, variables, queries, and its whole rule chain with schedules. NOT copied: app rules, Heureka Watchdog pairing rules, and everything produced by a feed run (products, logs, the export URL). The copy is created immediately and answers with its `id`, but it holds no data yet: Mergado enables it and schedules its first feed download straight away, and the products appear when that import and the first rule apply have finished. So do not read products from it, or judge its rules by them, right after creating it. Its feed URL does not work yet either - and the copy reports the SOURCE project's `exported_items` until it has exported once, so that number is no evidence to the contrary. Two things this changes and cannot undo, so get the user's explicit consent first: it creates a live project that starts downloading the source feed, and (with `shop_id`) it can put it in a different shop. The name must be unique in the target shop, and the token must belong to a user - Mergado records who duplicated the project, so a service token is refused.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • name string requiredpovinnépovinnékötelező
    Name of the new project. Max 100 characters and must not already exist in the target shop (Mergado answers 409 if it does). Ask the user what to call the copy rather than inventing a name - it is what they will see in the Mergado UI.
  • project_id string requiredpovinnépovinnékötelező
    ID of the project to copy. Get it from `list_shop_projects`. Everything configured on it is copied - settings, project info, elements, variables, queries and rules with their schedules.
  • shop_id string optionalvolitelnévoliteľnéválasztható
    Optional. ID of the shop to create the copy in, from `list_user_eshops`. Defaults to the source project's own shop. Copying into another shop additionally requires permission to manage that shop's projects.
get_access_log Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a single access record. Returns 410 if the related project has been deleted (the log is preserved but the linked resource is gone). Use rarely - the `get_access_logs` listing is usually enough.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the access log to fetch. Get it from `get_access_logs`.
get_access_logs Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the history of HTTP access to the project's output feed URL - which ad-channel crawlers (GMC, Heureka, ...) fetched the feed, when, and the response status. Use to verify ad channels are consuming the feed regularly.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project whose access logs to retrieve
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
get_app_by_name Read-onlyPouze čteníIba čítanieCsak olvasás
Returns metadata of a specific app from the global catalog by its slug name (e.g. 'biddingfoxelements', 'feedimageeditor', 'mergadoaudit'). Use to look up an app's description, latest release date, or capabilities. For apps currently enabled by a user/shop/project, use `list_user_apps` / `list_shop_apps` / `list_project_apps`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • name string requiredpovinnépovinnékötelező
    Name (ID) of the application
get_apply_log Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a single rule-application run. Use after `get_apply_logs` when you need granular per-rule diagnostics for a specific run.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the apply log to fetch. Get it from `get_apply_logs`.
get_apply_logs Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the history of rule-application runs for a project (timestamp, duration, item count, per-rule processed counts). 'Apply' transforms data internally, it does not publish to the output feed - that is 'rebuild'. Use for forensic "when were rules last applied" or to diagnose unexpected rule behavior.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project whose apply logs to retrieve
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
get_current_user Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the user account that the current OAuth token belongs to. Use this as the first call in any user-scoped workflow to confirm identity. Requires a user-bound ONLINE token (an OAuth token tied to a specific Mergado user, not a server-to-server token). If you get a 401 or a 'token scope not valid' error, ask the user to (re)authorize Mergado MCP.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek

This tool takes no input parameters.Tento nástroj nemá žádné vstupní parametry.Tento nástroj nemá žiadne vstupné parametre.Ennek az eszköznek nincsenek bemeneti paraméterei.

get_element Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a single element (path, type, is_attribute, origin, hidden flag). Use to verify properties before an update or delete. Get the element ID from `list_project_elements`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Element ID to fetch. Get from `list_project_elements`.
get_export_log Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a single output-feed export run. Use after `get_export_logs` to inspect a specific export.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the export log to fetch. Get it from `get_export_logs`.
get_export_logs Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the history of output-feed exports for a project (= publishing applied data to the output feed file). Each entry has a timestamp, items exported, exported_product_group_count, and duration. Use to confirm the last successful publish and to diagnose stale outputs.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project whose export logs to retrieve
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
get_feedaudit Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the current status, progress, timing, and summary metadata of a single feed audit. Use to poll a running audit until completion or to check if an audit finished with errors before querying its issues. Requires id (the audit ID from create_feedaudit or list_project_feedaudits). Returns the audit record including status, progress, product counts, and failure reasons if any. Once status is "done", proceed to list_feedaudit_issues for concrete diagnostic findings.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the feed audit. Get from `list_project_feedaudits`.
get_feedaudit_issue Read-onlyPouze čteníIba čítanieCsak olvasás
Returns a single audit issue by ID, including the validator, verdict, severity, and validator-specific context (`info`). Use to inspect one issue surfaced by `list_feedaudit_issues`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the audit issue. Get from `list_feedaudit_issues`.
get_feedaudit_product Read-onlyPouze čteníIba čítanieCsak olvasás
Returns a single audited product with all its parsed feed element tags and original values as recorded at audit time. Use when troubleshooting a specific product that failed validation to inspect its raw input data. Requires id (the audited product ID from list_feedaudit_products or list_feedaudit_issues). Returns the full product data object containing all XML/feed element tag-value pairs.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the audited product. Get from `list_feedaudit_products`.
get_format Read-onlyPouze čteníIba čítanieCsak olvasás
Returns basic metadata about a feed format (name, country, source channels). For the full element specification (required/optional elements and their types), use `get_format_specification`. Use when you need the human-readable definition of a feed format (e.g. before creating a project or mapping elements).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • format_id string requiredpovinnépovinnékötelező
    Format ID (e.g. 'heureka.cz', 'zbozi.cz')
get_format_specification Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the full element specification of a format (required/optional elements and their types). For basic metadata only (name, country, source channels), use `get_format`. Use when you need the full element-level specification of a format, e.g. to find required elements a feed is missing.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • format_id string requiredpovinnépovinnékötelező
    Format ID (e.g. 'heureka.cz', 'zbozi.cz')
get_import_log Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a single input-feed import run, including the error message if it failed. Use after `get_import_logs` to dig into a specific failure - the error usually contains an HTTP status (404/500), a parse error line, or a timeout reason.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the import log to fetch. Get it from `get_import_logs`.
get_import_logs Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the history of input-feed fetches for a project (items received vs processed, created/updated/removed, duration, status). Use to diagnose "the feed didn't download" or "where did the products go" by comparing items vs items_processed.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project whose import logs to retrieve
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
get_notification Read-onlyPouze čteníIba čítanieCsak olvasás
Returns a single notification by ID. Use after `get_user_notifications` to read the full body of a specific notification. (tied to a specific user).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Notification ID to retrieve. Get it from `get_user_notifications`.
get_pairing Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a single pairing record - input item identifier, matched output item ID, and the matching elements used. Use after `list_pairings` to inspect a specific pairing.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the pairing to fetch. Get it from `list_pairings`.
get_product Read-onlyPouze čteníIba čítanieCsak olvasás
Returns a single product (input and output data) by its product ID. Get the ID from `list_project_products` or `query_products`. Use to inspect one product in full detail after finding it via `list_project_products` or `query_products`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Product ID to retrieve. Get it from `list_project_products` or `query_products`.
get_project Read-onlyPouze čteníIba čítanieCsak olvasás
Returns core project fields (URL, input/output formats, status, timestamps). The default `all_products_query_id` (needed when targeting every product in a rule) is available per project in the `list_shop_projects` listing.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID to fetch. Get from `list_shop_projects`.
get_project_app Read-onlyPouze čteníIba čítanieCsak olvasás
Fetches subscription details (free_until, paid_until) for a project-level app. Use after `list_project_apps` to inspect a specific subscription.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • app_name string requiredpovinnépovinnékötelező
    Name (ID) of the application
  • project_id string requiredpovinnépovinnékötelező
    ID of the project
get_project_feed_url Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the public URL of a project's output feed - the XML address to give an advertising channel (Google Merchant Center, Heureka, Zbozi, GLAMI, ...) or to open to inspect the exported data. Use whenever the user asks where their feed is, what link to submit to a channel, or for the export/output URL of a project. Mergado does not send the URL as a field: it is composed from the project's `slug`, which is what this tool reads. The answer is deliberately just the URL and the project it belongs to, plus `exported_items` - zero there means the project has never exported, which is one of the two reasons a correctly built URL still answers 404. The other is a project that is turned off; `get_project` reports that. This reads the project only; it changes nothing and triggers no export.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose output feed URL to build. Get from `list_shop_projects`.
get_query Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a single query - its MQL expression, count of matching products, and `read_only` flag. Use to inspect a query before reusing it or before `update_query`. To get the actual products matching the query, use `query_products`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Query ID to fetch. Get from `list_project_queries` or `list_rule_queries`.
get_rule Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a single rule instance - type, priority, `applies` (active), queries (scope), and the rule-type-specific `data` field. Use before `delete_rule`, or to read the current state before changing a rule. To change a rule in-place use `update_rule` (name / configuration `data`); use `delete_rule` + recreate only when changing the rule's type.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Rule ID to fetch. Get from `list_project_rules`.
get_shop Read-onlyPouze čteníIba čítanieCsak olvasás
Returns core shop fields (name, owner, tariff). For usage statistics and keychain (ad channel auth) connections, use `get_shop_info` instead. Use to confirm shop identity/tariff before working on its projects.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Shop ID to fetch. Get from `list_user_eshops`.
get_shop_app Read-onlyPouze čteníIba čítanieCsak olvasás
Fetches subscription details (free_until, paid_until) for a shop-level app. Use after `list_shop_apps` to inspect a specific subscription.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • app_name string requiredpovinnépovinnékötelező
    Name (ID) of the application
  • shop_id string requiredpovinnépovinnékötelező
    ID of the shop
get_shop_event_logs Read-onlyPouze čteníIba čítanieCsak olvasás
Retrieves the audit log of significant shop-level events tariff changes, project create/delete, user permission changes, payment events. Use for forensic "who changed what and when" questions. Get the shop ID from `list_user_eshops`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • shop_id string requiredpovinnépovinnékötelező
    ID of the shop whose event logs to retrieve
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
get_shop_info Read-onlyPouze čteníIba čítanieCsak olvasás
Returns enriched shop info usage statistics and keychain (ad channel auth) connections. Use for questions about ad channel integrations or shop utilization. For core fields (name, owner, tariff), use `get_shop` instead.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Shop ID whose info to retrieve. Get it from `list_user_eshops`.
get_stats_audit Read-onlyPouze čteníIba čítanieCsak olvasás
Returns a single shop statistics audit: its date, status, product count, and a per-validator issue summary (ok/wrong/missing counts with item totals). The `id` is the composite `{m3shop_id}-{date_id}` (e.g. `1276-260625`) taken from `list_shop_stats_audits`. This is the stats-side audit, distinct from a project feed audit - use `get_feedaudit` for the latter. Use to read one stats audit found via `list_shop_stats_audits`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Composite statistics-audit ID of the form `{m3shop_id}-{date_id}` (e.g. `1276-260625`). Get it from `list_shop_stats_audits`.
get_tariff Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a specific tariff (name, prices in all currencies, included limits). Use after identifying a `tariff_id` from `list_user_eshops` or `get_shop`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Tariff ID to fetch. Get it from `list_available_tariffs`.
get_user Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a specific user by their ID. Use only for users that share an eshop with the current user (visible via `list_users`). For the current user's own identity, prefer `get_current_user`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    User ID to retrieve. Get it from `get_current_user` or `list_users`.
get_user_app Read-onlyPouze čteníIba čítanieCsak olvasás
Fetches a specific user-level app subscription (free_until, paid_until). Use after `list_user_apps` to check the expiration of a specific app.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • app_name string requiredpovinnépovinnékötelező
    Name (ID) of the application
  • user_id string requiredpovinnépovinnékötelező
    ID of the user
get_user_custom_formats Read-onlyPouze čteníIba čítanieCsak olvasás
Returns a user-defined ("custom") feed format. A custom format is a user-created alternative to Mergado's built-ins (heureka.cz, zbozi.cz, google.cz, ...). Its ID looks like `custom.cz.36562` and it can be used as an input or output format. Use when a project's `input_format` or `output_format` starts with `custom.*` and you need its specification.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • format_id string requiredpovinnépovinnékötelező
    Custom format ID to retrieve (e.g. 'custom.cz.36562'). Get it from a project's `input_format` / `output_format` when it starts with `custom.*`.
  • id string requiredpovinnépovinnékötelező
    User ID who owns the custom formats. Get it from `get_current_user`.
get_user_eshop_permissions Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the role (writer / admin / owner) a specific user has in a specific eshop. Use to check whether a user can perform an action on a shop before suggesting it. Returns 404 if no permission exists.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • shop_id string requiredpovinnépovinnékötelező
    ID of the shop
  • user_id string requiredpovinnépovinnékötelező
    ID of the user
get_user_notifications Read-onlyPouze čteníIba čítanieCsak olvasás
Returns all notifications for a user (system messages, billing reminders, app updates). Use when the user asks whether they have anything new in their account, or to check whether a previously sent notification was delivered.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • user_id string requiredpovinnépovinnékötelező
    ID of the user whose notifications to retrieve
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
get_user_permissions Read-onlyPouze čteníIba čítanieCsak olvasás
Lists a user's eshop access roles (writer / admin / owner) across all their shops. Use to answer "what can this user do" or to verify access before suggesting an action on a shop.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    User ID whose permissions to retrieve. Get it from `get_current_user`.
get_user_project_permissions Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the role a specific user has in a specific project. Mostly inherits from the eshop permission - use only for projects with a permission override, otherwise `get_user_eshop_permissions` is sufficient. Use when an operation fails with 403 to check the user's role on the project.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project
  • user_id string requiredpovinnépovinnékötelező
    ID of the user
get_variable Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a variable - name, type, element path, regex. Get the variable ID from `list_project_variables`. Use to read a variable's definition (element path, regex, fragment) before referencing it as `%NAME%` in a rule.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Variable ID to fetch. Get from `list_project_variables`.
list_apps Read-onlyPouze čteníIba čítanieCsak olvasás
Lists the global catalog of all Mergado apps available (Audit, FIE, Translator, Bidding Fox, Pricing Fox, ...). This is the CATALOG of available apps - to see apps currently enabled by a user / shop / project, use `list_user_apps` / `list_shop_apps` / `list_project_apps`. Use to look up the global app catalog, e.g. before checking whether a shop or project has an app installed.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_available_tariffs Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the catalog of all available Mergado tariffs with prices in CZK / EUR / PLN / GBP / USD. Tariffs are auto-assigned based on product count. Use when the user asks what a tariff costs or to explain an auto-upgrade.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_feedaudit_issues Read-onlyPouze čteníIba čítanieCsak olvasás
Lists all validation issues, errors, warnings, and missing element recommendations detected by a completed feed audit. Main diagnostic tool for feed quality analysis. Use after an audit status is "done". Requires id (the audit ID). Token efficiency: Audits can generate large outputs; pass the fields parameter with ["id", "level", "verdict", "validator", "product_id"] to trim heavy metadata and avoid context limits. Use limit and offset for pagination. Returns an array of issue items with severity levels, validator names, human-readable verdicts, and affected product IDs. Call get_feedaudit_issue for deeper context on a specific issue.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the feed audit whose issues to list. Get from `list_project_feedaudits`.
  • fields array optionalvolitelnévoliteľnéválasztható
    Optional. Return only these keys per issue, e.g. `["id", "level", "verdict", "validator", "product_id"]`. Worth using on any real audit: every issue otherwise repeats the full `feed_types` list of the formats it applies to, which dominates the row. Measured on a 545-issue audit: 604 kB untrimmed, 132 kB trimmed to those five keys. Valid keys: id, audit_id, product_id, validator, verdict, level, checked_at, info, feed_types. Keep `info` when you intend to explain a finding - it carries the offending element. Keys you leave out still come back in the result as null - that is this server filling in its response model, not the audit reporting an empty value. Read a trimmed row only for the keys you asked for. An unknown key is rejected outright (`400 Unknown field '<key>' in 'fields'`), so a typo fails loudly rather than silently emptying the response.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of rows to return. Do NOT pass an exact multiple of 100 - on the feed-audit listings that value is broken upstream, in both of its failure directions. If at least 100 rows would be left unreturned the request is refused outright (`400 Invalid limit or offset.`), and if fewer than 100 would be left the limit is ignored and the ENTIRE collection comes back while the envelope still echoes the limit you asked for - so a request for 100 rows can quietly return thousands. Add one: 201, 1001 and 2001 all behave exactly as asked. Every non-multiple of 100 was correct at every size measured; `offset` is sound throughout and needs no such care.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_feedaudit_product_issues Read-onlyPouze čteníIba čítanieCsak olvasás
Lists all validation issues and errors that apply to one specific audited product item. Use to answer "what errors and warnings exist for this specific product?" after finding a problematic product in list_feedaudit_products. Requires id (the audited product ID from list_feedaudit_products or list_feedaudit_issues). Supports limit and offset pagination. Returns all error, warning, and recommendation records specifically tied to that product.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the audited product whose issues to list. Get from `list_feedaudit_products`.
  • fields array optionalvolitelnévoliteľnéválasztható
    Optional. Return only these keys per issue. Same keys as `list_feedaudit_issues`: id, audit_id, product_id, validator, verdict, level, checked_at, info, feed_types. `feed_types` is the bulk of an untrimmed row here too. Keys you leave out still come back in the result as null - that is this server filling in its response model, not the audit reporting an empty value. Read a trimmed row only for the keys you asked for. An unknown key is rejected outright (`400 Unknown field '<key>' in 'fields'`), so a typo fails loudly rather than silently emptying the response.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of rows to return. Do NOT pass an exact multiple of 100 - on the feed-audit listings that value is broken upstream, in both of its failure directions. If at least 100 rows would be left unreturned the request is refused outright (`400 Invalid limit or offset.`), and if fewer than 100 would be left the limit is ignored and the ENTIRE collection comes back while the envelope still echoes the limit you asked for - so a request for 100 rows can quietly return thousands. Add one: 201, 1001 and 2001 all behave exactly as asked. Every non-multiple of 100 was correct at every size measured; `offset` is sound throughout and needs no such care.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_feedaudit_products Read-onlyPouze čteníIba čítanieCsak olvasás
Lists all products captured and evaluated during a feed audit, showing parsed element values as they existed in the feed at audit time. Use to inspect the audited product catalog or cross-reference products against detected audit issues. Requires id (the audit ID from list_project_feedaudits). Supports limit and offset pagination, and optional fields array. Returns a list of products with their internal IDs and parsed feed elements. To inspect all issues for a specific product, call list_feedaudit_product_issues with the product's ID.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the feed audit whose products to list. Get from `list_project_feedaudits`.
  • fields array optionalvolitelnévoliteľnéválasztható
    Optional. Return only these keys per product. Valid keys: id, audit_id, elements. `elements` is the whole payload here - it holds every parsed tag of every product - so this is the most effective trim on any feed-audit listing: a 136-product audit is 253 kB whole and 9.8 kB as `["id"]`. Trim to `["id"]` when you only need to count the products or map issue `product_id`s onto rows, and omit `fields` when you need to identify the products themselves. Keys you leave out still come back in the result as null - that is this server filling in its response model, not the audit reporting an empty value. Read a trimmed row only for the keys you asked for. An unknown key is rejected outright (`400 Unknown field '<key>' in 'fields'`), so a typo fails loudly rather than silently emptying the response.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of rows to return. Do NOT pass an exact multiple of 100 - on the feed-audit listings that value is broken upstream, in both of its failure directions. If at least 100 rows would be left unreturned the request is refused outright (`400 Invalid limit or offset.`), and if fewer than 100 would be left the limit is ignored and the ENTIRE collection comes back while the envelope still echoes the limit you asked for - so a request for 100 rows can quietly return thousands. Add one: 201, 1001 and 2001 all behave exactly as asked. Every non-multiple of 100 was correct at every size measured; `offset` is sound throughout and needs no such care.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_pairings Read-onlyPouze čteníIba čítanieCsak olvasás
Returns product pairings for a project. A 'pairing' is Mergado's internal identification of which input feed item corresponds to which output feed item across feed reloads, so that user-applied changes (hide/show, manual values) persist when the input feed is re-imported. The matching key elements are defined in the project's `pairing_elements` (typically ITEM_ID, EAN, PRODUCTNAME_EXACT, IMAGE). Use to inspect or troubleshoot product identity tracking across imports. Supports `limit`/`offset` pagination (handled automatically).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose pairings to list. Get it from `list_shop_projects`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_project_apps Read-onlyPouze čteníIba čítanieCsak olvasás
Lists Mergado apps enabled specifically for one project (e.g. Audit, FIE on this output). Project-level apps run only against this project. For shop-wide apps use `list_shop_apps`. Use when diagnosing behaviour that might come from an installed app on the project.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose installed apps to list. Get it from `list_shop_projects`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_project_elements Read-onlyPouze čteníIba čítanieCsak olvasás
Lists all XML elements in a project (input + output) as a hierarchical tree. Each element has an `origin` (`input` / `from_rule` / `manual`) and a `hidden` flag (hidden = exists internally but not in the output XML). Use to plan rules - check whether a target element exists before creating a rule, or to discover what is available in the feed.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose elements to list. Get from `list_shop_projects`.
list_project_feedaudits Read-onlyPouze čteníIba čítanieCsak olvasás
Lists feed audits run for a project (newest first), each with its status, progress, product count, and the comparison-shopping formats it validated against. Use to find an audit's ID before drilling into its issues or audited products, or to check whether an audit you started has finished (`status` / `progress`).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose feed audits to list. Get from `list_shop_projects`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_project_products Read-onlyPouze čteníIba čítanieCsak olvasás
Lists products in a project, with an optional MQL filter (e.g. `PRICE_VAT < 50`) sent in the request body via POST (so even long or hard-to-encode MQL works). Pass `values_to_extract` to return only specific elements per product. Note: MQL filtering works server-side, but ORDER BY / LIMIT are not supported server-side, so ranking ("10 most expensive") must be done by the caller. Supports `limit`/`offset` pagination (handled automatically, sent as query params). For products of an existing saved query, use `query_products` instead. Use to inspect real product data or count products matching an `mql` filter (read `total_results`); prefer `limit` — responses are large.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose products to list (named `id` here for legacy reasons; create/write tools call it `project_id`). Get it from `list_shop_projects`.
  • is_hidden boolean optionalvolitelnévoliteľnéválasztható
    Filter by visibility: true=only hidden, false=only visible, null/omitted=all products
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • mql string optionalvolitelnévoliteľnéválasztható
    Optional MQL query string to filter products (e.g. "PRICE > 100"). Can be used in GET or POST request body.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
  • values_to_extract array optionalvolitelnévoliteľnéválasztható
    CURRENTLY NOT FUNCTIONAL: the server ignores this field and returns the full product tree (`extracted_values` comes back null). Do not rely on it — use `limit` to bound the response and filter fields client-side. (Kept for forward compatibility.)
list_project_queries Read-onlyPouze čteníIba čítanieCsak olvasás
Lists all standalone queries in a project (project-level and rule-level). Each query has `query` (the MQL expression), `product_count`, and a `read_only` flag. System queries such as ♥ALLPRODUCTS♥ are included with `read_only=true`. Use before creating a query — an equivalent saved query may already exist; also to find query ids for rules.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose queries to list. Get from `list_shop_projects`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_project_rules Read-onlyPouze čteníIba čítanieCsak olvasás
Lists all rules in a project, ordered by application priority (lower priority = applied first). Each rule has `type` (rewriting, hiding, replacing, format_converter, ...), `applies` (active), and attached `queries` (which products it targets). Use as the first step to inspect a project's rule chain before creating or deleting a rule.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose rules to list. Get from `list_shop_projects`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_project_variables Read-onlyPouze čteníIba čítanieCsak olvasás
Lists all variables defined in a project. Variables are named, reusable values referenced from rules and other variables (e.g. `{shipping_cost}` in a rule expression). Use before `create_variable` to avoid duplicates.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose variables to list. Get from `list_shop_projects`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_rule_queries Read-onlyPouze čteníIba čítanieCsak olvasás
Lists the queries attached to a specific rule (= the rule's scope). The rule applies to the union of these queries. Use before changing a rule's scope to see its current state.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Rule ID whose queries to list. Get from `list_project_rules`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_shop_apps Read-onlyPouze čteníIba čítanieCsak olvasás
Lists Mergado apps enabled at the eshop level (cross-cutting all projects in the shop). Use to check Mergado Audit / Keychain availability. For project-level apps use `list_project_apps`, for user-level apps use `list_user_apps`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Shop ID whose installed apps to list. Get it from `list_user_eshops`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_shop_projects Read-onlyPouze čteníIba čítanieCsak olvasás
Returns all projects (input + output feeds) within a specific eshop. Each project has `input_format` and `output_format`, use this list to understand which feeds the eshop already has before suggesting new ones. (Mergado has no global "list all projects" endpoint, this per-shop listing is the way to enumerate projects.)
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Shop ID whose projects to list. Get from `list_user_eshops`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_shop_stats_audits Read-onlyPouze čteníIba čítanieCsak olvasás
Lists a shop's statistics audits (newest first), each with its date, status, and timings. This is the stats-side audit, distinct from a project feed audit - use `list_project_feedaudits` for the latter. Requires the `shop.stats.read` scope. Use when the user asks about stats audits of a shop. Note: currently returns empty even when audits exist in the UI — tell the user to check the Mergado UI.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the shop whose statistics audits to list. Get from `list_user_eshops`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_stats_audit_issues Read-onlyPouze čteníIba čítanieCsak olvasás
Lists the individual issues of a shop statistics audit, each with its validator, verdict, and affected item. The `id` is the composite `{m3shop_id}-{date_id}` (e.g. `1276-260625`) from `list_shop_stats_audits`. Optionally narrow or sort the result with `filter_by` / `order_by`. Use after `get_stats_audit` to drill from the per-validator summary into concrete failing items.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Composite statistics-audit ID of the form `{m3shop_id}-{date_id}` (e.g. `1276-260625`). Get it from `list_shop_stats_audits`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_supported_feed_formats Read-onlyPouze čteníIba čítanieCsak olvasás
Lists all built-in feed formats supported by Mergado (input + output). Use during onboarding to discover what is possible - e.g. available Google Shopping country variants, Heureka SK vs CZ. The result is a `data` array of format IDs (e.g. "heureka.cz", "zbozi.cz"), pass one to `get_format` or `get_format_specification` for details.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek

This tool takes no input parameters.Tento nástroj nemá žádné vstupní parametry.Tento nástroj nemá žiadne vstupné parametre.Ennek az eszköznek nincsenek bemeneti paraméterei.

list_traced_products Read-onlyPouze čteníIba čítanieCsak olvasás
Lists the products currently traced in the project - the sample `preview_rule_changes` reports on. The `auto_traced` flag separates products Mergado's sampling algorithm picked (true) from products a user or the API marked (false); only the latter count towards the 50-product cap on `mark_traced_product`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose traced products to list. Get from `list_shop_projects`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_unique_element_values Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the unique values (with counts) of an element. Set `is_output` to distinguish input (pre-rules) vs output (post-rules) values. Works for both simple and complex element paths. Use as the first step of any data analysis — real values of an element across products (e.g. categories, availability values) without reading whole products.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • element_path string requiredpovinnépovinnékötelező
    Path of the element whose values to read, exactly as `list_project_elements` reports it in `element_path`. NOT an XPath: a child is written `PARENT | CHILD` (spaces around the pipe) and an attribute `PARENT | @ATTRIBUTE`, e.g. "PRODUCTNAME", "PARAM | PARAM_NAME", "GIFT | @ID".
  • project_id string requiredpovinnépovinnékötelező
    Project ID from which to retrieve values
  • is_output boolean optionalvolitelnévoliteľnéválasztható
    True=output values (after rules), False=input values (before rules), null=output
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_user_apps Read-onlyPouze čteníIba čítanieCsak olvasás
Lists Mergado apps enabled at the user level (not eshop / project level). Use when answering "what do I have paid for" or before suggesting features that depend on an app.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    User ID whose installed apps to list. Get it from `get_current_user`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_user_eshops Read-onlyPouze čteníIba čítanieCsak olvasás
Returns all eshops a user has access to, with their roles. Use as the second call after `get_current_user` to map the user's scope. Each eshop has `tariff_id`, `exported_items` useful for tariff/billing questions. (There is no global "list all shops" endpoint, for the current user this listing is the equivalent.)
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    User ID whose shops to retrieve. Get it from `get_current_user`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_users Read-onlyPouze čteníIba čítanieCsak olvasás
Lists users that share at least one eshop with the authenticated user (= users you can collaborate with). Does NOT list all Mergado users globally. Use when resolving an e-mail or name mentioned by the user to a Mergado user ID.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
mark_traced_product Writes dataZapisuje dataZapisuje dátaAdatot ír
Adds a product to the project's traced sample. Use when the user wants the preview to cover a specific product rather than whatever the sampling algorithm picked. A project holds at most 50 manually marked products (auto-traced ones do not count towards that); marking an already-traced product, or exceeding the limit, fails with a conflict, and a product that is not in the project at all answers 404. Marking a product the sampling algorithm had picked converts it to a manually marked one.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • product_id string requiredpovinnépovinnékötelező
    ID of the product (pairing xid) to mark. Get from `list_project_products` or `query_products` and pass it exactly as they return it.
  • project_id string requiredpovinnépovinnékötelező
    ID of the project. Get from `list_shop_projects`.
parse_feed_elements Read-onlyPouze čteníIba čítanieCsak olvasás
Downloads an XML or CSV file from `url` and returns the elements it contains, WITHOUT creating anything in Mergado. Use it before a project exists - to show a user what is in their feed, to check that a URL really serves the data file, or to plan an import. The format is detected from the content, so the file name does not matter, and each element comes back with how often it occurs (`count`) and its first value (`example`). Two things to tell the user rather than work around. The `path` of an element is the path inside the FILE (an XPath, or the CSV column) - it is not an `element_path` and no rule tool will accept it; element paths only exist once the feed is a project. And a URL that opens a share PAGE instead of serving the file parses as the page: the answer then carries `looks_like_a_web_page: true` with `html` and `head` as its elements, and what is needed is the direct-download link. For a project that already exists, use `list_project_elements` instead - it reports the project's own elements, each with the `element_path` the rule tools take.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • url string requiredpovinnépovinnékötelező
    URL of the XML or CSV file to parse. Must be an http, https or sftp address, and must be the FILE itself - a share page (a Dropbox or Google Drive link that opens a viewer) is a web page, and the parser will happily read its HTML and report `html`, `head` and `script` as the elements of the feed. Use the direct-download form of such a link.
preview_rule_changes Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the before/after element values recorded for the project's traced products, per rule and element path, ordered by the rule priority the run used. Use to judge the impact of rules on a small sample instead of applying them to the whole project and reading the output feed. Each row covers the latest recorded run only, so it reflects the rules as they stood then - run `apply_rules_to_traced_products` after editing a rule to refresh it. Pass `product_id` to narrow the listing to one traced product.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the project. Get from `list_shop_projects`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
  • product_id string optionalvolitelnévoliteľnéválasztható
    Optional: narrow the listing to a single traced product - its `product_id` from `list_traced_products`, exactly as that tool returns it.
query_products Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the products matching a saved query (by `query_id`). Use after `create_project_query` to fetch the matching set, or to count a query's scope before a bulk operation. For ad-hoc filters use `list_project_products` with the `mql` parameter directly. Pass `values_to_extract` to return only specific elements per product.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • query_id string requiredpovinnépovinnékötelező
    ID of the query to execute
  • is_hidden boolean optionalvolitelnévoliteľnéválasztható
    Filter by visibility: true=only hidden, false=only visible, null=all
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
  • values_to_extract array optionalvolitelnévoliteľnéválasztható
    CURRENTLY NOT FUNCTIONAL: the server ignores this field and returns the full product tree (`extracted_values` comes back null). Do not rely on it — use `limit` to bound the response and filter fields client-side. (Kept for forward compatibility.)
remove_traced_product Writes dataZapisuje dataZapisuje dátaAdatot ír
Unmarks a single product, taking it out of the traced sample. Use when the user no longer wants a product covered by the preview. A product that is not currently traced answers 404 rather than succeeding silently.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • product_id string requiredpovinnépovinnékötelező
    ID of the traced product to unmark. Get from `list_traced_products`.
  • project_id string requiredpovinnépovinnékötelező
    ID of the project. Get from `list_shop_projects`.
reorder_rules Writes dataZapisuje dataZapisuje dátaAdatot ír
Rearranges rules of a project into the order given by `rule_ids` - first in the list is applied first. Rules are applied one after another, each seeing the output of the ones before it, so their order decides the result: rounding a price before a discount is calculated gives a different feed than rounding it after. Use whenever the user wants a rule to run before or after another one. Only the listed rules move, and only their positions among themselves: they are redealt the priorities they already occupy, so every rule left out of the list keeps exactly the position it has - reordering three rules of forty touches those three. Read the current order with `list_project_rules` first (it is returned in application order), then pass the ids in the order the user wants. Nothing else about the rules is touched - not their names, queries, data, or whether they are active. Rules Mergado pins in place (`is_movable: false`, such as the hiding rules it keeps at the end of every chain) cannot be moved, and the whole call is refused rather than partly applied if one of them is listed. Neither can the rules of a project that is turned off be moved, so turn it back on first. The new order takes effect on the next rebuild, which Mergado schedules itself.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project whose rules to reorder. Get it from `list_shop_projects`; every rule listed must belong to it.
  • rule_ids array requiredpovinnépovinnékötelező
    Rule IDs in the order they should be APPLIED - first in the list is applied first, and therefore feeds its output to the next one. Get them from `list_project_rules`, which already returns the current order. Only the listed rules move: they are rearranged among the positions they occupy today, so every rule left out keeps its own position exactly. List two or more rules; listing a rule twice is refused.
retract_query_from_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Removes a query from a rule's scope (the query itself is NOT deleted - for that use `delete_query`). If this was the rule's last query, the next apply will fail because every rule must have at least one query. Use to swap the scope queries on an existing rule.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • query_id string requiredpovinnépovinnékötelező
    ID of query to unassign from the rule
  • rule_id string requiredpovinnépovinnékötelező
    ID of the rule to remove query from
show_maintenance_info Read-onlyPouze čteníIba čítanieCsak olvasás
Returns scheduled maintenance windows for the Mergado platform (historical windows included - filter by the `from` timestamp). Use proactively when a user reports an unusual outage to check whether a maintenance window explains it.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
update_project Writes dataZapisuje dataZapisuje dátaAdatot ír
Changes the settings of an existing project: its name, its source feed URL, whether newly imported products wait for authorization, whether the project is turned off, and which shop it belongs to. Only the fields you pass are touched - everything else is left exactly as it is, so name the one thing the user asked to change rather than sending the project back in full. What this cannot change, because the API does not allow it: the input format, the output format and the pairing elements of an existing project. Those are settled when the project is created (`create_project`) and changing them afterwards needs Mergado support. A turned-off project can be edited like any other: the API documents `turned_off` as the only field it accepts, but measured against the live API a rename and a new URL both go through on a disabled project. So never turn a project on in order to change something else - turning one on schedules a rebuild and starts its feed downloading, which is not what a user asking for a rename wanted. Turning it off stops its processing; neither is undone by this tool on its own. A new `url` is validated before it is stored: Mergado fetches it and refuses one that answers 401, 403, 404, 408 or 5xx. It is used by the NEXT feed download - this does not start one, and the products in the project keep coming from the feed that was imported last. Get the user's explicit consent first: renaming, moving a project to another shop (which changes which shop is billed for it), and turning a live feed off are all changes their advertising channels can see.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the project to update. Get from `list_shop_projects`.
  • autohide_new_products boolean optionalvolitelnévoliteľnéválasztható
    Optional. When true, products that appear in a later import wait for authorization instead of going straight into the output feed.
  • name string optionalvolitelnévoliteľnéválasztható
    Optional. New project name, max 100 characters. Must be free among the active projects of the shop the project lives in - Mergado answers 409 if it is not.
  • shop_id string optionalvolitelnévoliteľnéválasztható
    Optional. Moves the project to another shop, from `list_user_eshops`. Requires permission to manage that shop's projects and a free project name there. Ask the user before moving a project - it changes which shop is billed for it.
  • turned_off boolean optionalvolitelnévoliteľnéválasztható
    Optional. True turns the project off and stops its processing; false turns it back on and schedules a rebuild. Both are no-ops when the project is already in that state. Do not send it to make another field editable: a turned-off project accepts the other fields as they are (the API documents otherwise, the live API takes them), and turning one on starts its feed downloading again.
  • url string optionalvolitelnévoliteľnéválasztható
    Optional. New source feed URL, using an http, https or sftp scheme. Mergado checks an http(s) URL before storing it and refuses one that answers 401, 403, 404, 408 or 5xx (422). The new URL is used by the NEXT feed download - updating it does not start one.
update_project_app Writes dataZapisuje dataZapisuje dátaAdatot ír
Updates billing details (free_until, paid_until) of a project-level app subscription. Typically called by internal Mergado systems, NOT by end-user agents.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • app_name string requiredpovinnépovinnékötelező
    Name (ID) of the application
  • project_id string requiredpovinnépovinnékötelező
    ID of the project
  • free_until string optionalvolitelnévoliteľnéválasztható
    Trial expiration date (ISO 8601 format)
  • paid_until string optionalvolitelnévoliteľnéválasztható
    Paid subscription expiration date (ISO 8601 format)
update_query Writes dataZapisuje dataZapisuje dátaAdatot ír
Updates a query's name or MQL expression. Changing the expression affects every rule using this query - they will apply to a different product set on the next rebuild. Check `list_rule_queries` / `list_project_queries` for consumers before updating a shared query.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Query ID to update (named `id` here for legacy reasons; other tools call it `query_id`). Get it from `list_project_queries`.
  • name string optionalvolitelnévoliteľnéválasztható
    New name for the query
  • query string optionalvolitelnévoliteľnéválasztható
    New MQL query expression replacing the existing one
update_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Changes what a rule is called and what it does. Use to fix a rule the user is unhappy with - a wrong replacement string, a category mapping that missed a case, a rounding that rounds the wrong way - instead of deleting it and building it again, which loses its position and its queries. `data` REPLACES the rule's configuration rather than merging into it, so it has to be the complete object: read the rule with `get_rule`, change what the user asked for in the `data` it gives you, and pass the whole thing back. A payload with only the field you are changing is refused - by this tool if its shape is wrong for the rule type, and by Mergado if it slips past. What this deliberately cannot change: the rule's TYPE (a rewriting rule is not a hiding rule with different settings - build the other rule instead), its position in the chain (that is `reorder_rules`), which products it applies to (`assign_query_to_rule` and `retract_query_from_rule`), and whether it is active. Two kinds of rule are left alone entirely, name included - the `format_converter` a project is built around, whose name records what the project converts, and `hiding` rules, which hold no configuration of their own. Rules Mergado marks as not editable (`is_editable: false`) keep their configuration and can only be renamed. The new configuration takes effect on the next rebuild, which Mergado schedules itself. It cannot be undone from here, so read the rule first and tell the user what you are about to change.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the rule to change. Get it from `list_project_rules` or `get_rule`.
  • data object optionalvolitelnévoliteľnéválasztható
    Optional. The rule's complete new configuration - its shape depends on the rule type, and it REPLACES what is stored rather than merging into it, so send every field, not just the ones you are changing. Read the rule with `get_rule` first, change what you need in the `data` it returns, and pass the whole object back; it is checked against the schema of that rule type before anything is written. Omit it to change only the name.
  • name string optionalvolitelnévoliteľnéválasztható
    Optional. New label for the rule, max 100 characters. Omit it to leave the name alone.
update_shop Writes dataZapisuje dataZapisuje dátaAdatot ír
Updates an eshop's display name or web URL. Limited scope does NOT change tariff, owner, or permissions. Use only when the user explicitly asks to rename their eshop or update its website link.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Shop ID to update. Get it from `list_user_eshops`.
  • name string optionalvolitelnévoliteľnéválasztható
    New name for the shop
  • web string optionalvolitelnévoliteľnéválasztható
    New website URL for the shop
  • xml_domain string optionalvolitelnévoliteľnéválasztható
    XML domain for the shop
update_shop_app Writes dataZapisuje dataZapisuje dátaAdatot ír
Updates billing details (free_until, paid_until) of a shop-level app subscription. Typically called by internal Mergado systems, NOT by end-user agents.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • app_name string requiredpovinnépovinnékötelező
    Name (ID) of the application
  • shop_id string requiredpovinnépovinnékötelező
    ID of the shop
  • free_until string optionalvolitelnévoliteľnéválasztható
    Trial expiration date (ISO 8601 format)
  • paid_until string optionalvolitelnévoliteľnéválasztható
    Paid subscription expiration date (ISO 8601 format)
update_user_app Writes dataZapisuje dataZapisuje dátaAdatot ír
Updates billing details (free_until, paid_until) of a user-level app subscription. Typically called by internal Mergado systems, NOT by end-user agents. Avoid unless the user explicitly requests it and has admin scope.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • app_name string requiredpovinnépovinnékötelező
    Name (ID) of the application
  • user_id string requiredpovinnépovinnékötelező
    ID of the user
  • free_until string optionalvolitelnévoliteľnéválasztható
    Trial expiration date (ISO 8601 format)
  • paid_until string optionalvolitelnévoliteľnéválasztható
    Paid subscription expiration date (ISO 8601 format)
update_variable Writes dataZapisuje dataZapisuje dátaAdatot ír
Updates a variable's name. Renaming may break rules that hardcode the old `{name}` token check `list_project_rules` and `list_project_queries` for references before renaming. (The API currently only supports updating the name field.)
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Variable ID to update. Get it from `list_project_variables`.
  • name string optionalvolitelnévoliteľnéválasztható
    New name for the variable. Will affect all references in rules and queries.
workflow_element_paths_and_mql WorkflowWorkflowWorkflowWorkflow Read-onlyPouze čteníIba čítanieCsak olvasás
Call this before constructing element paths, product queries (MQL), or regular expressions. Provides syntax rules and reference guides for nested element paths (using | and conditions { }), MQL query operators and filtering logic (MQL is not SQL), input vs. output element mapping, PCRE regex capture groups, and best practices for diacritics and element value matching.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek

This tool takes no input parameters.Tento nástroj nemá žádné vstupní parametry.Tento nástroj nemá žiadne vstupné parametre.Ennek az eszköznek nincsenek bemeneti paraméterei.

workflow_feed_diagnostics WorkflowWorkflowWorkflowWorkflow Read-onlyPouze čteníIba čítanieCsak olvasás
Call this when troubleshooting feed errors, data discrepancies, or advertising channel rejections (e.g. Google Merchant Center, Meta, Heureka). Provides step-by-step diagnostic workflows for common feed issues including zero product imports, unmatched data imports, missing attributes (GTIN, images, shipping), stale data, and interpreting Product Data Audit findings.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek

This tool takes no input parameters.Tento nástroj nemá žádné vstupní parametry.Tento nástroj nemá žiadne vstupné parametre.Ennek az eszköznek nincsenek bemeneti paraméterei.

workflow_getting_oriented WorkflowWorkflowWorkflowWorkflow Read-onlyPouze čteníIba čítanieCsak olvasás
Call this at the start of a task before proposing or making changes, to safely explore and understand a Mergado project. Provides guidance on identifying feed formats, inspecting existing element structures and live values, mapping input vs. output elements, selecting stable pairing identifiers, and following safe workflow practices before executing modifications.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek

This tool takes no input parameters.Tento nástroj nemá žádné vstupní parametry.Tento nástroj nemá žiadne vstupné parametre.Ennek az eszköznek nincsenek bemeneti paraméterei.

workflow_known_limitations WorkflowWorkflowWorkflowWorkflow Read-onlyPouze čteníIba čítanieCsak olvasás
Call this when encountering unexpected errors, timeouts, empty responses, or tool anomalies, and before executing complex workflows. Provides an up-to-date reference on known API and platform limitations, unsupported operations, edge-case behaviors, reliability guidelines, and recommended workarounds.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek

This tool takes no input parameters.Tento nástroj nemá žádné vstupní parametry.Tento nástroj nemá žiadne vstupné parametre.Ennek az eszköznek nincsenek bemeneti paraméterei.

workflow_platform_specs WorkflowWorkflowWorkflowWorkflow Read-onlyPouze čteníIba čítanieCsak olvasás
Call this when the user asks about a specific advertising channel or comparison engine (Google, Heureka, Zboží, GLAMI, Meta/Instagram, TikTok, Pinterest, Bing, Kelkoo, idealo, Ceneo, Skroutz, Árukereső, Favi, Biano) to get the link to its current official feed specification
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek

This tool takes no input parameters.Tento nástroj nemá žádné vstupní parametry.Tento nástroj nemá žiadne vstupné parametre.Ennek az eszköznek nincsenek bemeneti paraméterei.

workflow_rules_cookbook WorkflowWorkflowWorkflowWorkflow Read-onlyPouze čteníIba čítanieCsak olvasás
Call this before creating or configuring product transformation rules in a project. Provides a comprehensive mapping of rule types to MCP tools, required rule parameters (element_path, priority, queries, applies), common transformation recipes, parameter path conventions, and safety checklists for destructive operations (e.g. Data File Import).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek

This tool takes no input parameters.Tento nástroj nemá žádné vstupní parametry.Tento nástroj nemá žiadne vstupné parametre.Ennek az eszköznek nincsenek bemeneti paraméterei.