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

# Connect lobstr.io to Make and automate your scraping workflows

> Use the official lobstr.io app in Make to launch runs, watch for completed runs, and push scraped results into any of the thousands of apps Make connects to.

lobstr.io has an **official app in Make**. Once connected, you can launch runs from a Make scenario, wait for a run to finish, and pipe the results straight into a CRM, a spreadsheet, a database, Slack, or anything else Make supports — without writing code.

## Before you start

* A [lobstr.io account](https://app.lobstr.io) with credits.
* A Make account.
* Your lobstr.io **API key**, which is what the connection authenticates with.

Your API key lives in the dashboard under the **API** menu — click **Copy** to grab it.

<Frame>
  <img src="https://mintcdn.com/lobstrio-8dcae32c/lanZnXBNnxHNeAbm/images/integrations/get_api_key.png?fit=max&auto=format&n=lanZnXBNnxHNeAbm&q=85&s=24927a4ac6175233505fd09f6d49ae85" alt="Copy your lobstr.io API key from the API menu in the dashboard" width="1443" height="620" data-path="images/integrations/get_api_key.png" />
</Frame>

<Note>
  See [how to find your API key](/getting-started/api-key) for more detail, including how to rotate it.
</Note>

## Create the connection

<Steps>
  <Step title="Add a lobstr.io module">
    In your Make scenario, click the **+** button and search for **lobstr.io**. The app appears as **LOBSTR.IO** in Make's interface. Pick any module — the connection is shared across all of them.
  </Step>

  <Step title="Create a connection">
    In the module settings, click **Add** next to the **Connection** field.
  </Step>

  <Step title="Paste your API key">
    Give the connection a name, paste your lobstr.io API key into the **API Key** field, and click **Save**.

    <Frame>
      <img src="https://mintcdn.com/lobstrio-8dcae32c/lanZnXBNnxHNeAbm/images/integrations/make/create-connection.png?fit=max&auto=format&n=lanZnXBNnxHNeAbm&q=85&s=6adcf9b39096f0ff7fbccb420492df16" alt="Create a LOBSTR.IO connection in Make by pasting your API key" width="1809" height="897" data-path="images/integrations/make/create-connection.png" />
    </Frame>
  </Step>
</Steps>

Make verifies the key immediately. Once saved, every lobstr.io module in your account can reuse the same connection.

<Warning>
  Your API key grants full access to your lobstr.io account. Treat it like a password — never paste it into a shared scenario description or a public template.
</Warning>

## What the lobstr.io app can do

| Module               | Type    | What it does                                                                                  |
| -------------------- | ------- | --------------------------------------------------------------------------------------------- |
| **Watch Runs**       | Trigger | Triggers when a run is finished, failed, or has changed status                                |
| **Launch a Run**     | Action  | Launches a new run for a selected Squid                                                       |
| **Get a Squid**      | Search  | Retrieves details of a specific Squid, including its name, crawler, and parameters            |
| **List Squids**      | Search  | Lists your saved Squids, with pagination                                                      |
| **List Runs**        | Search  | Lists all runs for a specific Squid                                                           |
| **List Results**     | Search  | Returns structured results from a run or a Squid, with pagination and optional task filtering |
| **Make an API call** | Other   | Performs a custom API request — you specify the method, path, and optional JSON body          |

<Tip>
  **Make an API call** is the escape hatch. If you need something the dedicated modules don't cover — adding tasks, aborting a run, changing Squid settings — use it with the endpoint path and a JSON body.
</Tip>

## Two scenarios worth building

### Push results somewhere the moment a run finishes

This is the most common setup, and it replaces the download-and-import loop entirely. Here's the whole loop end to end:

<iframe width="100%" height="420" src="https://www.loom.com/embed/a3474175141745fbb4883bd408969af9" frameborder="0" allowfullscreen />

<Steps>
  <Step title="Add the Watch Runs trigger">
    Start the scenario with **Watch Runs**. Click **Add** to create a webhook: name it, pick your connection, and enter the **Squid ID** of the Squid you want to watch.

    Then toggle the events you care about — **Run Done** on its own is what most scenarios want. You can also enable **retry**, which reattempts failed deliveries up to 3 times.

    <Tip>
      The Squid ID is typed in, not picked from a list. It's the hash in the Squid's dashboard URL.
    </Tip>
  </Step>

  <Step title="Copy the webhook URL">
    Once saved, the module shows a **Webhook URL** that starts with `https://hook.` — click the copy button beside it.

    <Frame>
      <img src="https://mintcdn.com/lobstrio-8dcae32c/lanZnXBNnxHNeAbm/images/integrations/make/watch-run.png?fit=max&auto=format&n=lanZnXBNnxHNeAbm&q=85&s=fb9b8e125f918fdd30cdc74c30db6dce" alt="The Watch Runs module showing the generated Make webhook URL with a copy button" width="1007" height="551" data-path="images/integrations/make/watch-run.png" />
    </Frame>
  </Step>

  <Step title="Add the webhook URL to your Squid">
    Go to your Squid in lobstr.io, open the **Delivery** panel, expand the **Webhook** section, and paste the URL in. Tick the checkbox to activate it and click **Save**.

    <Warning>
      This step is manual and easy to miss. Creating the webhook in Make does **not** configure delivery on your Squid — until you paste that URL into the Delivery panel and save, the scenario will never fire.
    </Warning>
  </Step>

  <Step title="Fetch the rows">
    Add **List Results** and map the run ID from the trigger into it. This returns the rows from that run only.
  </Step>

  <Step title="Send the data on">
    Add whatever destination you need — a CRM record, a Google Sheets row, an Airtable record, a Slack message. Map the lobstr.io fields onto the destination's fields.
  </Step>
</Steps>

<Note>
  If all you want is the data in a spreadsheet, you don't need Make at all — lobstr.io can [export to Google Sheets](/integrations/google-sheets) or [Amazon S3](/integrations/amazon-s3) by itself. Reach for Make when the data needs shaping, filtering, or routing to more than one place.
</Note>

### Launch a scrape when something happens elsewhere

<Steps>
  <Step title="Trigger on your own event">
    Start with any Make trigger — a new row in a sheet, a new form submission, a webhook, a schedule.
  </Step>

  <Step title="Launch the run">
    Add **Launch a Run** and pick the Squid to start.
  </Step>
</Steps>

<Warning>
  **Launch a Run** spends credits, and a Make scenario can fire far more often than you'd click Launch by hand. Put a filter before the module, or use a Squid whose task list is small, so a runaway trigger doesn't drain your balance.
</Warning>

## Things to know

* **Runs launched from Make are ordinary runs.** They show up in your dashboard, count against your [slots](/core-concepts/slots), and draw down the same [credit](/core-concepts/credits) balance.
* **Every run re-processes every task** in the Squid's list. Make doesn't change that — if you want a run to scrape only new inputs, empty the task list and add fresh [tasks](/core-concepts/tasks) before launching.
* **Results are paginated.** For a large run, let Make iterate through the pages rather than expecting one bundle.
* **Results expire.** Run results are stored for 28 days on paid plans and 7 days on the free plan, so fetch them before that.
