Apify (préversion)

Apify exécute des scrapers web et des agents IA, gère les acteurs et les tâches, planifie et surveille les exécutions, récupère les jeux de données et les résultats, et déclenche des flux à partir de webhooks. Il permet la collecte, l’enrichissement et l’automatisation de données de bout en bout dans les flux de travail.

Ce connecteur est disponible dans les produits et régions suivants :

Service Class Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Prise en charge d’Apify
URL https://apify.com/contact
Email support@apify.com
Métadonnées du connecteur
Éditeur S’excuser
Pour plus d’informations sur Apify. https://docs.apify.com
Website https://apify.com
Politique de confidentialité https://apify.com/privacy-policy
Categories Données; IA

S’excuser

Apify est le plus grand marché d’outils pour l’IA. Le connecteur Apify pour Power Automate vous permet d’exécuter des scrapers web et des agents IA (appelés Actors), d’exécuter des tâches préconfigurées, de récupérer des données structurées à partir de jeux de données et de magasins clé-valeur, et de déclencher des flux de travail automatisés lorsque les travaux se terminent. Plus de 30 000 acteurs prêts à l’emploi sont disponibles sur Apify Store pour les cas d’usage courants de la récupération et de l’automatisation.

Éditeur

Apify Technologies s.r.o.

Prerequisites

  • Un compte Apify : inscrivez-vous gratuitement à apify.com. Un niveau gratuit avec des crédits de plateforme mensuels est inclus.
  • Autorisation OAuth 2.0 : le connecteur s’authentifie via le flux OAuth d’Apify. Aucun jeton d’API ni configuration manuelle des informations d’identification n’est nécessaire pour les utilisateurs finaux.

Comment obtenir des informations d’identification

Le connecteur utilise l’authentification OAuth 2.0. Lorsque vous ajoutez le connecteur Apify à un flux et créez une connexion, vous êtes automatiquement redirigé vers la console Apify pour autoriser l’accès. Suivez ces étapes :

  1. Dans votre flux de Power Automate, ajoutez une action ou un déclencheur Apify.
  2. Lorsque vous êtes invité à créer une connexion, cliquez sur Se connecter.
  3. Vous êtes redirigé vers la page d’autorisation de la console Apify à l’adresse console.apify.com.
  4. Si vous n’êtes pas connecté à Apify, entrez l’e-mail et le mot de passe de votre compte Apify (ou utilisez Google/GitHub connexion).
  5. Passez en revue les autorisations demandées :
    • profil - accès à vos informations de profil utilisateur
    • full_api_access - accès complet à l’API Apify en votre nom
  6. Cliquez sur Autoriser pour accorder l’accès au connecteur.
  7. Vous êtes redirigé vers Power Automate avec une connexion active.

Aucune entrée manuelle de jetons d’API, d’ID client ou de secrets n’est requise pour les utilisateurs finaux. Le connecteur gère automatiquement l’actualisation des jetons.

Pour l’équipe de révision de certification Microsoft

Pour tester le connecteur, vous aurez besoin d’un compte Apify. Vous pouvez en créer un gratuitement à apify.com - aucune carte de crédit n’est requise. Le niveau gratuit inclut suffisamment de crédits de plateforme pour exécuter les acteurs de test et vérifier toutes les opérations de connecteur. Après avoir créé un compte, suivez les étapes 1 à 7 ci-dessus pour autoriser le connecteur.

Opérations prises en charge

Actions

Operation Description
Exécuter l’acteur Exécute un acteur Apify avec l’entrée spécifiée. Vous pouvez sélectionner parmi les acteurs récemment utilisés ou parcourir Apify Store. Attendez éventuellement jusqu’à 60 secondes pour que l’exécution se termine. Retourne les métadonnées d’exécution, notamment l’état, l’ID de jeu de données et l’ID de magasin de clés-valeur.
Exécuter la tâche Exécute une tâche Actor préconfigurée. Les tâches stockent les configurations d’entrée par défaut afin de pouvoir les exécuter sans spécifier d’entrée à chaque fois. Remplacez éventuellement l’entrée par défaut par des valeurs personnalisées.
Supprimer une URL unique Extrait une page web unique à l’aide de l’acteur Apify Web Scraper. Choisissez entre les modes d’analyse adaptatifs (recommandés), Firefox headless browser ou Cheerio (HTTP brut). Retourne les métadonnées d’exécution pour le suivi.
Obtenir des éléments de jeu de données Récupère des éléments à partir d’un jeu de données Apify. Les jeux de données stockent des résultats structurés à partir des exécutions d’acteur. Prend en charge la pagination avec les paramètres de limite et de décalage. Le schéma de réponse est déduit dynamiquement du contenu du jeu de données.
Obtenir l’enregistrement du magasin clé-valeur Récupère un enregistrement à partir d’un magasin clé-valeur Apify par sa clé. Les magasins clé-valeur contiennent des fichiers, des configurations et un état d’exécution. Le schéma de réponse est déduit dynamiquement du contenu de l’enregistrement.

Triggers

Operation Description
Exécution de l’acteur terminée Se déclenche lorsqu’une exécution d’acteur sélectionnée se termine. Abonnez-vous à des états d’achèvement spécifiques : réussite, échec, expiration ou abandon. Tous les états sont activés par défaut. La charge utile du déclencheur inclut des détails et des métadonnées d’exécution complets.
Tâche d’acteur terminée Se déclenche lorsqu’une exécution de tâche d’acteur sélectionnée se termine. Les mêmes options de filtrage d’état que le déclencheur d’exécution de l’acteur ont terminé. Utile pour surveiller les exécutions planifiées ou périodiques des tâches.

Premiers pas

Flux de travail de base : Exécuter un acteur et obtenir des résultats

  1. Ajoutez l’action Exécuter l’acteur à votre flux.
  2. Sélectionnez un acteur à partir de vos acteurs récemment utilisés ou à partir d’Apify Store.
  3. Fournissez le JSON d’entrée requis par l’acteur.
  4. Ajoutez l’action Obtenir des éléments de jeu de données .
  5. Utilisez la sortie de l’ID de jeu de données par défaut de l’étape Exécuter l’acteur en tant que paramètre de jeu de données.
  6. Traitez les éléments retournés dans les étapes de flux suivantes.

Flux de travail piloté par les événements : Réagir aux exécutions terminées

  1. Ajoutez le déclencheur d’exécution d’acteur terminé en tant que déclencheur du flux.
  2. Sélectionnez l’acteur que vous souhaitez surveiller.
  3. Choisissez les états d’achèvement qui doivent déclencher le flux (tous activés par défaut).
  4. Dans les étapes suivantes, utilisez la charge utile du déclencheur pour accéder aux détails de l’exécution et récupérer les résultats.

Flux de travail de récupération rapide

  1. Ajoutez l’action d’URL unique Scrape .
  2. Entrez l’URL à récupérer.
  3. Sélectionnez un type d’analyseur (adaptatif est recommandé pour la plupart des sites).
  4. Utilisez le déclencheur d’exécution d’acteur terminé ou interrogez l’achèvement pour obtenir les résultats.

Problèmes connus et limitations

  • Le paramètre Wait for Finish a un maximum de 60 secondes. Pour les acteurs de longue durée, utilisez le déclencheur d’exécution d’acteur terminé au lieu d’attendre.
  • Les schémas de jeu de données sont déduits dynamiquement à partir d’un exemple d’élément. Ils peuvent ne pas capturer tous les champs possibles si le jeu de données contient des éléments avec des structures variables.
  • Les schémas d’enregistrement du magasin de valeurs clés sont déduits du contenu de l’enregistrement. Les enregistrements binaires (images, fichiers PDF) sont retournés as-is sans inférence de schéma.
  • L’action Scrape single URL utilise un acteur fixe (Web Scraper). Pour les scénarios de récupération avancés, utilisez Run Actor avec un acteur spécialisé à partir d’Apify Store.
  • Les options d’allocation de mémoire vont de 128 Mo à 32 Go. Commencez par les paramètres par défaut pour optimiser les coûts.

Erreurs courantes et solutions

Error Correctif
Impossible de s’authentifier Vérifiez que vous disposez d’un compte Apify actif. Essayez de supprimer la connexion et de en créer une nouvelle.
L’exécution de l’acteur retourne l’état FAILED Vérifiez les journaux d’activité d’exécution de l’acteur dans La console Apify pour obtenir des messages d’erreur détaillés. Vérifiez que l’entrée correspond au format attendu de l’acteur.
Le jeu de données est vide une fois l’exécution terminée Vérifiez que l’exécution de l’acteur s’est terminée avec l’état SUCCEEDED. La structure du site web cible peut avoir changé.
Le flux expire en attente de l’acteur Définissez « Attendre la fin » sur 0 et utilisez le déclencheur « Exécution de l’acteur terminé » pour gérer les acteurs de longue durée de manière asynchrone.
Déclencheur webhook ne se déclenche pas Vérifiez que l’ID d’acteur ou de tâche est correct. Vérifiez qu’au moins un état d’événement est activé.

FAQ

Combien coûte Apify ? Le connecteur lui-même est libre. Apify frais pour l’utilisation de la plateforme en fonction du temps de calcul et des ressources consommées. Un niveau gratuit avec des crédits mensuels est inclus avec chaque compte. Pour plus d’informations, consultez apify.com/pricing .

Qu’est-ce qu’un « acteur » ? Les acteurs sont des programmes cloud serverless qui s’exécutent sur la plateforme Apify. Ils peuvent effectuer l’extraction web, l’extraction de données, l’automatisation de l’IA, etc. Parcourez plus de 30 000 acteurs prêts à l’apify.com/store.

Que sont les tâches ? Les tâches sont enregistrées des configurations pour Actors. Ils stockent les valeurs d’entrée par défaut pour que vous puissiez exécuter un acteur avec des paramètres prédéfinits sans les saisir à chaque fois.

Actions

Exécuter la tâche

Exécute une tâche Actor et retourne immédiatement sans attendre la fin de l’exécution. Pour attendre la fin de l’exécution, utilisez le paramètre de requête waitForFinish.

Exécuter l’acteur

Exécute un acteur et retourne immédiatement sans attendre la fin de l’exécution. Pour attendre la fin de l’exécution, utilisez le paramètre de requête waitForFinish.

Obtenir des éléments de jeu de données

Récupère les éléments de l’un de vos jeux de données Apify avec des paramètres de pagination facultatifs.

Obtenir l’enregistrement du magasin clé-valeur

Obtient une valeur stockée dans le magasin clé-valeur sous une clé spécifique.

Supprimer une URL unique

Extrait une URL unique à l’aide de l’acteur Web Scraper. Cette action démarre une récupération asynchrone et retourne immédiatement les détails de l’exécution. Utilisez le déclencheur d’exécution d’acteur terminé pour traiter les résultats une fois la récupération terminée.

Exécuter la tâche

Exécute une tâche Actor et retourne immédiatement sans attendre la fin de l’exécution. Pour attendre la fin de l’exécution, utilisez le paramètre de requête waitForFinish.

Paramètres

Nom Clé Obligatoire Type Description
Task
taskId True string

Identificateur de tâche à exécuter.

Attendre la fin (0 à 60 secondes)
waitForFinish integer

Attendez que l’exécution se termine en secondes (0-60).

Délai d’attente (secondes)
timeout integer

Délai d’expiration de l’exécution en secondes.

Build
build string

Build d’acteur à exécuter (balise ou numéro de build). En règle générale, c’est la « dernière ».

Mémoire (Mo)
memory integer

Limite de mémoire en Mo (puissance de 2, min 128).

object

Objet JSON brut pour remplacer l’entrée par défaut de la tâche.

Exécuter l’acteur

Exécute un acteur et retourne immédiatement sans attendre la fin de l’exécution. Pour attendre la fin de l’exécution, utilisez le paramètre de requête waitForFinish.

Paramètres

Nom Clé Obligatoire Type Description
Sélectionner l’acteur dans
actorScope True string

Sélectionnez la source à partir de laquelle effectuer la recherche d’Acteurs.

Acteur
actorId True string

Identificateur d’acteur à exécuter. Fournissez l’ID d’acteur.

Attendre la fin (0 à 60 secondes)
waitForFinish integer

Attendez que l’exécution se termine en secondes (0-60).

Délai d’attente (secondes)
timeout integer

Délai d’expiration de l’exécution en secondes.

Build
build string

Build d’acteur à exécuter (balise ou numéro de build). En règle générale, c’est la « dernière ».

Mémoire (Mo)
memory integer

Limite de mémoire en Mo (puissance de 2, min 128).

object

Objet JSON brut transmis en tant qu’ENTRÉE à l’acteur.

Obtenir des éléments de jeu de données

Récupère les éléments de l’un de vos jeux de données Apify avec des paramètres de pagination facultatifs.

Paramètres

Nom Clé Obligatoire Type Description
Dataset
datasetId True string

Sélectionnez le jeu de données à partir duquel récupérer des éléments.

Limite
limit integer

Nombre maximal d’éléments à renvoyer.

Offset
offset integer

Nombre d’éléments à ignorer à partir du début de la liste.

Retours

Les sorties de cette opération sont dynamiques.

Obtenir l’enregistrement du magasin clé-valeur

Obtient une valeur stockée dans le magasin clé-valeur sous une clé spécifique.

Paramètres

Nom Clé Obligatoire Type Description
Magasin
storeId True string

Sélectionnez le magasin clé-valeur à partir duquel récupérer l’enregistrement.

Clé
recordKey True string

Sélectionnez la clé à partir de laquelle récupérer l’enregistrement.

Retours

Les sorties de cette opération sont dynamiques.

Supprimer une URL unique

Extrait une URL unique à l’aide de l’acteur Web Scraper. Cette action démarre une récupération asynchrone et retourne immédiatement les détails de l’exécution. Utilisez le déclencheur d’exécution d’acteur terminé pour traiter les résultats une fois la récupération terminée.

Paramètres

Nom Clé Obligatoire Type Description
URL à récupérer
url True string

URL complète de la page unique à supprimer. Doit être un format d’URL valide.

Type d’analyseur
crawler_type True string

Sélectionnez le moteur d’analyse à utiliser pour la suppression de la page.

Déclencheurs

Exécution de l’acteur terminée

Crée un webhook pour s’abonner aux événements d’exécution d’acteur. Se déclenche lorsque l’exécution de l’acteur sélectionnée se termine avec un état spécifique. Tous les états sont activés par défaut ; seuls les états définis explicitement sur false sont exclus. Au moins un état doit rester activé.

Tâche d’acteur terminée

Crée un webhook pour s’abonner aux événements d’exécution de tâche d’acteur. Se déclenche lorsque l’exécution de la tâche d’acteur sélectionnée se termine avec un état spécifique. Tous les états sont activés par défaut ; seuls les états définis explicitement sur false sont exclus. Au moins un état doit rester activé.

Exécution de l’acteur terminée

Crée un webhook pour s’abonner aux événements d’exécution d’acteur. Se déclenche lorsque l’exécution de l’acteur sélectionnée se termine avec un état spécifique. Tous les états sont activés par défaut ; seuls les états définis explicitement sur false sont exclus. Au moins un état doit rester activé.

Paramètres

Nom Clé Obligatoire Type Description
Sélectionner l’acteur dans
actorScope True string

Sélectionnez la source à partir de laquelle effectuer la recherche d’Acteurs.

Statuts
eventTypes array of string

Les états d’exécution de l’acteur sont activés.

Acteur
actorId True string

Identificateur d’acteur à surveiller. Fournissez l’ID d’acteur.

Déclencheur lors de l’exécution réussie
onRunSucceeded boolean

Déclencher lorsqu’une exécution d’acteur réussit. La valeur par défaut est true si elle n’est pas définie.

Échec du déclencheur lors de l’exécution
onRunFailed boolean

Déclencher lorsqu’une exécution d’acteur échoue. La valeur par défaut est true si elle n’est pas définie.

Déclencheur à l’expiration du délai d’expiration
onRunTimedOut boolean

Déclencher lorsqu’un acteur expire. La valeur par défaut est true si elle n’est pas définie.

Déclencheur lors de l’exécution abandonnée
onRunAborted boolean

Déclencher lorsqu’une exécution d’acteur est abandonnée. La valeur par défaut est true si elle n’est pas définie.

Retours

Charge utile d’événement envoyée par webhook lorsqu’une exécution d’acteur se termine.

Charge utile du webhook
WebhookPayloadSchema

Tâche d’acteur terminée

Crée un webhook pour s’abonner aux événements d’exécution de tâche d’acteur. Se déclenche lorsque l’exécution de la tâche d’acteur sélectionnée se termine avec un état spécifique. Tous les états sont activés par défaut ; seuls les états définis explicitement sur false sont exclus. Au moins un état doit rester activé.

Paramètres

Nom Clé Obligatoire Type Description
Statuts
eventTypes array of string

Les états d’exécution de l’acteur sont activés.

Task
actorTaskId True string

Sélectionnez la tâche d’acteur à surveiller pour les événements.

Déclencheur lors de l’exécution réussie
onRunSucceeded boolean

Déclencher lorsqu’une exécution d’acteur réussit. La valeur par défaut est true si elle n’est pas définie.

Échec du déclencheur lors de l’exécution
onRunFailed boolean

Déclencher lorsqu’une exécution d’acteur échoue. La valeur par défaut est true si elle n’est pas définie.

Déclencheur à l’expiration du délai d’expiration
onRunTimedOut boolean

Déclencher lorsqu’un acteur expire. La valeur par défaut est true si elle n’est pas définie.

Déclencheur lors de l’exécution abandonnée
onRunAborted boolean

Déclencher lorsqu’une exécution d’acteur est abandonnée. La valeur par défaut est true si elle n’est pas définie.

Retours

Charge utile d’événement envoyée par webhook lorsqu’une exécution d’acteur se termine.

Charge utile du webhook
WebhookPayloadSchema

Définitions

ActorRunResponseSchema

Renseignez les informations sur une exécution d’acteur exécutée.

Nom Chemin d’accès Type Description
ID d’exécution de l’acteur
id string

Identificateur unique de l’exécution de l’acteur.

ID d’acteur
actId string

Identificateur unique de l’acteur qui a été exécuté.

ID d'utilisateur
userId string

Identificateur unique de l’utilisateur propriétaire de l’acteur.

ID de tâche d’acteur
actorTaskId string

Identificateur unique de la tâche Actor (si l’exécution a été démarrée à partir d’une tâche).

Démarré à l’adresse
startedAt date-time

Horodatage lorsque l’exécution de l’acteur a démarré.

Terminé à
finishedAt date-time

Horodatage lorsque l’exécution de l’acteur s’est terminée.

Status
status string

État de l’exécution de l’acteur (par exemple, SUCCEEDED, FAILED, RUNNING, ABORTED).

Message d’état
statusMessage string

Message d’état détaillé de l’exécution de l’acteur, y compris le traitement du résumé et des résultats.

Terminal de message d’état
isStatusMessageTerminal boolean

Indique si le message d’état est terminal (final) ou peut changer pendant l’exécution.

Metadata
meta object

Métadonnées supplémentaires sur l’exécution de l’acteur, notamment les informations d’origine et d’agent utilisateur.

Informations sur la tarification
pricingInfo object

Informations de tarification détaillées, notamment le modèle tarifaire, les événements et la répartition des coûts.

Stats
stats object

Statistiques de performances, notamment l’exécution, l’utilisation de la mémoire, l’utilisation du processeur et le trafic réseau.

Nombre d’événements facturés
chargedEventCounts object

Nombre d’événements facturables qui se sont produits pendant l’exécution de l’acteur.

Options
options object

Options de configuration utilisées pour l’exécution de l’acteur (mémoire, délai d’expiration, version de build, etc.).

ID de build
buildId string

Identificateur unique de la build Actor utilisée pour cette exécution.

Code de sortie
exitCode number

Code de sortie retourné par le processus Actor (0 indique la réussite).

ID de magasin de clé-valeur par défaut
defaultKeyValueStoreId string

Identificateur unique du magasin clé-valeur par défaut associé à cette exécution.

ID de jeu de données par défaut
defaultDatasetId string

Identificateur unique du jeu de données par défaut où l’acteur a stocké ses résultats.

ID de file d’attente de requête par défaut
defaultRequestQueueId string

Identificateur unique de la file d’attente de requêtes par défaut utilisée par l’acteur.

Numéro de build
buildNumber string

Numéro de build de la version d’Actor utilisée pour cette exécution.

URL du conteneur
containerUrl string

URL du conteneur où l’exécution de l’acteur a été exécutée.

Serveur de conteneurs prêt
isContainerServerReady boolean

Indique si le serveur conteneur est prêt et accessible.

Nom de la branche Git
gitBranchName string

Nom de la branche Git utilisée pour cette exécution d’acteur (le cas échéant).

Total de l’utilisation USD
usageTotalUsd number

Coût total de l’acteur exécuté en USD.

WebhookPayloadSchema

Charge utile d’événement envoyée par webhook lorsqu’une exécution d’acteur se termine.

Nom Chemin d’accès Type Description
identifiant utilisateur
userId string

ID de l’utilisateur propriétaire de la ressource associée à l’événement.

createdAt
createdAt date-time

Horodatage à laquelle l’événement s’est produit.

eventType
eventType string

Type de l’événement qui a déclenché le webhook (par exemple, ACTOR. EXÉCUTEZ. RÉUSSITE).

actorId
eventData.actorId string

ID de l’acteur déclencheur.

actorRunId
eventData.actorRunId string

ID de l’exécution spécifique de l’acteur qui a déclenché l’événement.

Réponse d’exécution de l’acteur
resource ActorRunResponseSchema

Renseignez les informations sur une exécution d’acteur exécutée.