apify-sdk-integration

Install the apify-client npm package, create an ApifyClient with your APIFY_TOKEN, then call client.actor('actor-id').call(input) for synchronous runs or .start() with waitForFinish() for long-running Actors. Retrieve results from the run's default dataset.

apify-client is the API client for calling Actors from your application, while apify is the SDK for building Actors themselves. For integration work, always install apify-client; installing apify is the wrong package for this use case.

Install apify-client via pip, create an ApifyClient with your token, and use client.actor('actor-id').call(run_input={...}) for blocking execution. An ApifyClientAsync variant is available for asyncio-based applications.

Yes, use the Apify REST API directly. Send a POST to /v2/actors/{actorId}/runs to start a run, poll /v2/actor-runs/{runId} for status, and GET /v2/datasets/{datasetId}/items to retrieve results, all with Bearer token authentication.

A 401 status code indicates an invalid or missing APIFY_TOKEN. Generate a token at console.apify.com/settings/integrations and store it as an environment variable or in a secrets manager, never hardcoded in source code.

Use .start() instead of .call() to launch the Actor without blocking, then poll with client.run(runId).waitForFinish(). You can also pass timeoutSecs in the Actor input or waitSecs on .call() to avoid indefinite waits.