monid run

Execute a data endpoint and retrieve results.

Usage

monid run -p <provider> -e <endpoint> -i <input> [--wait [timeout]] [-o <file>] [--json]

Flags

Flag	Type	Required	Description
-p, --provider <provider>	string	Yes	Provider slug
-e, --endpoint <endpoint>	string	Yes	Endpoint path
-i, --input <input>	string	Yes	Input as inline JSON or @path/to/file.json
-f, --input-file <path>	string	No	Read input from a JSON file (alternative to -i @file)
-w, --wait [timeout]	number	No	Wait for completion. Optional timeout in seconds (default: 300)
-o, --output <path>	string	No	Save output to a file
-j, --json	boolean	No	Output raw JSON

Examples

Run and poll separately (recommended)

monid run -p apify -e /apidojo/tweet-scraper \
  -i '{"searchTerms":["AI"],"maxItems":10}'
# → Run ID: 01HXYZ...

monid runs get -r 01HXYZ... -o tweets.json

Run with wait

monid run -p apify -e /apidojo/tweet-scraper \
  -i '{"searchTerms":["AI"],"maxItems":10}' \
  --wait -o tweets.json

Input from file

monid run -p apify -e /damilo/google-maps-scraper \
  -i @params.json -o results.json

With custom timeout

monid run -p apify -e /apidojo/tweet-scraper \
  -i '{"searchTerms":["AI"],"maxItems":50}' \
  --wait 120 -o tweets.json

Output

If the endpoint completes quickly, the run result is returned immediately. Otherwise, the run starts with status: RUNNING and you poll with monid runs get:

Run started
  Run ID:   01HXYZ...
  Provider: apify
  Endpoint: /apidojo/tweet-scraper
  Status:   RUNNING
  Price:    $0.003/call

Poll with: monid runs get -r 01HXYZ...

With --wait, the CLI polls automatically until the run completes:

Run ID:    01HXYZ...
Status:    COMPLETED
Provider:  apify
Endpoint:  /apidojo/tweet-scraper
Price:     $0.003/call
Cost:      $0.003
Created:   2026-03-28T10:30:00Z
Done:      2026-03-28T10:30:15Z

Results saved to tweets.json

Next Steps

• monid runs -- Check run status and retrieve results
• monid inspect -- Verify input schema before running