API Projets

Dans Rankion, un projet est le conteneur central — un projet par domaine, un team-owner, et toutes les sous-ressources (articles, mots-clés, maps de liens internes, storylines) y sont rattachées. À côté, il y a les projets de tracking, ressource distincte dédiée au monitoring AI Visibility (voir plus bas).

CRUD

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

# Création
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"}'

Réponse (abrégée) :

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

Sous-ressources liées au projet

Articles

Tous les endpoints CRUD et de génération d'articles dépendent du projet :

API Articles complète → API Articles.

Mots-clés

Maillage interne

Autres sous-ressources de projet

Projets de tracking (ressource distincte !)

Les projets de tracking sont séparés des projets normaux. Ils constituent la base de données pour AI Visibility Tracking — un projet de tracking par marque, un set de mots-clés, un set de plateformes.

Namespace d'endpoints : /v1/tracking-projects/...

Flux de l'assistant

L'interface web propose un assistant en 5 étapes que tu peux reproduire 1:1 via l'API :

# Étape 1+2 : démarrer l'analyse
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)

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

# Étape 5 : activation atomique
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
  }'

Opérations courantes

Tableau complet des ~30 endpoints de tracking dans docs/API_REFERENCE.md.

Exemple de workflow : projet + premier article

# 1) Créer le projet
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) Créer un stub d'article
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) Générer le contenu de l'article (5 crédits, 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) Poller jusqu'à terminé
while [ "$(curl -s "$BASE/articles/$ART" \
  -H "Authorization: Bearer $TOKEN" | jq -r .data.processing_status)" != "ready" ]; do
  sleep 5
done

Workflows détaillés pour les articles : API Articles.

Voir aussi : Authentification & tokens API · Crédits & rate-limits · AI Visibility Tracking.