Accessing Apify API

The Apify SDK contains many useful features for making Actor development easier. However, it does not cover all the features the Apify API offers.

For working with the Apify API directly, you can use the provided instance of the Apify API Client library.

Actor client

To access the provided instance of ApifyClientAsync, you can use the Actor.apify_client property.

For example, to get the details of your user, you can use this snippet:

from apify import Actor


async def main() -> None:
    async with Actor:
        # Create a new user client.
        user_client = Actor.apify_client.user('me')

        # Get information about the current user.
        me = await user_client.get()
        Actor.log.info(f'User: {me}')

Actor new client

If you want to create a completely new instance of the client, for example, to get a client for a different user or change the configuration of the client,you can use the Actor.new_client method:

from apify import Actor

TOKEN = 'ANOTHER_USERS_TOKEN'


async def main() -> None:
    async with Actor:
        # Create a new user client with a custom token.
        apify_client = Actor.new_client(token=TOKEN, max_retries=2)
        user_client = apify_client.user('me')

        # Get information about the another user.
        them = await user_client.get()
        Actor.log.info(f'Another user: {them}')