search docs


Configure your actor's input parameters using the Apify Console, locally or via API. Access parameters in key-value stores from your actor's code.

An Apify actor's input is stored in the INPUT.json key-value store in the actor's apify_storage/key_value_stores/default directory.

Note that the actor can store other values such as crawling results or screenshots of web pages under arbitrary keys.

The key-value store associated with an actor run can be conveniently accessed using the getValue() and setValue() functions of Actor class provided by the apify NPM package. Internally, these functions read the ID of the key-value store from the APIFY_DEFAULT_KEY_VALUE_STORE_ID environment variable. They then access the key-value store using the Apify API.

For more details about the key-value stores, visit the Storage section.

Passing input

There are three ways to pass input to an actor:

  • Using the INPUT tab if you are running the actor in Apify Console.
  • By creating or editing the INPUT.json file in the key-value store.
  • Using a POST payload when running the actor using the Apify API.