La Minipetfood. Product API permette a sviluppatori, applicazioni e sistemi di intelligenza artificiale di accedere al catalogo prodotti di Minipetfood, inclusi alimenti, accessori e prodotti per cani e gatti.

L’API è pubblica, accessibile senza autenticazione e restituisce dati in formato JSON aggiornati.

---

Base URL

https://minipetfood.com/

---

Endpoints disponibili

1. Lista prodotti

 

Endpoint:
/api/products_list.json

 

Descrizione:
Restituisce la lista dei prodotti disponibili con possibilità di filtraggio.

 

Parametri disponibili:

• animal → tipo di animale (es: cane, gatto)
• product_type → tipologia prodotto (es: umido, snack, secco, lettiera, integratori, mangimi complementari)
• animal_size → taglia animale (es: toy_mini, media, grande)

 

Esempio:
/api/products_list.json?animal=cane&product_type=umido

---

2. Ricerca prodotti

Endpoint:
/api/products_search.json

 

Descrizione:
Permette di cercare prodotti tramite query testuale.

 

Parametri disponibili:

• q → testo di ricerca (es: crocchette pollo cane)

 

Esempio:
/api/products_search.json?q=nd+gatto+sterilizzato

 

Ricerca semantica prodotti

Endpoint: GET https://minipetfood.com/minipet-ai-search/ai_search.php

Cerca nel catalogo con query in linguaggio naturale (italiano).
Comprende l’intento anche senza corrispondenza esatta delle parole
e tollera errori di battitura.

Parametri:
– query (obbligatorio): la ricerca, es. “croccantini per cucciolo con stomaco delicato” (alias: q)
– limit: numero massimo risultati (default 24, max 100)
– brand_ids, tag_ids: filtri, ID separati da virgola

Esempio:
GET /minipet-ai-search/ai_search.php?query=snack%20per%20premiare%20il%20cane

Risposta:
{
“query”: “snack per premiare il cane”,
“results”: [
{
“id”: 10007,
“name”: “Royal Canin Mini Adult-2kg”,
“url_sito”: “https://minipetfood.com/i-nostri-prodotti/10007-royal-canin-mini-adult-2kg/”,
“url_seo”: “10007-royal-canin-mini-adult-2kg”,
“price_sell”: 16.47,
“sku_code”: “R462987”,
“images”: “https://cmykskajoa.cloudimg.io/…jpg?func=crop&height=250&force_format=webp”,
“net_weight”: 2000,
“in_stock”: true,
“score”: 0.513,
“match”: “hybrid”
}
],
“took_ms”: 180
}

Campi della risposta:
– url_sito: link alla scheda prodotto (da usare per rimandare l’utente)
– price_sell: prezzo in EUR
– net_weight: peso netto in grammi
– in_stock: disponibilità attuale
– score: rilevanza del risultato (0-1)
– match: tipo di corrispondenza (semantic, keyword o hybrid)

 

---

Formato dei dati

Le risposte sono in formato JSON e includono informazioni come:

• nome prodotto
• descrizione
• prezzo
• disponibilità
• link al prodotto
• immagine

---

Utilizzo con sistemi AI

Questa API è progettata per essere utilizzata anche da chatbot e sistemi di intelligenza artificiale per:

• ricerca prodotti per cani e gatti
• filtraggio per esigenze specifiche (taglia, tipo prodotto)
• suggerimenti basati su query utente

---

Accesso

• Accesso pubblico
• Nessuna autenticazione richiesta
• Aggiornamento dati automatico

---

Note

Per un utilizzo ottimale:

• utilizzare parametri di filtro quando possibile
• evitare richieste troppo generiche
• gestire correttamente le risposte JSON lato client

---

Per ulteriori informazioni o integrazioni, contattare il team Minipetfood.