DocumentaciónReferencia de la API

Competidores

Los competidores de un sitio, su análisis y sus enlaces entrantes.

Cada operación de esta página es también una herramienta MCP, con el mismo nombre. Las marcadas Gratis no cuestan nada; las marcadas De pago usan los créditos del espacio, como en la aplicación (Cuánto cuesta).

OperaciónLlamada
Listar los competidoresGET /sites/{siteId}/competitorsGratis
Añadir un competidorPOST /sites/{siteId}/competitorsGratis
Eliminar un competidorDELETE /sites/{siteId}/competitors/{competitorId}Gratis
Analizar un competidorPOST /sites/{siteId}/competitors/{competitorId}/profileDe pago
Obtener los enlaces entrantes de un competidorGET /sites/{siteId}/competitors/{competitorId}/backlinksDe pago

Listar los competidores

GET/sites/{siteId}/competitorsGratis

Los competidores del sitio, con su perfil una vez analizados.

Herramienta MCP list_competitors

ArgumentoTipoDescripción
siteIden la rutastringSu id.
Petición
curl https://app.semchat.io/api/v1/sites/{siteId}/competitors \
  -H "Authorization: Bearer sk_live_…"
Respuesta · 200
{
  "data": [
    {
      "id": "01a15ea4-c1e0-7285-bdde-d36e70d2d1b9",
      "url": "https://comp1.example.com",
      "name": "Concurrent Un",
      "source": "auto",
      "profiled_at": "2026-10-21T13:26:58.000Z",
      "metrics": {
        "traffic": 5200,
        "keywords": 400,
        "overlap": 40,
        "reason": "Mêmes mots-clés à Lyon."
      },
      "profile": {
        "summary": "Concurrent Un accompagne les PME.",
        "positioning": "Agence généraliste.",
        "topics": [
          "SEO",
          "SEA"
        ],
        "strengths": [
          "Notoriété"
        ],
        "tech": [
          "wordpress"
        ],
        "pageCount": 24
      }
    },
    {
      "id": "01a15ea4-c1e0-7042-931d-3fa2cb1f4ffc",
      "url": "https://comp2.example.com",
      "name": "Concurrent Deux",
      "source": "auto",
      "profiled_at": "2026-10-21T13:26:58.000Z",
      "metrics": {
        "traffic": 4200,
        "keywords": 350,
        "overlap": 30,
        "reason": "Mêmes mots-clés à Lyon."
      },
      "profile": {
        "summary": "Concurrent Deux accompagne les PME.",
        "positioning": "Agence généraliste.",
        "topics": [
          "SEO",
          "SEA"
        ],
        "strengths": [
          "Notoriété"
        ],
        "tech": [
          "wordpress"
        ],
        "pageCount": 24
      }
    }
  ]
}

Añadir un competidor

POST/sites/{siteId}/competitorsGratis

Añade un competidor y, si quieres, analiza su perfil (de pago).

  • Responde con su id y analyzing: false cuando no se lanzó ningún análisis (no se pidió, o no hay créditos; el competidor se guarda igualmente).

Herramienta MCP add_competitor

ArgumentoTipoDescripción
siteIden la rutastringSu id.
urlobligatoriostringLa dirección del competidor.1–500 caracteres
nameopcionalstringhasta 255 caracteres
auto_analyzeopcionalbooleanAnaliza su perfil en segundo plano (de pago). Se omite sin créditos.
Petición
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/competitors \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Responde 201 con { "data": … }.

Eliminar un competidor

DELETE/sites/{siteId}/competitors/{competitorId}Gratis

Quita un competidor de los del sitio.

Herramienta MCP delete_competitor

ArgumentoTipoDescripción
siteIden la rutastringSu id.
competitorIden la rutastringSu id.
Petición
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/competitors/{competitorId} \
  -H "Authorization: Bearer sk_live_…"

Responde 204 con { "data": … }.

Analizar un competidor

POST/sites/{siteId}/competitors/{competitorId}/profileDe pago

Analiza un competidor (un rastreo superficial de su sitio y un resumen hecho por IA: qué hace, su posicionamiento, sus temas, sus puntos fuertes y lo que le falta frente a tu sitio) y lo guarda en el competidor.

  • Se factura como el mismo análisis en la aplicación (una llamada a la IA). 402 INSUFFICIENT_TOKENS sin créditos.
  • Sin background, espera al perfil (hasta unos minutos) y responde con el competidor y su perfil.

Herramienta MCP profile_competitor

ArgumentoTipoDescripción
siteIden la rutastringSu id.
competitorIden la rutastringSu id.
backgroundopcionalbooleanResponde al momento (202, status analyzing) y guarda el perfil cuando llega: léelo con list_competitors.
localeopcionalstringEl idioma en que se escribe el perfil (fr, en, es, de, pt, it). Por defecto: el del creador de la clave.2–5 caracteres
Petición
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/competitors/{competitorId}/profile \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"background": true}'

Responde 200 con { "data": … }.

¿No encuentras la respuesta? Escríbenos.

¿Listo para impulsar tu web?

Haz tu primera pregunta - semchat te responde con un plan de acción claro en segundos.

Gratis · sin registro · en 5 segundos