Skip to main content
Botster logo
  • Category: ai web scraping
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 11
  • Triggers: 0
  • Slug: BOTSTER
  • Version: 20261030_00

Tools

Slug: BOTSTER_CALCULATE_BOT_COSTCalculate the credit price of one intended bot launch using the same input and bot-specific options, without launching the bot or spending credits.

Input Parameters

string
required
Main bot input exactly as intended for launch; Botster accepts a string or an array of strings depending on the bot.
object
Bot-specific option key/value pairs sent at the top level beside input, such as {“limit”: 1}; names and value shapes vary by bot.
string
required
Bot identifier returned by LIST_BOTS, for example ‘google-local-finder’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTSTER_DELETE_JOBPermanently delete one Botster job. This destructive action cannot be undone, is not the same as archiving, and may remove access to the job’s run history.

Input Parameters

string
required
Identifier of the job to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTSTER_DELETE_RUNPermanently delete one Botster data run and its stored results without deleting the entire job. This destructive operation cannot be undone.

Input Parameters

string
required
Identifier of the data run to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTSTER_GET_CREDITSReturn the connected Botster account’s available credit balance; use this before launching or restarting credit-consuming work.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTSTER_GET_JOBGet one job’s status and data-run identifiers required to retrieve run results. The complete provider job object is returned without discarding bot-specific fields.

Input Parameters

string
required
Job identifier returned by LAUNCH_BOT or LIST_JOBS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTSTER_GET_RUN_RESULTSReturn the complete bot-specific JSON for one data run identified from GET_JOB in the results field. The provider’s result shape is preserved.

Input Parameters

string
required
Data-run identifier obtained from the job returned by GET_JOB.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTSTER_LAUNCH_BOTLaunch a Botster bot, creating external work that may spend account credits. Use CALCULATE_BOT_COST with the same input and options first when cost matters. Returns launch metadata and normalizes an identifiable job identifier to job_id.

Input Parameters

string
required
Main bot input. The selected bot may require a string or an array of strings.
object
Bot-specific option key/value pairs flattened into the launch body. Use the same options with CALCULATE_BOT_COST first because required fields vary by bot.
string
HTTPS callback URL that should receive a JSON POST when the job completes.
string
required
Bot identifier returned by LIST_BOTS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTSTER_LIST_BOTSList or search bots available to the connected account and return their identifiers for cost calculation and launch.

Input Parameters

integer
Number of bots requested for this page. Botster documents 50 but does not publish an upper bound.
Text to match against available bots.
string
Opaque continuation cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTSTER_LIST_JOBSList jobs belonging to the connected Botster account and return job identifiers for inspection or lifecycle actions.

Input Parameters

integer
Number of jobs requested for this page; Botster documents 50 but does not publish a maximum.
string
Opaque continuation cursor from a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTSTER_RESTART_JOBRestart an existing Botster job, creating renewed external work that may repeat the bot’s effects and spend additional account credits. The renewed job identity may differ from the original; returns all provider restart metadata.

Input Parameters

string
required
Identifier of the job to restart.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BOTSTER_SET_JOB_ARCHIVEDArchive a Botster job or restore it from the archive by setting its desired archived state. This reversible action changes organization state but does not delete the job.

Input Parameters

string
required
Identifier of the job whose archive state should change.
boolean
required
Set true to archive the job or false to restore it from the archive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not