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 |
| 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 :
- Dans votre flux de Power Automate, ajoutez une action ou un déclencheur Apify.
- Lorsque vous êtes invité à créer une connexion, cliquez sur Se connecter.
- Vous êtes redirigé vers la page d’autorisation de la console Apify à l’adresse
console.apify.com. - 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).
- 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
- Cliquez sur Autoriser pour accorder l’accès au connecteur.
- 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
- Ajoutez l’action Exécuter l’acteur à votre flux.
- Sélectionnez un acteur à partir de vos acteurs récemment utilisés ou à partir d’Apify Store.
- Fournissez le JSON d’entrée requis par l’acteur.
- Ajoutez l’action Obtenir des éléments de jeu de données .
- 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.
- 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
- Ajoutez le déclencheur d’exécution d’acteur terminé en tant que déclencheur du flux.
- Sélectionnez l’acteur que vous souhaitez surveiller.
- Choisissez les états d’achèvement qui doivent déclencher le flux (tous activés par défaut).
- 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
- Ajoutez l’action d’URL unique Scrape .
- Entrez l’URL à récupérer.
- Sélectionnez un type d’analyseur (adaptatif est recommandé pour la plupart des sites).
- 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.
Liens utiles
- Documentation Apify
- Informations de référence sur l’API Apify
- Apify Store - Parcourir Actors
- Tarification Apify
- Support et contact
- Forum de la communauté
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
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
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. |