Intégration Apify n8nAutomatiser Apify avec n8n.

Lance un Actor et renvoie le run, sans forcément attendre sa fin. La moitié « on lance et on oublie » du nœud, à associer au trigger pour les crawls longs.

• Actor : requis, au format username~actor-name ou en identifiant simple.
• Input JSON : remplace l'entrée préremplie. Sur un scraper web, les champs courants sont startUrls, maxCrawlPages et proxyConfiguration ; {} garde les valeurs par défaut de l'Actor.
• Wait for Finish : garde l'exécution ouverte jusqu'à la fin du run, sans dépasser le timeout de workflow.
• Maximum Cost per Run (USD) : interrompt le run une fois le montant atteint, sur les Actors facturés à l'événement ou au résultat.

Un seul nœud pour trois gestes : il démarre l'Actor, attend qu'il finisse, et renvoie les items du dataset. Les lignes sortent directement, donc le nœud suivant travaille sur de vraies données et pas sur un identifiant de run.

• Actor : requis, l'Actor à lancer, à repérer dans l'Apify Store.
• Input JSON : l'entrée du run, dont la structure dépend de l'Actor. Le schéma exact se consulte dans l'Apify Console.
• Timeout : un délai de run en secondes, à la place de la configuration par défaut de l'Actor.
• Memory : la limite mémoire en mégaoctets, de 128 jusqu'à 32768.

Fait passer une page dans l'Actor Website Content Crawler et rend son contenu en texte, en markdown et en HTML. Aucun identifiant d'Actor à aller chercher, ce qui en fait le chemin le plus court pour lire une page depuis un workflow.

• URL : l'adresse à scraper. Elle doit commencer par http:// ou https:// et être valide.
• Crawler Type : cheerio, jsdom, playwright:adaptive ou playwright:firefox, selon la dépendance de la page aux scripts.
• Output Format : markdown pour les agents IA et les modèles de langage, html pour un traitement programmatique, text pour du contenu sans mise en forme.

Récupère le run le plus récent d'un Actor, avec son statut et ses stockages, sans avoir à connaître un identifiant de run au préalable. Utile quand le workflow démarre ailleurs que chez Apify.

• Actor : requis, l'identifiant de l'Actor ou le couple nom d'utilisateur et nom d'Actor séparés par un tilde.
• Status : restreint la réponse à un état, parmi READY, RUNNING, SUCCEEDED, FAILED, ABORTING, ABORTED, TIMING-OUT et TIMED-OUT.

Une tâche, c'est une configuration d'Actor enregistrée dans l'Apify Console. Cette opération en lance une et renvoie tous les détails associés. L'entrée reste côté Apify, ce qui allège le nœud n8n.

• Actor Task : requis, sous la forme username~task-name ou en identifiant simple.
• Use Custom Body : à activer pour écraser l'entrée enregistrée dans la tâche.
• Input (JSON) : la surcharge elle-même, qui suit le schéma d'entrée de l'Actor derrière la tâche.
• Build Tag : le build à exécuter, à la place de celui fixé dans les réglages de la tâche.

Même tâche enregistrée, mais ici le nœud attend et ressort directement les items du dataset. Le second saut disparaît quand la tâche finit assez vite pour tenir dans une exécution.

• Actor Task : requis, la tâche à lancer, gérée dans l'Apify Console.
• Use Custom Body : indique si l'entrée enregistrée est remplacée pour ce run.
• Timeout : un délai de run en secondes, qui prend le pas sur les réglages de la tâche.
• Maximum Cost per Run (USD) : le plafond en USD au-delà duquel le run est interrompu. Vide, il n'y a pas de limite.

Renvoie l'historique des runs du compte entier, et pas ceux d'un seul Actor. C'est l'opération qui sert à tout reporting sur ce qui a réellement tourné, et elle n'exige aucun champ obligatoire.

• Limit : combien de runs remontent au maximum.
• Offset : le nombre d'entrées sautées au début, 0 par défaut, de quoi remonter un historique long morceau par morceau.
• Desc : bascule le tri sur startedAt en décroissant. Les runs récents d'abord.
• Status : ne garde que les runs dans un état terminal, parmi SUCCEEDED, FAILED, TIMED-OUT et ABORTED.

Va chercher un run précis par son identifiant et renvoie ses métadonnées, son statut et ses stockages. La plupart des workflows l'appellent juste après un événement du trigger, pour transformer une référence brute en quelque chose d'exploitable.

• Run ID : requis, le plus souvent une expression du type {{ $json.id }} qui pointe le run qui vient de se terminer. Un champ requis laissé vide bloque l'exécution du nœud.

Liste les runs d'un Actor précis, et c'est toute la différence avec l'historique du compte. À sortir quand tu veux regarder un crawler dans la durée.

• Actor : requis, l'Actor dont tu veux l'historique, en identifiant ou en couple séparé par un tilde.
• Status : filtre la liste, avec ici une valeur vide qui vaut All à côté des états individuels.
• Desc : inverse le tri croissant appliqué par défaut sur startedAt.
• Limit : le nombre maximal de résultats, associé à Offset pour parcourir la suite.

Arrête un run encore en cours. C'est la seule opération du nœud qui modifie quelque chose au lieu de le lire, ce qui mérite d'y penser à deux fois avant de la câbler derrière un automatisme.

• Run ID : requis, l'identifiant du run à interrompre, en général transmis par un nœud précédent.
• Graceful : laisse à l'Actor le temps de finir sa tâche en cours avant l'arrêt. Désactivé, le run est tué immédiatement.

Lit les lignes d'un dataset, c'est-à-dire l'endroit où un Actor dépose ce qu'il a collecté. Voilà l'opération qui transforme un run terminé en items utilisables par les autres nœuds.

• Dataset ID : requis, soit l'identifiant, soit username~dataset-name.
• Limit : le nombre maximal d'items renvoyés, avec Offset qui saute les premiers pour lire un gros dataset par tranches.
• Fields : la liste des seuls champs à conserver, séparés par des virgules, de quoi calmer un résultat de scraping très large.
• Omit : l'inverse, les champs à exclure ; un champ présent dans les deux listes est exclu.

Les key-value stores gardent les objets uniques qu'un run produit, une capture ou un fichier de synthèse plutôt qu'un tableau de lignes. Cette opération en lit un, par sa clé.

• Key-Value Store ID : requis, le store à interroger, souvent celui rattaché au run que tu viens de récupérer.
• Key-Value Store Record Key : requis, la clé de l'enregistrement voulu. Les deux champs se choisissent dans une liste ou se posent avec une expression.