Health-check the A-Parser server. Returns "pong" when reachable.

Get A-Parser status: tasks in queue, pid, and the list of available parsers.

List the names of all installed parsers (e.g. "SE::Google", "SE::Google::Suggest").

Describe a parser's result fields. Returns the results schema: arrays (nested lists like serp/ads) and flat (scalar fields like $query, $totalcount) that you can reference in a resultsFormat template. Call this before writing a resultsFormat for add_task.

Get live proxies from the proxy checkers as {"ip:port": ["type", ...]}.

Run a single parse synchronously and return the result immediately. Best for one-off lookups (a suggest query, one SERP, one page). For many queries or saved output files, use add_task instead. raw_results=true -> structured results array (recommended); false -> a single formatted resultString from the preset. options: per-request overrides, each {type:'override', id:'', value:}.

Queue a bulk parsing task. Returns the task id (taskUid). Poll it with task_state / wait_task, then fetch the output with task_results. parsers: stack as a list of [parser_name, preset_name, ...overrideObjects], e.g. [["SE::Google","default"]]. $p1 in a resultsFormat refers to the first entry. results_format: output template, e.g. "$p1.serp.format('$link\n')"; omit to use the preset's own format. results_file_name supports macros like $datefile.format() ($taskId is NOT a valid macro).

Get a task's status and live stats (status, queriesDone, resultsCount, ...).

Poll a task until it completes (or the timeout elapses). Returns the final state.

Get a single-use download URL for a completed task's results file.