API de contenido

Una API que ofrece contenido que nuestro equipo editorial crea junto con la IA y verifica según sus criterios, en formatos JSON, Markdown, TXT, HTML y JSON-LD, y en varios idiomas. La misma clave cubre además la búsqueda semántica, los metadatos de audio (TTS) y los conjuntos de datos para entrenamiento de modelos e indexación RAG (corpus de texto, pares instruction, paralelo multilingüe), mientras que los vectores de embedding originales y los archivos mp3 se ofrecen con el plan Pro. Obtenga una clave gratuita y empiece de inmediato.

Planes

Prueba de la API

Uso

Llame a la API con su clave en la cabecera Authorization. A continuación están los endpoints, parámetros, formatos de respuesta y ejemplos.

Endpoints

Conjuntos de datos (entrenamiento y RAG)

Para usos que necesitan muchos registros a la vez - entrenamiento de modelos, fine-tuning, indexación RAG - el contenido se normaliza en esquemas listos para entrenar. page, per_page, category, tag y updated_since funcionan igual que en las API de listado y de un solo elemento, y con format=jsonl entra directo en una pipeline de entrenamiento.

El tope de per_page es 10 en el plan Free y hasta 100 por tipo en Pro (20 para embeddings). Los créditos se calculan sobre el per_page solicitado, así que una llamada masiva cuesta menos que pedir el mismo volumen de uno en uno.

La API de conjuntos de datos no sustituye a los archivos de datos gratuitos. Las rutas sin autenticación que sirven artículos individuales en TXT, Markdown, JSON y JSON-LD siguen siendo gratuitas tal como están hoy. Guía de acceso a datos gratuitos

Idiomas disponibles

• Nivel 1 - Idiomas cuya traducción ya está revisada. Se ofrece todo: páginas web legibles por personas, exposición en buscadores (sitemap y hreflang), audio con IA (TTS) y embeddings.
• Nivel 2 - Idiomas de solo datos con traducción automática. Se sirven únicamente por archivos de datos y la API: sin páginas web, sin exposición en buscadores, sin audio (TTS) y sin embeddings. Cada archivo lleva la etiqueta translation_status: machine para indicar que no ha sido revisado.

Pase estos valores directamente como parámetro lang de la API. Los endpoints de contenido individual y de conjuntos de datos aceptan idiomas de nivel 2, mientras que los de audio (TTS) y embeddings solo responden para idiomas de nivel 1.

Parámetros de consulta

Formatos admitidos (format de contenido individual)

Ejemplos

Autentíquese con la cabecera Authorization: Bearer o la cabecera X-Api-Key.

# Lista
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents?lang=ko&page=1&per_page=20"

# Filtrar por categoría
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents?lang=ko&category=<CATEGORY_SLUG>"

# Filtrar por etiqueta
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents?lang=ko&tag=<TAG_SLUG>"

# Sincronización incremental (modificado desde una fecha)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents?updated_since=2026-01-01T00:00:00Z"

# Solo un servicio (opcional; omítalo para todo)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents?lang=ko&service=<SERVICE>"

# Contenido individual (formato HTML)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents/<CONTENT_ID>?lang=ko&format=html"

# Buscar por slug (formato Markdown)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents/by-slug/<SLUG>?lang=ko&format=md"

# Metadatos de imágenes
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents/<CONTENT_ID>/images"

# Lista de categorías
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/categories?lang=ko"

# Lista de etiquetas
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/tags?lang=ko"

# Lista de binders
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/binders?lang=ko"

# Contenido de un binder
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/binders/<BINDER_SLUG>/contents?lang=ko"

# Lista de sitios
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/sites?lang=ko"

# Contenido de un sitio
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/sites/<SITE_SLUG>/contents?lang=ko"

# Buscar
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/search?q=<KEYWORD>&lang=ko"

# Búsqueda semántica (significado vectorial)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/search?q=<KEYWORD>&mode=semantic&lang=ko"

# Vectores de embedding (Pro)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents/<CONTENT_ID>/embeddings?lang=ko"

# Metadatos de audio TTS
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents/<CONTENT_ID>/audio?lang=ko"

# Audio TTS mp3 (Pro)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents/<CONTENT_ID>/audio/ko"

# Catálogo de conjuntos de datos
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/datasets"

# Corpus de texto (varios registros de una vez)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/datasets/corpus?lang=ko&per_page=100"

# Corpus de texto en JSONL (para pipelines de entrenamiento)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/datasets/corpus?lang=ko&format=jsonl"

# Sincronización incremental (solo lo modificado desde una fecha)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/datasets/corpus?updated_since=2026-01-01T00:00:00Z&format=jsonl"

# Conjunto instruction (FAQ a pares de mensajes)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/datasets/qa?lang=ko&format=jsonl"

# Corpus paralelo multilingüe (solo revisadas)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/datasets/parallel?langs=ko,en,ja&status=reviewed"

# Vectores de embedding en bloque (Pro)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/datasets/embeddings?lang=ko&per_page=20"

Opcional: en lugar de cabeceras puede usar un token de consulta (autenticación por URL). Añada la QUERY_KEY emitida en la página "Mi API de contenido" para llamar sin cabeceras. Puede quedar expuesta en URLs/registros, por lo que es de solo lectura, caduca y es revocable: recomendado solo para uso cómodo no sensible.

https://onbinder.com/api/v1/contents?query_key=<QUERY_KEY>&lang=ko

Solo las respuestas exitosas (2xx) cuentan para la cuota mensual; el restante se informa en las cabeceras X-Monthly-Quota-*. La cuota se reinicia el día 1 de cada mes (KST).

Las solicitudes de búsqueda semántica, embeddings, audio y conjuntos de datos usan créditos adicionales: búsqueda semántica (mode=semantic) 2x, vectores de embedding 5x, archivo mp3 de audio TTS 3x (metadatos 1x). Los conjuntos de datos escalan con el per_page solicitado (1 por cada 10 registros en corpus y QA, 1 por cada 5 en paralelo, 1 por cada 2 en embeddings). Los vectores, los archivos mp3 y el conjunto de embeddings son solo para el plan Pro, y cada función solo opera si el administrador ha activado la API correspondiente (embeddings/audio/conjuntos de datos).

El uso de la API está sujeto a: Términos · Reembolsos · Privacidad