> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lovable.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect your app to Apify

> Connect your app to Apify, a web scraping and automation platform, to run Actors and read datasets from your Lovable app.

export const connector_0 = "Apify"

[Apify](https://apify.com/) is a web scraping and automation platform for running Actors, managing Actor runs, and reading structured results from datasets and storage. The Apify connector lets your Lovable app call the Apify API through a managed workspace connection so you can scrape sites, automate browser workflows, and surface crawl results in your product.

With Apify, your app can:

* Run Actors to scrape websites and automate browser workflows
* Poll Actor run status and retrieve logs when jobs finish
* Read structured results from datasets and key-value stores
* List and manage Actors, runs, and storage in your Apify account

Apify is a good fit when your app needs scrapers, scheduled crawls, or dataset-backed views powered by Actors you already run on Apify.

## Common use cases and example apps

| Example app                         | Example prompt                                                                                          | Description                                                                                                                                                |
| :---------------------------------- | :------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Competitor price tracker**        | *Use Apify and build a dashboard that runs a price-scrape Actor and shows the latest results.*          | **Keep competitor prices visible in one place.**<br />The app starts an Actor run, waits for completion, and displays dataset items in a table.            |
| **Lead list builder**               | *Use Apify and build a tool that scrapes company directory pages and saves contacts to a list.*         | **Turn public directory pages into structured leads.**<br />The app runs an Actor with the target URLs and stores the returned dataset rows for follow-up. |
| **Content monitoring feed**         | *Use Apify and build a feed that re-runs a news scrape Actor on a schedule and shows new articles.*     | **Surface fresh scraped content without manual runs.**<br />The app triggers Actor runs on a schedule, reads the dataset, and highlights new items.        |
| **E-commerce product catalog sync** | *Use Apify and build an admin page that lists products from our Apify dataset after a catalog scrape.*  | **Browse scraped catalog data inside your app.**<br />The app reads dataset items with pagination and shows product fields operators can review.           |
| **Actor run status console**        | *Use Apify and build a console that lists recent Actor runs with status, duration, and dataset links.*  | **Monitor scrape jobs without leaving Lovable.**<br />The app lists runs from your Apify account and links each successful run to its dataset.             |
| **Research assistant**              | *Use Apify and build a research page that runs a website crawl Actor and summarizes the scraped pages.* | **Combine crawl output with in-app analysis.**<br />The app runs an Actor, reads the dataset, and presents a summarized view of the scraped content.       |

## How to connect Apify

Who can create Apify connections depends on your plan and workspace settings. See [Who can create connections](/integrations/introduction#who-can-create-connections).

App connectors are enabled by default on Free, Pro, and Business plans. On Enterprise plans, they are disabled by default until a workspace admin or owner enables them in **Connectors → Admin settings → App connectors**.

You can create multiple Apify connections using different API tokens, which is useful for separating environments (for example, development and production) or managing usage limits.

When the connection is created, you can link it to the projects where you want to use it. Anyone building in a project can ask Lovable in chat to link their project to it.

### Prerequisites

Before connecting Apify, make sure you have:

* An Apify account
* An Apify API token
* Permission to **create connections** in your Lovable workspace (see [Who can create connections](/integrations/introduction#who-can-create-connections))

<Note>
  All Actor runs and API usage through this connector count toward your Apify plan. Billing and quota are handled directly by Apify, not Lovable.
</Note>

### Step 1: Get an Apify API token

An Apify API token lets your Lovable app authenticate with the Apify API.

To create an Apify API token:

<Steps>
  <Step title="Open your Apify account">
    Sign in to the [Apify Console](https://console.apify.com/).
  </Step>

  <Step title="Open API and Integrations">
    Go to **Settings → API & Integrations**.
  </Step>

  <Step title="Create a token">
    Create a new API token and give it a descriptive name, for example `Lovable integration`.
  </Step>

  <Step title="Copy the token">
    Copy the token and store it securely. Newer tokens often start with `apify_api_`. Older tokens may look different.
  </Step>
</Steps>

<Warning>
  Your API token functions like a password. Keep it secure and never share it publicly. You'll need it in the next step.
</Warning>

See Apify documentation for more: [Getting started with the Apify API](https://docs.apify.com/api/v2/getting-started).

### Step 2: Connect Apify to Lovable

You can create multiple connections using different API tokens.

<Steps>
  <Step title="Open Apify in Connectors">
    Open **Connectors** and select **Apify**.
  </Step>

  <Step title="Add a connection">
    Click **Add connection**.
  </Step>

  <Step title="Configure the connection">
    1. **Display name**: name the connection, for example `Apify Prod`. This name is only used inside Lovable to identify the connection.
    2. **API token**: paste your Apify API token.
  </Step>

  <Step title="Choose who can use this connection">
    Under **Who can use this connection**, decide who in your workspace can use the connection. You start as the only person with access:

    * **Only you** (default): leave the access list as is; only you can use the connection and its associated data.
    * **Invite specific people**: add workspace members by email; only you and the people you add can use the connection and its associated data.
    * **Invite entire workspace**: click **Invite entire workspace** to make the connection available to everyone in your Lovable workspace.

    See [Who can manage connections](/integrations/introduction#who-can-manage-connections) for more information.
  </Step>

  <Step title="Connect">
    Click **Connect**.
  </Step>
</Steps>

When connected, anyone building in a project can ask Lovable in chat to link their project to Apify (based on configured connection-level access). Your Lovable apps can then run Actors and read datasets through Apify.

## Limitations

The Apify connector cannot:

* Call the Apify API from client-side browser code. Calls go through Lovable from a server-side endpoint.
* Refresh or rotate API tokens automatically. To rotate, create a new token in Apify and update the Lovable connection.
* Support per-end-user Apify login. Each connection represents a single Apify account shared across all projects linked to it.

Apify enforces rate limits on its API. If you poll Actor runs or re-fetch datasets frequently, expect occasional `429` responses and add retry-with-backoff in your server code.

If a request fails because the API token has been revoked or rotated in Apify, generate a new token and update the Lovable connection.

## How to unlink projects from a {connector_0} connection

Editors and above can remove specific projects from a connection without deleting the connection entirely. The connection will remain available for other projects.

To unlink projects:

<Steps>
  <Step title="Open Connectors">
    Open **Connectors** and select **{connector_0}**.
  </Step>

  <Step title="Open the connection">
    Open the connection you want to manage.
  </Step>

  <Step title="Select projects">
    Under **Linked projects**, check the projects you want to unlink.
  </Step>

  <Step title="Confirm">
    Click **Unlink projects** and confirm.
  </Step>
</Steps>

When unlinked, those projects will no longer have access to {connector_0} through this connection. If a project needs {connector_0} again, you can link it to any available connection.

## How to delete a {connector_0} connection

Workspace admins and owners can delete {connector_0} connections. Other members can delete a connection if they created it, or if they have been explicitly granted access to it.

<Warning>
  Deleting a connection is permanent and cannot be undone. It will remove the credentials from all linked projects, and any apps using this connection will stop working until a new connection is added.
</Warning>

Before deleting, review the **Linked projects** section to see which projects are currently using the connection.

To delete a connection:

<Steps>
  <Step title="Open Connectors">
    Open **Connectors** and select **{connector_0}**.
  </Step>

  <Step title="Open the connection">
    Open the connection you want to remove.
  </Step>

  <Step title="Review linked projects">
    Review the **Linked projects** section.
  </Step>

  <Step title="Delete">
    Under **Delete this connection**, click **Delete** and confirm.
  </Step>
</Steps>