job_id. The search runs in the background while you poll the detail endpoint. The same detail call returns the live status while the job runs and the full result set once it finishes.
All paths below are relative to the base URL https://client-api.leak.center/api. Send your token on every request:
1
Submit
paste-search-create submits a query and responds 202 Accepted. The search is queued, not finished. Keep the returned job_id.2
Poll
paste-search-detail returns the current status. Poll it until status reaches a terminal value (completed). Use this same call to read results — see the next step.3
Read
Once
status is completed, paste-search-detail returns the results array plus paging and filter metadata. Page with page and page_size, and narrow the result set with the filters in the table below.Request parameters
Submit body —paste-search-create:
Detail query —
paste-search-detail/{job_id}:
What comes back
The detail response is a job envelope wrapping a pagedresults array. Top-level fields:
job_id— the search job UUID.status— job state.completedmeans results are ready.error_message— failure reason, ornullon success.query— the query you submitted.created_at,started_at,completed_at— job lifecycle timestamps.results— array of paste matches (shape below).total— total matches across all pages.page,page_size— the current page and page size.sites_matched— number of distinct paste sites with a hit.db_results— count from the indexed database, ornull.live_results— count from the live crawl, ornull.available_authors— authors present in the result set, for building anauthorfilter.available_sites— site names present in the result set, for building asite_namefilter.
results:
id— internal result ID, ornull.external_id— the paste’s ID on its source site, ornull.title— the paste title, ornull.text_preview— matched snippet with surrounding context, sized bycontext_chars.author— the paste author, ornull.date— when the paste was published, ornull.site_name— the paste site (e.g. a Pastebin-style host).base_url— the site’s base URL, ornull.content_hash— content fingerprint used for dedup, ornull.source—databaseorlive.url— direct link to the paste, ornull.is_new—trueif alerting flagged this as a new finding.
paste-search-create allows 100 requests per day, and paste-search-detail allows 1000 per day — generous enough to poll a job to completion.
What to do with the results
Treat anytext_preview that exposes a live credential for your domain as an active exposure: rotate the password, force re-authentication, and check the source paste’s url and date to scope the blast radius. Use is_new to spot fresh leaks since your last sweep and available_sites to see which paste hosts are carrying your data.