> ## 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.

Apify is available as an [app + chat connector](/integrations/app-connectors): one shared connection that works in the chat while you build and in your published apps.

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 and clients](/integrations/admin-controls#who-can-create-connections-and-clients).

App + chat connectors are available by default on Free, Pro, and Business plans. On Enterprise plans, they are effectively disabled at first: [Who can create connections and clients](/integrations/admin-controls#who-can-create-connections-and-clients) defaults to **No one** until an admin changes it in **Connectors → Admin settings → App + chat 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 and clients](/integrations/admin-controls#who-can-create-connections-and-clients))

<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 use connections and clients](/integrations/admin-controls#who-can-use-connections-and-clients) 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.

## Manage your {connector_0} connection

Connections are managed from [**Connectors**](https://lovable.dev/dashboard?connectors): select **{connector_0}**, then open the connection.

* **Unlink projects** to remove {connector_0} access from specific projects while keeping the connection available for others. See [Unlink projects from a connection](/integrations/app-connectors#unlink-projects-from-a-connection) for the steps.
* **Delete the connection** to remove it from the workspace entirely. Deleting is permanent. It removes the credentials from all linked projects, and app features that use {connector_0} stop working until a new connection is added. See [Delete a connection](/integrations/app-connectors#delete-a-connection) for the steps and who can delete.