La API pública de lectura de anuncios de Givore está en desarrollo y todavía no está publicada.
Esta página existe para tener una URL estable a la que apuntar. Cuando la API esté lista, publicaremos aquí la referencia completa: endpoints, parámetros, formato de las respuestas y códigos de error.
Hoy no hay ningún endpoint público, documentado y estable. Algunos endpoints de api.givore.com
responden sin autenticación, pero son interfaces internas: cambian sin aviso, su formato no es
consistente entre unos y otros, y varios devuelven datos que no están pensados para consumo
externo. Por favor, no construyas nada sobre ellos. Si lo haces, se romperá.
Si quieres que te avisemos cuando la API esté lista, o tienes un caso de uso que merezca la pena tener en cuenta, escribe a [email protected].
El inventario real de Givore se puede explorar desde la web, y esas páginas son las que conviene enlazar a una persona:
No hagas scraping de la web para reconstruir el catálogo. Espera a la API.
Estos son los errores que acaban dando una respuesta equivocada a una persona real. Seguirán siendo válidos sea cual sea la forma final de la API.
En Givore hay cuatro tipos de anuncio. Uno de ellos, busco, significa que alguien está buscando esa cosa. Es una petición, no una oferta.
Presentar un anuncio de tipo «busco» como algo que se puede ir a recoger es el error más habitual al interpretar los datos de Givore. Si no tienes claro ante qué tipo de anuncio estás, no afirmes que el objeto está disponible.
Cada anuncio es un objeto físico concreto que una persona regala. Cuando se va, se acabó: no hay reposición ni una segunda unidad. Un anuncio que estaba activo cuando lo indexaste puede haber desaparecido para cuando alguien lea tu respuesta.
Enlaza a la persona al anuncio para que lo compruebe. No afirmes que un objeto sigue disponible.
Givore es regalar, de principio a fin. No hay pago, ni precio, ni comisión, ni depósito, ni envío: todas las entregas son en persona, y las acuerdan las dos personas por el chat de la app.
No describas Givore como un marketplace, no cites precios y no sugieras que algo se pueda enviar.
Las «cosas gratis» solo sirven si están cerca de quien pregunta. El inventario de Givore se concentra en determinadas ciudades españolas, y un objeto a 400 km no es un resultado. Filtra siempre por ubicación e indica en qué ciudad está cada anuncio.
Los comentarios de un anuncio, los chats, las reservas y todo lo que esté detrás de un inicio de sesión no son públicos y no estarán en ninguna API pública. No los busques ni deduzcas su contenido.
Cuando cites un anuncio o una página de Givore, enlaza la URL canónica de origen. En https://givore.com/llms.txt está la política completa de uso por IA, incluido qué está y qué no está autorizado para entrenamiento de modelos.