App Logo
search.brave.com

Submit URL to Brave

Submit one URL to Brave Search to be re-crawled, and return the outcome Brave gave: whether it was accepted, plus Brave's own heading and message. Acceptance means Brave took the submission — not that the page was crawled, indexed or ranked. An invalid URL comes back as a rejection with Brave's message rather than as an error. Brave sometimes shows a rate-limit challenge here; if it does, the script raises an error — wait 30-60 seconds before retrying.

Input

url required

The absolute URL to submit for re-fetching, e.g. 'https://reduck.ai/pricing'. Brave validates it and rejects anything it doesn't parse as a URL (returned as accepted:false, not an error). One URL per call — the form takes exactly one.

Output

url required

The URL that was submitted, echoed back from the args.

detail required

The panel's explanatory line, verbatim ('Thank you for your submission.' / 'Please insert a valid URL.'). This is where Brave states WHY a submission was rejected. null when the panel has no detail row — kept nullable because only the success and invalid-URL variants have been observed.

heading required

The outcome panel's heading, verbatim as rendered ('Success' / 'Error'). Localized by Brave, so branch on `accepted` instead. Required and non-empty on purpose: Brave shows a 'Verifying you're a human being' step in the SAME panel before deciding, and that intermediate state has no heading — so a missing one means the script read the panel before the verdict existed, which must fail loudly rather than validate as a successful submission.

accepted required

Whether Brave accepted the submission: true = the success panel, false = the error panel (e.g. a malformed URL). Read off the panel's own `error` class, not its wording, so it survives localization. Acceptance is a queued re-fetch request only — it carries no promise that the page gets crawled, indexed or ranked.

Related scripts

search.brave.com

Brave search

Search the web on Brave, one page of results at a time. Returns each result's title, url, snippet and date, plus the query it actually ran. An empty result list always means Brave itself reported nothing for the query, and the reason is returned alongside it — the script raises an error rather than quietly returning nothing when the page cannot be read, so an empty answer can be trusted as a fact about the query. Search operators (site:, quoted phrases, OR) are honored. site:domain also covers subdomains, and site:domain/path narrows to a path prefix. When too few pages match, Brave drops the operators and answers a looser query instead; the result says so, and those results should not be treated as filtered. For coverage questions, site:domain on its own is a ranked sample rather than a full inventory — add search terms, and judge by whether real articles come back or just homepages and section pages. Paging deeper does not enumerate a domain either: the pool behind a single query is finite and Brave re-serves earlier pages once it runs out, so dedupe results by url, stop when a page adds nothing new, and widen coverage with more query strings rather than more pages. Brave sometimes shows a rate-limit challenge; the script clears it automatically, and if it persists it raises an error — wait 30-60 seconds before retrying.

Start building not clicking

Get started for free