ACTION_ID: apify_run_actor
NAME: Apify: Run Actor
CATEGORY: Integrations
CREDITS: 1

Run any Apify actor from your Apify account with a JSON input and return
the actor's response. The escape hatch for scraping jobs the catalog
does not cover.

PREREQUISITE: Apify account connection — the user must create it in the Floqer UI
(Connections page); an agent cannot. Without it the action fails the row with
a connection / authentication error. Confirm it exists before configuring.

1. INPUTS

apify_actor (dynamicDropdown, required)
  Apify Actor. The apify actor to pull data from.

input (raw_array, required)
  Input. The input to the actor

2. OUTPUTS

actor_response (raw_array) — Response received from the Actor

3. HOW TO CONFIGURE

Resolve the actor list from the connected Apify account:

  POST .../options/apify_actor   (body: {})

Configure Action body:

{
  "inputs": {
    "apify_actor": "<actor id from options>",
    "input": [
      { "name": "startUrls", "value": "{{input.company_domain}}" },
      { "name": "maxItems", "value": "50" }
    ]
  }
}

Field-by-field:
  - apify_actor  Required. Only actors on the connected account are
                 listed — add the actor to the account in Apify first.
  - input        Required. `[{name, value}]` mapped onto the actor's own
                 input schema. Every value is sent as a string.

4. KEY NOTES

- `input` values are always strings. An actor whose schema expects a
  number, boolean or nested object may reject them — check the actor's
  input schema before wiring it.
- `actor_response` is a `raw_array` whose shape is entirely
  actor-specific. Run one row, read the cell, then parse in a `formula`
  with bracket access.
- The action waits for the actor run to finish. A long-running actor
  will hold the row open and can hit the run timeout — prefer actors
  that complete in seconds per row.
- One Floqer credit per call, on top of whatever the run costs on the
  Apify account itself.

5. WHERE IT FITS IN A WORKFLOW

Pattern: use it where no catalog action fits — apify_run_actor ->
formula (reshape the response) -> raw_to_structured_array ->
push_data_to_sheet to fan the results out.

6. WHEN TO USE

Use apify_run_actor when the data you need is behind a scraper that
already exists on Apify and has no dedicated Floqer action.

7. WHEN NOT TO USE

The target is a plain web page
  -> action-detail/scrape_web_page_using_firecrawl.txt

The target is a REST API
  -> action-detail/http_api_call.txt

Last updated: 2026-08-03.