Extraire le contenu d'une URL

Prérequis

• Clé API avec le scope content:extract (opt-in — absent des scopes par défaut)
• Feature scraping activée sur l'instance (SCRAPE_CRAWL_ENABLED)
• Assistant IA activé globalement sur l'instance (AI_GLOBAL_ENABLED)
• Accès API (plan Starter ou add-on Accès API)

Flow asynchrone

1. POST /api/v1/content/extract avec { "url": "https://…" } → réponse { jobId, status: "PENDING" }
2. Poll GET /api/v1/content/extract/{jobId} jusqu'à status READY ou FAILED
3. Si READY, le champ text contient le contenu extrait (tronqué à 100 000 caractères)

Statuts possibles : PENDING, READY, FAILED (voir errorReason).

Exemple sandbox (cURL)

# 1. Lancer l'extraction
curl --request POST \
  "https://sandbox-api.reachflow.me/api/v1/content/extract" \
  -H "X-API-Key: rfl_sandbox_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/article"}'

# 2. Consulter le résultat (répéter si status PENDING)
curl --request GET \
  "https://sandbox-api.reachflow.me/api/v1/content/extract/JOB_ID_ICI" \
  -H "X-API-Key: rfl_sandbox_VOTRE_CLE"

Remplacez JOB_ID_ICI par le jobId retourné à l'étape 1.

Limites et bonnes pratiques

Le rendu JavaScript (pages SPA) dépend de la configuration plateforme (SCRAPE_RENDER_URL). Le champ renderedWithJs indique si un rendu navigateur a été utilisé.

Erreurs fréquentes

• 403 insufficient_scope — ajoutez content:extract à la clé API
• 400 « extraction web non activée » — scraping désactivé sur l'instance
• 400 « trop d'extractions » — attendez une minute
• 404 — job introuvable ou expiré

Suite

• Référence technique — Extraction de contenu
• Créer une clé API