Shopify Catalog API returnează acum și video și modele 3D în array-ul media al produselor și permite filtrarea rezultatelor din search_catalog după tipul de media: image, video sau model_3d. Filtrul e opțional, iar interogările existente returnează aceleași produse. Pentru asset-uri video sau 3D e nevoie de versiunea draft a extensiei globale de catalog.

Ce s-a schimbat, pe scurt

Anunțul din changelogul Shopify, publicat pe 16.09.2026 (sursa), descrie o modificare tehnică aparent mică, dar cu impact real pentru cine construiește experiențe de cumpărare. Trei endpoint-uri, respectiv search_catalog, get_product și lookup_catalog, returnează acum în array-ul media și asset-uri video și modele 3D. Înainte, acel array conținea doar imagini.

În plus, search_catalog acceptă un filtru nou, catalog.filters.media, cu valori de tip image, video sau model_3d. Intrările se combină cu AND, deci dacă ceri video și model_3d primești doar produsele care au ambele. Un tip nerecunoscut nu strică requestul: API-ul îl ignoră și îl raportează în result.messages[] cu codul not_found. Produsele care corespund vin cu URL-uri de asset, astfel încât clientul poate randa produsul fără un al doilea request.

Există și o condiție tehnică importantă. Tipurile noi de media cer versiunea draft a extensiei globale de catalog, dev.shopify.catalog.global, declarată în profilul de agent. Fără ea, câmpul media întoarce doar imagini. Există și o capcană de interpretare: dacă filtrezi pe versiunea stable a extensiei, filtrul este onorat, dar răspunsul conține doar imagini. Draft-ul urmează să treacă în stable la următoarea versiune UCP.

De ce contează filtrul de media pentru echipele de ecommerce

Logica din spate e simplă și o recunosc orice operator care a construit un flux de date pe catalog. Înainte, ca să găsești produse cu media utilizabilă, trebuia să ceri produse, să inspectezi fiecare rezultat și să arunci ce nu avea asset-uri potrivite. Un ciclu de fetch, inspect, discard care consumă timp de dezvoltare și requesturi.

Filtrul mută decizia în momentul interogării. Ceri direct produse care au video sau model 3D și primești doar ce e utilizabil. Pentru scenarii de tip probă virtuală, viewer 3D sau shopping cu camera, un produs fără asset randabil pur și simplu nu poate fi folosit, indiferent cât de bună e oferta. Aici filtrul economisește un pas real, nu unul teoretic.

Al doilea câștig e legat de round trip. Când asset-urile vin în același răspuns, clientul nu mai face un request separat pentru media fiecărui produs. La scară, asta contează pentru latență. Dar aici trebuie să fim onești cu limitele: sursa nu oferă cifre despre cât economisești și nu promite nimic despre conversie. Orice procent ar fi inventat.

Un detaliu care merită subliniat: filtrul se aplică doar pe search_catalog. URL-urile de asset se întorc și pe get_product și lookup_catalog, chiar dacă nu filtrezi. Deci poți profita de asset-uri fără să schimbi nimic în fluxul de căutare. Și nu există endpoint nou, nu există migrare, iar query-urile existente returnează aceleași produse. Pentru majoritatea echipelor, schimbarea e opt-in.

Ce înseamnă pentru tine, ca antreprenor sau marketer român

Dacă ai un magazin pe Shopify și lucrezi cu o echipă de dezvoltare sau cu un partener tehnic, întrebarea practică nu e dacă API-ul e frumos, ci dacă merită să investești în conținut video și 3D. Iar răspunsul cinstit e: depinde de categorie.

La mobilă, decorațiuni, pantofi, ochelari, electronice, un model 3D sau un video scurt pot reduce incertitudinea cumpărătorului mai bine decât cinci fotografii. Dacă vinzi produse unde dimensiunea, textura sau proporția contează, asset-urile randabile sunt un avantaj de conversie, chiar dacă nu avem un studiu propriu care să confirme un procent pentru tine.

La produse simple, tipice pentru multe magazine românești, un consumabil sau un accesoriu ieftin, investiția în 3D poate să nu se justifice. Aici filtrul de media nu-ți schimbă businessul, dar îți schimbă arhitectura tehnică dacă ai un canal de tip agent sau aplicație care citește catalogul.

Un al doilea aspect, mai puțin evident, e legat de vizibilitatea în canalele AI. Dacă tot mai mulți cumpărători ajung la tine prin interfețe care citesc catalogul programatic, calitatea și tipul media din catalog devin semnale pentru ce poate fi afișat mai departe. Am scris despre cum se leagă asta de Google agentic commerce: ce schimbă pentru retaileri în 2026, iar direcția e aceeași: cu cât datele tale structurate sunt mai bogate, cu atât ai mai multe șanse să fii ales de un canal automat.

Aici e și legătura cu partea de citare de către LLM-uri. Un produs cu media bogată, descrieri clare și structură corectă are mai multe șanse să fie înțeles și recomandat de un sistem AI decât unul cu o singură poză și un titlu ambiguu. Despre ce semnale contează cu adevărat am scris în AI Search și SEO: 4 semnale care ghidează decizii reale, iar principiul rămâne valabil și aici: sistemele citesc ce există, nu ce ai vrea să existe.

Ce verifici înainte să te apuci de implementare

Primul pas nu e să scrii cod, ci să afli pe ce versiune a extensiei rulezi. Dacă profilul tău de agent e pe stable, vei filtra fără efect vizibil pe media: primești doar imagini. Trebuie să declari draft-ul, dev.shopify.catalog.global, ceea ce conform sursei e o schimbare de o linie în profilul de agent. Confirmă în documentația oficială sau cu echipa tehnică înainte să promiți un termen.

Al doilea pas: măsoară câte produse au deja video sau model 3D atașat. Filtrul e util doar dacă ai pe ce să filtrezi. Dacă doar 2% din catalog are 3D, un filtru de 3D va returna un set mic și poate crea impresia că ceva e stricat, când de fapt n-ai conținut.

Al treilea pas, și cel mai important, e tratarea formatelor. Sursa menționează explicit că intrările video și 3D au un array de tip sources cu o intrare per format de fișier. Adică produsul poate să aibă video, dar nu neapărat în formatul de care ai nevoie. Aici e capcana reală: prezența unui asset nu garantează compatibilitatea cu clientul tău. Testează exact cazul în care media lipsă de formatul cerut duce la un player gol pe pagina de produs.

Al patrulea pas: verifică ce se întoarce în result.messages[] când ceri un tip inexistent sau scris greșit. Codul not_found e raportat, nu aruncă eroare, deci dacă nu citești mesajele, riști să crezi că filtrul a funcționat când, de fapt, a ignorat o valoare.

Ipoteze și recomandări, spuse pe șleau

Ce știm sigur din sursă: ce endpoint-uri returnează ce, ce filtru există, cum se combină intrările, ce se întâmplă cu un tip necunoscut și ce condiție de versiune e necesară.

Ce e ipoteză sau recomandare din partea noastră, nu fapt din sursă: că video și 3D pot îmbunătăți experiența de cumpărare în anumite categorii, că filtrarea reduce efort de dezvoltare, că răspunsul unic economisește round trip-uri. Sunt deducții rezonabile, dar nu cifre dovedite pentru contul tău.

Ce NU știm și nu trebuie afirmat: nu avem date despre impact asupra CPA, vânzărilor sau conversiei, nu știm cât durează până când draft-ul devine stable în afara indicației că se întâmplă la următoarea versiune UCP și nu știm cât de amplă e acoperirea de media 3D în cataloagele reale. O verificare incompletă, făcută pe câteva produse, nu dovedește că o funcție lipsește sau că filtrul e defect. Dacă rezultatele par neconcludente, cauza cea mai probabilă e profilul de versiune sau conținutul insuficient, nu API-ul.

Recomandarea practică: tratează asta ca pe o iterație tehnică mică, nu ca pe un proiect. Un test izolat pe un set de produse cu media bogată, cu logare a răspunsurilor și a mesajelor, îți spune în câteva ore mai mult decât o discuție de strategie.

Întrebări frecvente

Ce returnează noul filtru catalog.filters.media? Permite cererile din search_catalog să întoarcă doar produse care au anumit tip de media: image, video sau model_3d. Intrările se combină cu AND, deci ceri video și model_3d și primești doar produsele care au ambele. Filtrul e opțional.

Ce se întâmplă dacă trimit un tip de media care nu există? Requestul nu pică. API-ul ignoră valoarea nerecunoscută și o raportează în result.messages[] cu codul not_found. Verifică aceste mesaje dacă rezultatele par neașteptate.

De ce primesc doar imagini, deși am adăugat filtrul? Cel mai probabil profilul de agent rulează pe versiunea stable a extensiei dev.shopify.catalog.global. Pentru asset-uri video și 3D e nevoie de draft. Pe stable, filtrul e onorat, dar răspunsul conține doar imagini.

Concluzia ALLSoft Agency

Un API mai bun nu vinde singur. Filtrul de media, răspunsul cu asset-uri în același request, absența migrării, toate astea sunt infrastructură. Valoarea apare când cineva decide ce categorii merită 3D, cum testezi formatul, ce faci cu produsele care nu au media potrivită și cum măsori dacă merită efortul.

AI-ul ajută la analiză, la sortarea catalogului, la generarea de ipoteze și la construirea de rapoarte. Dar decizia și execuția rămân umane: media buyer-ul, echipa de ecommerce și dezvoltatorul care înțelege clientul. Iar pasul concret, de la „am citit că Shopify a schimbat ceva” la „am testat pe catalogul meu și știu la ce să mă aștept”, îl face ALLSoft Agency. Fără hype, cu datele pe masă.