Guía de API
Usa los datos y las herramientas de IA de Nexscope en tu aplicación.
Una API permite que tu aplicación solicite a Nexscope datos de productos, investigación de palabras clave o contenido de IA. Tu desarrollador puede conectarla una vez para que no tengas que copiar los resultados a mano.
¿Quieres que tu asistente de IA use Nexscope? Abrir la guía MCP →
Elige lo que quieres hacer
Por ejemplo: busca productos de Amazon o lee reseñas de clientes. Elige una herramienta y comprueba qué producto, palabra clave o mercado necesita.
Buscar una herramienta →Ejemplo: API de búsqueda de Amazon (en inglés). Puedes elegir otra herramienta para tu tarea.
Obtén una clave de API
Esta es la clave de acceso de tu aplicación a Nexscope. Inicia sesión para crear una y guárdala en los ajustes privados de tu aplicación. Trátala como una contraseña.
Prueba una tarea
Pide a tu desarrollador que conecte la herramienta y la pruebe con tus entradas. Empieza con una tarea pequeña y comprueba su coste en créditos antes de ejecutarla.
Para desarrolladores: ejemplo de solicitud
Sustituye YOUR_API_KEY y las entradas de ejemplo. Guarda la clave en tu servidor, fuera del código del navegador y de los repositorios públicos.
Sustituye YOUR_API_KEY y ejecuta este comando en tu terminal.
curl -X POST 'https://api.nexscope.ai/amazon/search' \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amazonDomain": "amazon.com",
"keyword": "wireless earbuds",
"page": 1
}'Comprueba el resultado
Comprueba que el resultado coincida con el producto, la palabra clave o el contenido que solicitaste. Para tareas de imagen y vídeo, consulta la tarea existente antes de iniciarla de nuevo.
Ver los detalles de la herramienta de ejemplo → (en inglés)Para desarrolladores: leer la respuesta
Los resultados usan JSON. Comprueba tanto el estado HTTP como el estado de negocio de la API; HTTP 200 por sí solo no significa que la tarea haya tenido éxito. Para tareas de imagen y vídeo, usa el ID de tarea devuelto para obtener el resultado final.
Para solicitudes de ejecución y de resultado de tarea, envía X-Nexscope-Http-Status: semantic para asignar estados de error HTTP a los errores de negocio gestionados por el controlador manteniendo la misma estructura JSON. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de la asignación del controlador. Las llamadas v1 existentes sin esta cabecera conservan su comportamiento actual. Comprueba code en ambos modos; la aceptación asíncrona no implica finalización.
El campo cost indica los milisegundos transcurridos, no los créditos cobrados. La ejecución de Data API cuesta al menos 10 créditos, incluido el directorio Amazon Product Research.
{
"data": {
"products": []
}
}¿Algo no funciona?
Comprueba tu clave de API, las entradas obligatorias y los créditos disponibles. Si necesitas ayuda de tu desarrollador, comparte el nombre de la herramienta y el mensaje de error, no tu clave.
Para desarrolladores: códigos de error
| Código | Significado |
|---|---|
| 200 | Respuesta HTTP predeterminada para el éxito y muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data.status para comprobar la finalización de la tarea. |
| 429 | Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente. |
| 503 | La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente. |
| Opcional | X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo. |
| Otros | Las solicitudes malformadas y los fallos de infraestructura pueden devolver respuestas HTTP distintas de 200. |
¿Cuánto cuesta?
Los costes dependen de la herramienta y la tarea. Comprueba el precio antes de ejecutarla.
Ver precios →Para desarrolladores: API de saldo y uso
Casos de uso de la guía de inicio rápido de la API
Enviar una primera solicitud
Un desarrollador sigue la guía para crear una clave de API y enviar una primera solicitud desde el servidor. Los ejemplos de solicitud y respuesta muestran cómo examinar el JSON devuelto antes de crear una integración.
Preparar la integración de una aplicación
El equipo de una aplicación lee los esquemas publicados y las instrucciones de autenticación antes de implementar una conexión. El equipo utiliza la guía para identificar los campos obligatorios de la solicitud y una referencia de API adecuada.
Compartir una lista de comprobación de integración
Un responsable técnico comparte la guía con los desarrolladores que se incorporan a un proyecto de integración. El equipo puede seguir las mismas comprobaciones de autenticación y respuesta mientras elige las API individuales para su flujo de trabajo.
Preguntas frecuentes sobre la guía de inicio rápido de la API
¿Cómo empiezo a utilizar la API de Nexscope?
Crea una clave de API, elige una API del directorio y envía la solicitud documentada desde tu servidor. La guía proporciona instrucciones de autenticación y ejemplos JSON para revisar el resultado. Antes de integrarla en tu aplicación, abre la referencia de cada API para consultar sus entradas obligatorias, los campos de respuesta y su coste actual en créditos.
¿Dónde puedo encontrar ejemplos de solicitudes y respuestas?
Las secciones de integración de la API y de parámetros y respuesta de cada referencia de API contienen los ejemplos y esquemas publicados. Utiliza la guía para comprender las comprobaciones comunes de autenticación y respuesta y, después, lee la referencia de la operación que hayas elegido. Los ejemplos de la guía son ilustrativos y no representan un resultado real de tu cuenta.
¿Puedo conectarme a Nexscope mediante un cliente MCP?
Nexscope también ofrece una guía de MCP para conectar clientes de IA compatibles. Sigue sus instrucciones de configuración y consulta la referencia de la herramienta seleccionada para conocer las entradas admitidas. Cada API puede tener capacidades y costes en créditos diferentes, por lo que debes revisar su documentación antes de realizar llamadas. Mantén en privado tus credenciales de API cuando compartas un ejemplo de integración.
API relacionadas
Busca productos de TikTok con filtros de mercado, tipo de vendedor, envío, precio y ventas. Consulta los parámetros de la solicitud…
Obtén resultados de búsqueda en tiempo real de las tiendas de Amazon y posiciones de palabras clave. Revisa los parámetros de la solicitud y los campos de respuesta…