Apify (förhandsversion)

Apify kör webbskrapor och AI-agenter, hanterar aktörer och uppgifter, scheman och övervakar körningar, hämtar datauppsättningar och resultat och utlöser flöden från webhooks. Det möjliggör insamling, berikande och automatisering av data från slutpunkt till slutpunkt i arbetsflöden.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Service Class Regions
Copilot Studio Premie Alla Power Automate-regioner utom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Logiska appar Standard Alla Logic Apps-regioner utom följande:
     - Azure Government regioner
     – Regioner i Azure Kina
     - US Department of Defense (DoD)
Power Apps Premie Alla Power Apps-regioner utom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Power Automate Premie Alla Power Automate-regioner utom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Kontakt
Namn Apify-stöd
URL https://apify.com/contact
E-post support@apify.com
Metadata för anslutningsprogram
Utgivare Apify
Mer information om Apify finns. https://docs.apify.com
Webbplats https://apify.com
Sekretesspolicy https://apify.com/privacy-policy
Kategorier Data; Artificiell intelligens

Apify

Apify är den största marknadsplatsen för verktyg för AI. Med Apify-anslutningsappen för Power Automate kan du köra webbskrapor och AI-agenter (kallas Aktörer), köra förkonfigurerade uppgifter, hämta strukturerade data från datauppsättningar och nyckelvärdeslager och utlösa automatiserade arbetsflöden när jobben är klara. Över 30 000 färdiga aktörer finns tillgängliga i Apify Store för vanliga användningsfall för skrapning och automatisering.

Utgivare

Apify Technologies s.r.o.

Förutsättningar

  • Ett Apify-konto – registrera dig kostnadsfritt på apify.com. En kostnadsfri nivå med månatliga plattformskrediter ingår.
  • OAuth 2.0-auktorisering – anslutningsappen autentiseras via Apifys OAuth-flöde. Slutanvändarna behöver inga API-token eller manuell konfiguration av autentiseringsuppgifter.

Hämta autentiseringsuppgifter

Anslutningsappen använder OAuth 2.0-autentisering. När du lägger till Apify-anslutningsappen i ett flöde och skapar en ny anslutning omdirigeras du automatiskt till Apify-konsolen för att auktorisera åtkomst. Följ de här stegen:

  1. I ditt Power Automate-flöde lägger du till valfri Apify-åtgärd eller utlösare.
  2. När du uppmanas att skapa en anslutning klickar du på Logga in.
  3. Du omdirigeras till auktoriseringssidan för Apify-konsolen på console.apify.com.
  4. Om du inte är inloggad på Apify anger du e-post och lösenord för Apify-kontot (eller använder Google/GitHub inloggning).
  5. Granska de begärda behörigheterna:
    • profil – åtkomst till din användarprofilinformation
    • full_api_access – fullständig åtkomst till Api:et Apify åt dig
  6. Klicka på Auktorisera för att bevilja anslutningsappen åtkomst.
  7. Du omdirigeras tillbaka till Power Automate med en aktiv anslutning.

Inga manuella inmatningar av API-token, klient-ID:n eller hemligheter krävs från slutanvändarna. Anslutningsappen hanterar tokenuppdatering automatiskt.

För Microsoft certifieringsgranskningsteamet

För att testa anslutningsappen behöver du ett Apify-konto. Du kan skapa ett kostnadsfritt på apify.com – inget kreditkort krävs. Den kostnadsfria nivån innehåller tillräckligt med plattformskrediter för att köra testaktörer och verifiera alla anslutningsåtgärder. När du har skapat ett konto följer du steg 1–7 ovan för att auktorisera anslutningsappen.

Åtgärder som stöds

Åtgärder

Operation Beskrivning
Kör aktör Kör en Apify-aktör med angivna indata. Du kan välja bland nyligen använda aktörer eller bläddra i Apify Store. Du kan också vänta upp till 60 sekunder tills körningen har slutförts. Returnerar körningsmetadata, inklusive status, datamängds-ID och nyckelvärdeslagrings-ID.
Kör uppgift Kör en förkonfigurerad aktörsaktivitet. Uppgifter lagrar standardindatakonfigurationer så att du kan köra dem utan att ange indata varje gång. Alternativt kan du åsidosätta standardindata med anpassade värden.
Skrapa enstaka URL Skrapar en enda webbsida med hjälp av Apify Web Scraper Actor. Välj mellan anpassningsbara (rekommenderas), firefox huvudlös webbläsare eller Cheerio (rå HTTP) crawlningslägen. Returnerar körningsmetadata för spårning.
Hämta datamängdsobjekt Hämtar objekt från en Apify-datauppsättning. Datauppsättningar lagrar strukturerade resultat från aktörskörningar. Stöder sidnumrering med gräns- och förskjutningsparametrar. Svarsschemat härleds dynamiskt från datamängdens innehåll.
Hämta nyckel/värde-arkivpost Hämtar en post från ett apify-nyckelvärdearkiv med dess nyckel. Nyckelvärdeslager innehåller filer, konfigurationer och körningstillstånd. Svarsschemat härleds dynamiskt från postinnehållet.

Triggers

Operation Beskrivning
Aktörskörningen är klar Utlöses när en vald aktörskörning är klar. Prenumerera på specifika slutförandestatusar: lyckades, misslyckades, tidsgränsen överskrids eller avbröts. Alla statusar är aktiverade som standard. Utlösarnyttolasten innehåller fullständig körningsinformation och metadata.
Aktörsaktiviteten har slutförts Utlöses när en vald aktörsaktivitetskörning har slutförts. Samma statusfiltreringsalternativ som utlösaren för aktörskörningen slutfördes. Användbart för övervakning av schemalagda eller återkommande aktivitetskörningar.

Komma igång

Grundläggande arbetsflöde: Kör en aktör och få resultat

  1. Lägg till åtgärden Kör aktör i ditt flöde.
  2. Välj en aktör från dina nyligen använda aktörer eller från Apify Store.
  3. Ange den JSON-indata som krävs av aktören.
  4. Lägg till åtgärden Hämta datauppsättningsobjekt .
  5. Använd standarddatauppsättningens ID-utdata från steget Kör aktör som datauppsättningsparameter.
  6. Bearbeta de returnerade objekten i efterföljande flödessteg.

Händelsedrivet arbetsflöde: Reagera på slutförda körningar

  1. Lägg till utlösaren Aktörskörning slutförd som flödets utlösare.
  2. Välj den aktör som du vill övervaka.
  3. Välj vilka slutförandestatusar som ska utlösa flödet (alla aktiverade som standard).
  4. I efterföljande steg använder du utlösarnyttolasten för att komma åt körningsinformation och hämta resultat.

Arbetsflöde för snabbskrapa

  1. Lägg till åtgärden Skrapa enstaka URL .
  2. Ange den URL som du vill skrapa.
  3. Välj en crawlningstyp (Adaptive rekommenderas för de flesta webbplatser).
  4. Använd den slutförda utlösaren eller avsökningen aktörskörning för slutförande för att få resultat.

Kända problem och begränsningar

  • Parametern Vänta på slut har högst 60 sekunder. För långvariga aktörer använder du den slutförda utlösaren För aktörskörning i stället för att vänta.
  • Datauppsättningsscheman härleds dynamiskt från ett exempelobjekt. De kanske inte samlar in alla möjliga fält om datamängden innehåller objekt med varierande strukturer.
  • Arkivpostscheman för nyckelvärde härleds från postinnehållet. Binära poster (bilder, PDF-filer) returneras as-is utan schemainferens.
  • En enskild URL-åtgärd för Scrape använder en fast aktör (webbskrapa). För avancerade skrapningsscenarier använder du Kör aktör med en specialiserad aktör från Apify Store.
  • Alternativen för minnesallokering varierar från 128 MB till 32 GB. Börja med standardinställningarna för att optimera kostnaderna.

Vanliga fel och åtgärder

Error Botemedel
Det går inte att autentisera Kontrollera att du har ett aktivt Apify-konto. Prova att ta bort anslutningen och skapa en ny.
Aktörskörning returnerar statusEN MISSLYCKADES Kontrollera om det finns detaljerade felmeddelanden i aktörskörningsloggarna i Apify-konsolen. Kontrollera att indata matchar aktörens förväntade format.
Datauppsättningen är tom när körningen har slutförts Bekräfta att aktörskörningen har slutförts med statusEN LYCKADES. Målwebbplatsens struktur kan ha ändrats.
Tidsgränsen för flödet väntar på aktör Ange "Vänta till slut" till 0 och använd utlösaren "Aktören har körts färdig" för att hantera långvariga aktörer asynkront.
Webhook-utlösare utlöses inte Kontrollera att aktören eller uppgifts-ID:t är korrekt. Kontrollera att minst en händelsestatus är aktiverad.

FAQ

Hur mycket kostar Apify? Själva anslutningsappen är kostnadsfri. Apify avgifter för plattformsanvändning baserat på beräkningstid och förbrukade resurser. En kostnadsfri nivå med månatliga krediter ingår i varje konto. Mer information finns i apify.com/pricing .

Vad är Skådespelare? Aktörer är serverlösa molnprogram som körs på Apify-plattformen. De kan utföra webbskrapa, dataextrahering, AI-automatisering med mera. Bläddra bland över 30 000 färdiga skådespelare på apify.com/store.

Vad är uppgifter? Uppgifter är sparade konfigurationer för Actors. De lagrar standardindatavärden så att du kan köra en aktör med förinställda parametrar utan att ange dem igen varje gång.

Åtgärder

Hämta datamängdsobjekt

Hämtar objekt från en av dina Apify-datauppsättningar med valfria sidnumreringsparametrar.

Hämta nyckel/värde-arkivpost

Hämtar ett värde som lagras i nyckel/värde-arkivet under en specifik nyckel.

Kör aktör

Kör en aktör och returnerar omedelbart utan att vänta på att körningen ska slutföras. Om du vill vänta tills körningen har slutförts använder du frågeparametern waitForFinish.

Kör uppgift

Kör en aktörsaktivitet och returnerar omedelbart utan att vänta på att körningen ska slutföras. Om du vill vänta tills körningen har slutförts använder du frågeparametern waitForFinish.

Skrapa enstaka URL

Skrapar en enda URL med hjälp av webbskrapaskådespelaren. Den här åtgärden startar en asynkron skrapning och returnerar körningsinformationen omedelbart. Använd utlösaren Aktörskörning slutförd för att bearbeta resultat när skrapet är klart.

Hämta datamängdsobjekt

Hämtar objekt från en av dina Apify-datauppsättningar med valfria sidnumreringsparametrar.

Parametrar

Name Nyckel Obligatorisk Typ Description
Dataset
datasetId True string

Välj den datauppsättning som objekt ska hämtas från.

Limit
limit integer

Maximalt antal objekt som ska returneras.

Offset
offset integer

Antal objekt att hoppa över från början av listan.

Returer

Utdata för den här åtgärden är dynamiska.

Hämta nyckel/värde-arkivpost

Hämtar ett värde som lagras i nyckel/värde-arkivet under en specifik nyckel.

Parametrar

Name Nyckel Obligatorisk Typ Description
Store
storeId True string

Välj det nyckel/värde-arkiv som posten ska hämtas från.

Nyckel
recordKey True string

Välj den nyckel som posten ska hämtas från.

Returer

Utdata för den här åtgärden är dynamiska.

Kör aktör

Kör en aktör och returnerar omedelbart utan att vänta på att körningen ska slutföras. Om du vill vänta tills körningen har slutförts använder du frågeparametern waitForFinish.

Parametrar

Name Nyckel Obligatorisk Typ Description
Välj Aktör från
actorScope True string

Välj den källa som ska sökas efter Aktörer från.

Actor
actorId True string

Aktörsidentifierare som ska köras. Ange aktörs-ID.

Vänta på avslut (0–60 sekunder)
waitForFinish integer

Vänta tills körningen har slutförts i sekunder (0–60).

Tidsgräns (sekunder)
timeout integer

Tidsgräns för körningen i sekunder.

Build
build string

Aktörsversion som ska köras (tagg eller versionsnummer). Vanligtvis är det den "senaste".

Minne (MB)
memory integer

Minnesgräns i MB (effekt 2, min 128).

object

Raw JSON-objekt som skickas som INDATA till aktören.

Kör uppgift

Kör en aktörsaktivitet och returnerar omedelbart utan att vänta på att körningen ska slutföras. Om du vill vänta tills körningen har slutförts använder du frågeparametern waitForFinish.

Parametrar

Name Nyckel Obligatorisk Typ Description
Task
taskId True string

Uppgiftsidentifierare som ska köras.

Vänta på avslut (0–60 sekunder)
waitForFinish integer

Vänta tills körningen har slutförts i sekunder (0–60).

Tidsgräns (sekunder)
timeout integer

Tidsgräns för körningen i sekunder.

Build
build string

Aktörsversion som ska köras (tagg eller versionsnummer). Vanligtvis är det den "senaste".

Minne (MB)
memory integer

Minnesgräns i MB (effekt 2, min 128).

object

Ett rå JSON-objekt som åsidosätter aktivitetens standardindata.

Skrapa enstaka URL

Skrapar en enda URL med hjälp av webbskrapaskådespelaren. Den här åtgärden startar en asynkron skrapning och returnerar körningsinformationen omedelbart. Använd utlösaren Aktörskörning slutförd för att bearbeta resultat när skrapet är klart.

Parametrar

Name Nyckel Obligatorisk Typ Description
URL till Scrape
url True string

Den fullständiga URL:en för den enda sida som ska skrapas. Måste vara ett giltigt URL-format.

Crawlningstyp
crawler_type True string

Välj den crawlningsmotor som ska användas för att skrapa sidan.

Utlösare

Aktörsaktiviteten har slutförts

Skapar en webhook för att prenumerera på aktivitetskörningshändelser för aktör. Utlöses när den valda aktivitetskörningen aktör avslutas med en specifik status. Alla statusar är aktiverade som standard. endast statusar som uttryckligen anges till false undantas. Minst en status måste vara aktiverad.

Aktörskörningen är klar

Skapar en webhook för att prenumerera på aktörskörningshändelser. Utlöses när den valda aktörskörningen avslutas med en specifik status. Alla statusar är aktiverade som standard. endast statusar som uttryckligen anges till false undantas. Minst en status måste vara aktiverad.

Aktörsaktiviteten har slutförts

Skapar en webhook för att prenumerera på aktivitetskörningshändelser för aktör. Utlöses när den valda aktivitetskörningen aktör avslutas med en specifik status. Alla statusar är aktiverade som standard. endast statusar som uttryckligen anges till false undantas. Minst en status måste vara aktiverad.

Parametrar

Name Nyckel Obligatorisk Typ Description
Statusar
eventTypes array of string

Status för aktörskörning som ska utlösas.

Task
actorTaskId True string

Välj den aktörsaktivitet som ska övervakas för händelser.

Utlösaren vid körning lyckades
onRunSucceeded boolean

Utlösare när en aktörskörning lyckas. Standardvärdet är true om det inte anges.

Utlösaren vid körning misslyckades
onRunFailed boolean

Utlösare när en aktörskörning misslyckas. Standardvärdet är true om det inte anges.

Tidsgränsen för utlösare vid körning
onRunTimedOut boolean

Utlösare när tidsgränsen överskrids för en aktör. Standardvärdet är true om det inte anges.

Utlösaren avbröts vid körning
onRunAborted boolean

Utlösare när en aktörskörning avbryts. Standardvärdet är true om det inte anges.

Returer

Händelsenyttolast som skickas av webhook när en aktörskörning är klar.

Webhook nyttolast
WebhookPayloadSchema

Aktörskörningen är klar

Skapar en webhook för att prenumerera på aktörskörningshändelser. Utlöses när den valda aktörskörningen avslutas med en specifik status. Alla statusar är aktiverade som standard. endast statusar som uttryckligen anges till false undantas. Minst en status måste vara aktiverad.

Parametrar

Name Nyckel Obligatorisk Typ Description
Välj Aktör från
actorScope True string

Välj den källa som ska sökas efter Aktörer från.

Statusar
eventTypes array of string

Status för aktörskörning som ska utlösas.

Actor
actorId True string

Aktörsidentifierare som ska övervakas. Ange aktörs-ID.

Utlösaren vid körning lyckades
onRunSucceeded boolean

Utlösare när en aktörskörning lyckas. Standardvärdet är true om det inte anges.

Utlösaren vid körning misslyckades
onRunFailed boolean

Utlösare när en aktörskörning misslyckas. Standardvärdet är true om det inte anges.

Tidsgränsen för utlösare vid körning
onRunTimedOut boolean

Utlösare när tidsgränsen överskrids för en aktör. Standardvärdet är true om det inte anges.

Utlösaren avbröts vid körning
onRunAborted boolean

Utlösare när en aktörskörning avbryts. Standardvärdet är true om det inte anges.

Returer

Händelsenyttolast som skickas av webhook när en aktörskörning är klar.

Webhook nyttolast
WebhookPayloadSchema

Definitioner

ActorRunResponseSchema

Fullständig information om en körd aktörskörning.

Name Sökväg Typ Description
Aktörskörnings-ID
id string

Unik identifierare för aktörskörningen.

Aktörs-ID
actId string

Unik identifierare för aktören som kördes.

Användar-ID
userId string

Unik identifierare för den användare som äger aktörskörningen.

Aktivitets-ID för aktör
actorTaskId string

Unik identifierare för aktörsaktiviteten (om körningen startades från en aktivitet).

Startade på
startedAt date-time

Tidsstämpel när aktörskörningen startade.

Klar vid
finishedAt date-time

Tidsstämpel när aktörskörningen är klar.

Status
status string

Status för aktörskörningen (t.ex. SUCCEEDED, FAILED, RUNNING, ABORTED).

Statusmeddelande
statusMessage string

Detaljerat statusmeddelande från aktörskörningen, inklusive bearbetning av sammanfattning och resultat.

Är statusmeddelandeterminalen
isStatusMessageTerminal boolean

Om statusmeddelandet är terminal (slutligt) eller kan ändras under körningen.

Metadata
meta object

Ytterligare metadata om aktörskörningen, inklusive information om ursprung och användaragent.

Prisinformation
pricingInfo object

Detaljerad prisinformation, inklusive prismodell, händelser och kostnadsuppdelning.

Statistik
stats object

Prestandastatistik, inklusive körning, minnesanvändning, CPU-användning och nätverkstrafik.

Antal debiterade händelser
chargedEventCounts object

Antal fakturerbara händelser som inträffade under aktörskörningen.

Options
options object

Konfigurationsalternativ som används för aktörskörningen (minne, timeout, versionsversion osv.).

Bygg-ID
buildId string

Unik identifierare för aktörsversionen som används för den här körningen.

Slutkod
exitCode number

Slutkod som returneras av aktörsprocessen (0 anger att den lyckades).

Standardlagrings-ID för nyckelvärde
defaultKeyValueStoreId string

Unik identifierare för standardarkivet för nyckel/värde som är associerat med den här körningen.

Standarddatauppsättnings-ID
defaultDatasetId string

Unik identifierare för standarddatauppsättningen där aktören lagrade sina resultat.

Kö-ID för standardbegäran
defaultRequestQueueId string

Unik identifierare för standardbegärandekön som används av aktören.

Byggnummer
buildNumber string

Versionsnummer för den aktörsversion som används för den här körningen.

Container-URL
containerUrl string

URL för containern där aktörskörningen kördes.

Är containerservern klar
isContainerServerReady boolean

Om containerservern är redo och tillgänglig.

Git-grennamn
gitBranchName string

Namnet på Git-grenen som används för den här aktörskörningen (om tillämpligt).

Användningssumma USD
usageTotalUsd number

Total kostnad för aktören körs i USD.

WebhookPayloadSchema

Händelsenyttolast som skickas av webhook när en aktörskörning är klar.

Name Sökväg Typ Description
userId
userId string

ID för den användare som äger resursen som är associerad med händelsen.

createdAt
createdAt date-time

Tidsstämpeln när händelsen inträffade.

eventType
eventType string

Typen av händelse som utlöste webhooken (t.ex. ACTOR. KÖR. LYCKADES).

actorId
eventData.actorId string

ID för den utlösande aktören.

actorRunId
eventData.actorRunId string

ID för den specifika aktörskörningen som utlöste händelsen.

Svar på aktörskörning
resource ActorRunResponseSchema

Fullständig information om en körd aktörskörning.