API de Proyectos

En Rankion un proyecto es el contenedor central — un dominio por proyecto, un team owner y todos los sub-recursos (artículos, keywords, mapas de internal-link, storylines) cuelgan de él. Aparte existen los Tracking Projects como recurso propio para la monitorización de AI Visibility (ver más abajo).

CRUD

# Lista
curl -H "Authorization: Bearer $TOKEN" "$BASE/projects"

# Crear
curl -X POST "$BASE/projects" \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"name":"Mein Blog","domain":"meinblog.de","language":"de","country":"DE"}'

Response (recortada):

{
  "data": {
    "id": 12,
    "name": "Mein Blog",
    "domain": "meinblog.de",
    "language": "de",
    "country": "DE",
    "team_id": 7,
    "created_at": "2026-05-01T08:30:00Z"
  }
}

Sub-recursos por proyecto

Articles

Todos los endpoints CRUD y de generación de artículos cuelgan del proyecto:

API completa de artículos → API de Artículos.

Keywords

Internal Linking

Otros sub-recursos del proyecto

Tracking Projects (¡recurso propio!)

Los Tracking Projects están separados de los proyectos normales. Son la base de datos para AI Visibility Tracking — por cada Tracking Project una marca, un set de keywords y un set de plataformas.

Namespace de endpoints: /v1/tracking-projects/...

Flujo del asistente

La interfaz web tiene un asistente de 5 pasos que puedes replicar 1:1 por API:

# Paso 1+2: arrancar el análisis
RESP=$(curl -s -X POST "$BASE/tracking-projects/analyze" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"mode":"domain","domain":"example.com","language":"de","country":"DE"}')
PID=$(echo $RESP | jq -r .project_id)

# Paso 3+4: polling hasta completed
while [ "$(curl -s "$BASE/tracking-projects/$PID/analysis-status" \
  -H "Authorization: Bearer $TOKEN" | jq -r .analysis_status)" != "completed" ]; do
  sleep 3
done

# Paso 5: activación atómica
curl -X POST "$BASE/tracking-projects/$PID/activate" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{
    "keywords":["best crm","crm software"],
    "competitors":[{"domain":"hubspot.com"}],
    "prompts":[{"prompt":"What is the best CRM?","category":"recommendation"}],
    "platforms":["chatgpt","perplexity"],
    "frequency":"weekly",
    "with_search":true,
    "reality_check_enabled":true
  }'

Operaciones runtime

Tabla completa de los ~30 endpoints de tracking en docs/API_REFERENCE.md.

Workflow de ejemplo: proyecto + primer artículo

# 1) Crear proyecto
PID=$(curl -s -X POST "$BASE/projects" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"name":"Demo Site","domain":"demo.example","language":"de","country":"DE"}' \
  | jq -r .data.id)

# 2) Crear stub de artículo
ART=$(curl -s -X POST "$BASE/projects/$PID/articles" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"title":"Beste AI-Tools 2026","status":"draft"}' \
  | jq -r .data.id)

# 3) Generar el contenido del artículo (5 créditos, async)
curl -X POST "$BASE/articles/$ART/generate" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"keyword":"AI Tools 2026","article_type":"blog","target_length":1500}'

# 4) Polling hasta listo
while [ "$(curl -s "$BASE/articles/$ART" \
  -H "Authorization: Bearer $TOKEN" | jq -r .data.processing_status)" != "ready" ]; do
  sleep 5
done

Workflows detallados de artículos: API de Artículos.

Relacionado: Autenticación y tokens de API · Créditos y rate limits · AI Visibility Tracking.