Run a live data source (billed)
live_dataRuns a named live data source with supplied inputs to return structured records scraped for the request; use extract when no source covers the page.
Instructions
Run a live data source and get structured records, scraped for this call. Seconds, up to minutes; bills one run at the vendor's rate. Pass the provider live_data_sources named (optional with one vendor configured); inputs come from live_data_source. For a page no source covers use extract. A failed run is an error, never an empty answer. NOTHING IS CONFIGURED FOR THIS METHOD on this machine, so every call will fail. A key in one of APIFY_TOKEN, BRIGHTDATA_API_TOKEN, NIMBLE_API_KEY, OXYLABS_WEB_API_KEY turns it on: see load_env.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"source": "<source>"
},
"name": "live_data"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| inputs | No | Named by the source's input_schema, from `live_data_source`. | |
| source | Yes | The source's name, as `live_data_sources` lists it. |