Run a saved search now
saved_search_runRun a saved search now and return its rows.
Same call over REST
Sourcing search/v1/sourcing/searchNot connected yet? Connect your assistant. Sign in with your MarketCode account; no API key needed.
Reference
What saved_search_run answers
CHARGED AT THE UNDERLYING SEARCH'S PRICE, not at this tool's headline figure: the response's priced_as and credits_charged say what it actually cost. A saved sourcing search bills exactly as the direct call does — there is no discount for saving and no surcharge.
Nothing runs in the background. A saved search spends nothing until you call this. Where the search carries a change-feed cursor, the stored one is used and the new one written back, so consecutive runs answer "what changed since last time" rather than repeating the whole result — tell the user which of the two they are looking at. UK only.
Inputs
Arguments saved_search_run takes
| Name | Type | Required | Description |
|---|---|---|---|
| search_id | string | Yes |
Usage
How to run saved_search_run in your assistant
Ask your assistant in plain English, for example:
"Use the MarketCode tool saved_search_run for <address or area>.
Show the result and the credits charged."The connect steps for Claude, ChatGPT, Codex, Cursor and Claude Code are on the MCP page.
Price and licence
What it costs, and where the data comes from
saved_search_run costs 8 credits per successful call over MCP and over REST, and the two surfaces share one credit balance.
The price covers licensed records in the response. A call that fails is not charged.
Credits are granted on sign-up and bought in packs; the pricing page lists every call.
Related
Tools used with saved_search_run
- Save a named searchFree
saved_search_createSave a named search so it can be re-run later. THIS WRITES: it creates something on the user's account. Say what you are about to save and confirm the name before calling it.Same category - Delete a saved searchFree
saved_search_deleteDelete a saved search. THIS WRITES AND IS IRREVERSIBLE — there is no undo and no archive. Confirm with the user, by NAME rather than by id, before calling it.Same category - List saved searchesFree
saved_search_listEvery saved search on this account, newest first, with each one's tool, stored parameters, run count and change-feed cursor. Free, and read-only.Same category - Rename a saved search or replace its parametersFree
saved_search_updateRename a saved search or replace its parameters. THIS WRITES.Same category
FAQ
Questions about saved_search_run
How much does `saved_search_run` cost?
+
saved_search_run costs 8 credits per successful call over MCP and over REST, and the two surfaces share one credit balance. The price covers licensed records in the response. A call that fails is not charged.
Which assistants can run `saved_search_run`?
+
Any MCP client: Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT in developer mode, Codex and Cursor, each documented on the MCP page. You sign in with your MarketCode account over OAuth; there is no key to paste, and the connection is read-only.
Where does the data come from?
+
The answer is computed by MarketCode. Coverage is the UK.
Can I store or republish the results?
+
The response includes records we license. Use them in your own analysis, reports and products; bulk redistribution of the raw records or building a competing dataset from them is not covered. Ask us if you need a redistribution licence.
Try saved_search_run in your assistant.
30-minute call. We'll connect your assistant live on a real address.