keyword-research-api

Abort an Actor run that is currently starting or running. For runs with status SUCCEEDED, FAILED, ABORTING, ABORTED, or TIMED-OUT, this call has no effect. The results will include the updated run details after the abort request.

USAGE:

• Use when you need to stop a run that is taking too long or misconfigured.

USAGE EXAMPLES:

• user_input: Abort run y2h7sK3Wc

• user_input: Gracefully abort run y2h7sK3Wc

This tool calls the Actor "gaelasao/keyword-research-api" and retrieves its output results. Actor description: Keyword research tool and API: bulk search volume, AI search volume, CPC, keyword difficulty, search intent and SERP features, plus keyword ideas, related keywords, long tail keywords and competitor keywords. Bing volume on 300+ keywords. Keyword Planner and Semrush alternative. $3 per 1,000.

Get detailed information about a specific Actor run.

Returns run result: status, storages (datasets/keyValueStores alias map), stats, summary, nextStep.

• summary describes the past (e.g. "SUCCEEDED in 22s. 47 items; 3 fields available.").

• nextStep prescribes one primary follow-up action with identifiers interpolated (e.g. "Use get-dataset-items with datasetId=...").

• waitSecs (0–45, default 30) waits up to that many seconds for terminal status before returning.

USAGE:

• Use to check the status of a run started by any Actor-running tool.

• Pass waitSecs > 0 to block until terminal (or until the cap elapses).

USAGE EXAMPLES:

• user_input: Show details of run y2h7sK3Wc

• user_input: Wait for run y2h7sK3Wc to finish

Get items (rows) from a dataset — the output/results produced by an Actor run. Returns the rows themselves, not dataset metadata, counts, or a schema. When the user provides a datasetId and asks to retrieve results, output, data, or rows, call this tool directly. Default limit is 20. Use clean=true to skip empty items and hidden fields.

USAGE:

• Use when you need to read data from a dataset (all items or only selected fields).

USAGE EXAMPLES:

• user_input: Retrieve results from dataset abc123

• user_input: Get only metadata.url and title from dataset username~my-dataset

Get the value stored under a specific key in a key-value store — a single record, not a listing of all keys. Requires the exact key name. The response preserves the original Content-Encoding; most clients handle decompression automatically.

USAGE:

• Use when you need to retrieve a specific record (JSON, text, or binary) from a store.

USAGE EXAMPLES:

• user_input: Get record INPUT from store abc123

• user_input: Get record data.json from store username~my-store