API de SEOHabit
Guía de API para agentes
Use la API para auditar su sitio web, preparar mejoras para revisión, seguir envíos automáticos autorizados o verificar si una página externa enlaza a un destino. Estas operaciones no garantizan aceptación por parte de directorios, publicación, indexación o resultados de SEO.
URL base y formato de solicitud
Las solicitudes utilizan https://seohabit.com/api/v1. Envía cuerpos JSON con Content-Type: application/json. Los proyectos de sitios web y el progreso de los envíos automáticos requieren autenticación. Las solicitudes tienen límites de frecuencia.
Seguir envíos de terceros
Crea un proyecto con detalles de directorio autorizados para habilitar el envío automático a proveedores elegibles. Se realizan como máximo dos intentos por día UTC, deteniéndose tras cinco directorios reconocidos. SEOHabit selecciona directorios elegibles en segundo plano; los usuarios no navegan ni seleccionan una lista de directorios. Si no hay proveedor elegible disponible, el proyecto espera. Un reconocimiento no implica publicación ni un enlace de verificación.
Consultar estado de la tarea
Poll the status URL hasta que el trabajo alcance completed o failed. Autentique cada consulta con el token del trabajo en el encabezado. Un token de trabajo otorga acceso solo al propio trabajo.
curl 'https://seohabit.com/api/v1/jobs/job_example' \
-H 'X-Access-Token: YOUR_JOB_ACCESS_TOKEN'Las respuestas incluyen queued, running, completed, o failed; result es nulo hasta que esté disponible.
Cuentas, claves de proyecto y acciones pagadas
La registración y el inicio de sesión establecen un cookie HttpOnly sh_session. Los escritos de cookies del navegador se verifican por origen. Para integraciones, una cuenta autenticada puede crear una clave de API con alcance específico y enviarla como Authorization: Bearer shk_…. Las claves no pueden acceder a otro proyecto, y los alcances de clave limitan las operaciones disponibles. Mantén secretas las cookies de sesión y las claves de API; nunca las incluyas en URLs.
Las tareas de palabras clave aceptan details.keyword, opcional details.language (predeterminado en) y un details.pageUrl explícito opcional. Las sugerencias exponen evidencia de página coincidente y marcan lenguaje desconocido o demanda de búsqueda no confirmada.
Los auditorías de sitios web pueden programarse en un proyecto gratuito dentro del límite gratuito. Los enlaces de seguimiento, creación de tareas y ejecución de tareas requieren un sitio web verificado y una suscripción activa. Una acción pagada requiere que una persona establezca la propiedad y obtenga explícitamente la suscripción a través del flujo de facturación de la cuenta. No inicies el proceso de pago, suscripción ni autorices cambios por otro. La ejecución de tareas no es evidencia de que se aplicó un cambio; una tarea lista requiere revisión y aceptación del usuario.
Las claves de proyecto soportan project:read, project:write, checks:write y tasks:write. Una clave solo aplica a su propio proyecto. Consulte la Documento OpenAPI para rutas y formas de solicitud.
Errores y uso seguro
Los errores usan JSON con error y message. Respuestas comunes incluyen 400 para entrada inválida o URLs no seguras, 401 para falta de autenticación de cuenta, 403 para origen no permitido o alcance, 404 para recursos no disponibles, 409 para conflictos, 429 para límites de velocidad, y 402 cuando una acción pagada requiere una suscripción activa.
Solo revisa páginas públicas a las que estés autorizado para inspeccionar. El servicio bloquea destinos privados y de red local y sigue la política del crawler del sitio fuente cuando esté disponible. Utiliza claves de idempotencia para solicitudes POST reintentables y maneja respuestas de límite de velocidad con retraso.