🔎 Apify Run Input Search (Apify Actor)

This Apify Actor searches through an Actor’s historical run inputs and finds runs containing a specific keyword, phrase, URL, or partial text match.

The Actor scans all available runs, loads each run’s INPUT record from its Key-Value Store, and performs a case-insensitive text search against the full JSON input.

Results are exported into an Apify Dataset for easy filtering, analysis, or debugging.

---

🚀 How It Works

The Actor:

1. Fetches all runs from a target Actor
2. Extracts each run’s Key-Value Store ID
3. Loads the INPUT record from every run
4. Converts the input JSON into searchable text
5. Searches for a user-provided term
6. Stores matching runs in the Dataset

---

🧠 Use Cases

• Find runs containing a specific URL
• Locate runs by keyword or product name
• Search historical automation inputs
• Recover lost run configurations
• Audit old Actor runs
• Investigate customer executions
• Debug large-scale automation workflows

---

📥 Input Options

🔑 actorId

The Actor ID whose runs should be searched.

• Type: string
• Required: yes

"actorId": "nwua9Gu5YrADL7ZDj"

---

🔍 searchTerm

Text to search for inside run inputs.

Supports:

• URLs
• partial strings
• keywords
• JSON fragments
• usernames
• arbitrary text

Search is:

• case-insensitive

• partial-match based

• Type: string

• Required: yes

"searchTerm": "kitchenaid"

"searchTerm": "https://www.ebay.com/usr/kitchenaid"

---

🔐 apiToken

Optional custom Apify API token.

If omitted, the Actor automatically uses its own execution token.

Useful when:

• searching another account’s runs

• accessing private Actors

• cross-account debugging

• Type: string

• Optional

• Hidden securely in Actor input UI

"apiToken": "apify_api_xxxxxxxxx"

---

🛑 stopIfMatchFound

Controls whether the Actor stops after finding the first match.

true

• Stops early
• Faster execution
• Lower API usage

false

• Processes all runs

• Finds every possible match

• Pushes all matches to dataset

• Type: boolean

• Default: true

"stopIfMatchFound": false

---

⚡ concurrency

Number of runs processed simultaneously.

Higher values:

• increase speed
• increase API request volume

Recommended:

• 10-100 for most cases

• 100-500+ for aggressive searching

• Type: integer

• Default: 50

"concurrency": 100

---

📥 Full Input Example

{
  "actorId": "nwua9Gu5YrADL7ZDj",
  "searchTerm": "kitchenaid",
  "apiToken": "",
  "stopIfMatchFound": false,
  "concurrency": 100
}

---

📤 Output

Each dataset item represents one matching run input.

---

Output Fields

Field	Type	Description
runId	string	Apify Run ID
storeId	string	Key-Value Store ID associated with the run
matchedTerm	string	Search term used
matched	boolean	Indicates successful match
inputPreview	string	Truncated preview of input JSON
input	object	Full original INPUT payload

---

📤 Output Example

{
  "runId": "3KH8s2a9LmP4xQvWc",
  "storeId": "Jt9mKz1vQaY2LpNs",
  "matchedTerm": "kitchenaid",
  "matched": true,
  "inputPreview": "{\"startUrls\":[{\"url\":\"https://www.ebay.com/usr/kitchenaid\"}]}",
  "input": {
    "startUrls": [
      {
        "url": "https://www.ebay.com/usr/kitchenaid"
      }
    ]
  }
}

---

📊 Dataset Views

The Actor includes multiple Dataset views:

View	Description
Overview 🔎	General match overview
Matches 🎯	Match-focused output
Input Data 📦	Full input payloads
Store IDs 🆔	IDs only

---

⚠️ Notes

• The Actor searches only the INPUT record of each run
• Search uses JSON.stringify(input).includes(...)
• Matching is case-insensitive
• Extremely large Actors may take significant time to process
• Private Actors require a valid API token with access

---

⚠️ Legal Disclaimer

This Actor is not affiliated with or endorsed by Apify.

Users are responsible for:

• complying with Apify Terms of Service
• respecting account permissions
• ensuring authorized access to searched Actors