ApifyClient

The official JavaScript client for the Apify API.

Provides programmatic access to all Apify platform resources including Actors, runs, datasets, key-value stores, request queues, and more. Works in both Node.js and browser environments.

@example

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'my-token' });

// Start an Actor and wait for it to finish
const run = await client.actor('my-actor-id').call();

// Fetch dataset items
const { items } = await client.dataset(run.defaultDatasetId).listItems();

@see

https://docs.apify.com/api/v2

Index

Constructors

• constructor

Properties

• baseUrl
• httpClient
• logger
• publicBaseUrl
• stats
• token

Methods

• actor
• actors
• build
• builds
• dataset
• datasets
• keyValueStore
• keyValueStores
• log
• requestQueue
• requestQueues
• run
• runs
• schedule
• schedules
• setStatusMessage
• store
• task
• tasks
• user
• webhook
• webhookDispatch
• webhookDispatches
• webhooks

Constructors

constructor

• new ApifyClient(options): ApifyClient

• Parameters

  • options: ApifyClientOptions = {}

  Returns ApifyClient

Properties

baseUrl

baseUrl: string

httpClient

httpClient: HttpClient

logger

logger: Log

publicBaseUrl

publicBaseUrl: string

stats

stats: Statistics

optionaltoken

token?: string

Methods

actor

• actor(id): ActorClient

• Returns a client for a specific Actor.

  Use this to get, update, delete, start, or call an Actor, as well as manage its builds, runs, versions, and webhooks.

  @see

  https://docs.apify.com/api/v2/act-get

  @example

  // Call an Actor and wait for it to finish
  const run = await client.actor('apify/web-scraper').call({ url: 'https://example.com' });

  ---

  Parameters

  • id: string

    Actor ID or username/name

  Returns ActorClient

  A client for the specific Actor

actors

• actors(): ActorCollectionClient

• Returns a client for managing Actors in your account.

  Provides access to the Actor collection, allowing you to list, create, and search for Actors.

  @see

  https://docs.apify.com/api/v2/acts-get

  ---

  Returns ActorCollectionClient

  A client for the Actors collection

build

• build(id): BuildClient

• Returns a client for a specific Actor build.

  Use this to get details about a build, wait for it to finish, or access its logs.

  @see

  https://docs.apify.com/api/v2/actor-build-get

  ---

  Parameters

  • id: string

    Build ID

  Returns BuildClient

  A client for the specified build

builds

• builds(): BuildCollectionClient

• Returns a client for managing Actor builds in your account.

  Lists all builds across all of your Actors.

  @see

  https://docs.apify.com/api/v2/actor-builds-get

  ---

  Returns BuildCollectionClient

  A client for Actor builds collection

dataset

• dataset<Data>(id): DatasetClient<Data>

• Returns a client for a specific dataset.

  Use this to read, write, and manage items in the dataset. Datasets contain structured data stored as individual items (records).

  @see

  https://docs.apify.com/api/v2/dataset-get

  @example

  // Push items to a dataset
  await client.dataset('my-dataset').pushItems([
    { url: 'https://example.com', title: 'Example' },
    { url: 'https://test.com', title: 'Test' }
  ]);
  
  // Retrieve items
  const { items } = await client.dataset('my-dataset').listItems();

  ---

  Parameters

  • id: string

    Dataset ID or name

  Returns DatasetClient<Data>

  A client for the specific Dataset

datasets

• datasets(): DatasetCollectionClient

• Returns a client for managing datasets in your account.

  Datasets store structured data results from Actor runs. Use this to list or create datasets.

  @see

  https://docs.apify.com/api/v2/datasets-get

  ---

  Returns DatasetCollectionClient

  A client for the Datasets collection

keyValueStore

• keyValueStore(id): KeyValueStoreClient

• Returns a client for a specific key-value store.

  Use this to read, write, and delete records in the store. Key-value stores can hold any type of data including text, JSON, images, and other files.

  @see

  https://docs.apify.com/api/v2/key-value-store-get

  @example

  // Save a record
  await client.keyValueStore('my-store').setRecord({ key: 'OUTPUT', value: { foo: 'bar' } });
  
  // Get a record
  const record = await client.keyValueStore('my-store').getRecord('OUTPUT');

  ---

  Parameters

  • id: string

    Key-value store ID or name

  Returns KeyValueStoreClient

  A client for the specific key-value store

keyValueStores

• keyValueStores(): KeyValueStoreCollectionClient

• Returns a client for managing key-value stores in your account.

  Key-value stores are used to store arbitrary data records or files.

  @see

  https://docs.apify.com/api/v2/key-value-stores-get

  ---

  Returns KeyValueStoreCollectionClient

  A client for the Key-value stores collection

log

• log(buildOrRunId): LogClient

• Returns a client for accessing logs of an Actor build or run.

  @see

  https://docs.apify.com/api/v2/log-get

  ---

  Parameters

  • buildOrRunId: string

    Build ID or run ID

  Returns LogClient

  A client for accessing logs

requestQueue

• requestQueue(id, options): RequestQueueClient

• Returns a client for a specific request queue.

  Use this to add, retrieve, and manage requests in the queue. Request queues are used by web crawlers to manage URLs that need to be visited.

  @see

  https://docs.apify.com/api/v2/request-queue-get

  @example

  // Add requests to a queue
  const queue = client.requestQueue('my-queue');
  await queue.addRequest({ url: 'https://example.com', uniqueKey: 'example' });
  
  // Get and lock the next request
  const { items } = await queue.listAndLockHead({ lockSecs: 60 });

  ---

  Parameters

  • id: string

    Request queue ID or name

  • options: RequestQueueUserOptions = {}

    Configuration options for the request queue client

  Returns RequestQueueClient

  A client for the specific Request queue

requestQueues

• requestQueues(): RequestQueueCollectionClient

• Returns a client for managing request queues in your account.

  Request queues store URLs to be crawled, along with their metadata.

  @see

  https://docs.apify.com/api/v2/request-queues-get

  ---

  Returns RequestQueueCollectionClient

  A client for the Request queues collection

run

• run(id): RunClient

• Returns a client for a specific Actor run.

  Use this to get details about a run, wait for it to finish, abort it, or access its dataset, key-value store, and request queue.

  @see

  https://docs.apify.com/api/v2/actor-run-get

  @example

  // Wait for a run to finish
  const run = await client.run('run-id').waitForFinish();
  
  // Access run's dataset
  const { items } = await client.run('run-id').dataset().listItems();

  ---

  Parameters

  • id: string

    Run ID

  Returns RunClient

  A client for the specified run

runs

• runs(): RunCollectionClient

• Returns a client for managing Actor runs in your account.

  Lists all runs across all of your Actors.

  @see

  https://docs.apify.com/api/v2/actor-runs-get

  ---

  Returns RunCollectionClient

  A client for the run collection

schedule

• schedule(id): ScheduleClient

• Returns a client for a specific schedule.

  Use this to get, update, or delete a schedule.

  @see

  https://docs.apify.com/api/v2/schedule-get

  ---

  Parameters

  • id: string

    Schedule ID

  Returns ScheduleClient

  A client for the specific Schedule

schedules

• schedules(): ScheduleCollectionClient

• Returns a client for managing schedules in your account.

  Schedules automatically start Actor or task runs at specified times.

  @see

  https://docs.apify.com/api/v2/schedules-get

  ---

  Returns ScheduleCollectionClient

  A client for the Schedules collection

setStatusMessage

• setStatusMessage(message, options): Promise<void>

• Sets a status message for the current Actor run.

  This is a convenience method that updates the status message of the run specified by the ACTOR_RUN_ID environment variable. Only works when called from within an Actor run.

  @throws

  If ACTOR_RUN_ID environment variable is not set

  ---

  Parameters

  • message: string

    The status message to set

  • optionaloptions: SetStatusMessageOptions

    Additional options for the status message

  Returns Promise<void>

store

• store(): StoreCollectionClient

• Returns a client for browsing Actors in Apify Store.

  Use this to search and retrieve information about public Actors.

  @see

  https://docs.apify.com/api/v2/store-actors-get

  ---

  Returns StoreCollectionClient

  A client for the Apify Store

task

• task(id): TaskClient

• Returns a client for a specific Actor task.

  Use this to get, update, delete, or run a task with pre-configured input.

  @see

  https://docs.apify.com/api/v2/actor-task-get

  @example

  // Run a task and wait for it to finish
  const run = await client.task('my-task').call();

  ---

  Parameters

  • id: string

    Task ID or username/task-name

  Returns TaskClient

  A client for the specified task

tasks

• tasks(): TaskCollectionClient

• Returns a client for managing Actor tasks in your account.

  Tasks are pre-configured Actor runs with stored input that can be executed repeatedly.

  @see

  https://docs.apify.com/api/v2/actor-tasks-get

  ---

  Returns TaskCollectionClient

  A client for the task collection

user

• user(id): UserClient

• Returns a client for accessing user data.

  By default, returns information about the current user (determined by the API token).

  @see

  https://docs.apify.com/api/v2/user-get

  ---

  Parameters

  • id: string = ME_USER_NAME_PLACEHOLDER

    User ID or username. Defaults to 'me' (current user)

  Returns UserClient

  A client for the user

webhook

• webhook(id): WebhookClient

• Returns a client for a specific webhook.

  Use this to get, update, delete, or test a webhook.

  @see

  https://docs.apify.com/api/v2/webhook-get

  ---

  Parameters

  • id: string

    Webhook ID

  Returns WebhookClient

  A client for the specific webhook

webhookDispatch

• webhookDispatch(id): WebhookDispatchClient

• Returns a client for a specific webhook dispatch.

  @see

  https://docs.apify.com/api/v2/webhook-dispatch-get

  ---

  Parameters

  • id: string

    Webhook dispatch ID

  Returns WebhookDispatchClient

  A client for the specific webhook dispatch

webhookDispatches

• webhookDispatches(): WebhookDispatchCollectionClient

• Returns a client for viewing webhook dispatches in your account.

  Webhook dispatches represent individual invocations of webhooks.

  @see

  https://docs.apify.com/api/v2/webhook-dispatches-get

  ---

  Returns WebhookDispatchCollectionClient

  A client for the webhook dispatches collection

webhooks

• webhooks(): WebhookCollectionClient

• Returns a client for managing webhooks in your account.

  Webhooks notify external services when specific events occur (e.g., Actor run finishes).

  @see

  https://docs.apify.com/api/v2/webhooks-get

  ---

  Returns WebhookCollectionClient

  A client for the Webhooks collection