Real Estate

King County Recorder

King County (WA) recorded documents — trustee-sale notices, deeds and deeds of trust — by record date or party.

king-county-recorderreal-estatecounty-recordsrecorderking-countywashingtonpublic-record

0 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/king-county-recorder/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/king-county-recorder/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "searchMode": "recordDate",      "name": "Last name, First name",      "documentTypes": [        "NTS"      ],      "lookbackDays": 7    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Search

searchMode
enum
Search by
A date sweep needs no name and is what a scheduled run wants. Name search falls back to a date sweep if no name is given.
Default
recordDate
Allowed values
recordDate
name
name
string
Party name
Default
none
Example
Last name, First name
documentTypes
string[]
Document types
Codes or numeric ids; resolved against the catalogue the portal publishes. Common: NTS, ANTS, DT, D, LP. Empty means every type.
Default
["NTS"]
Example
NTS, DT
beginDate
string
Recorded from (MM/DD/YYYY)
Overrides the lookback window.
Default
none
endDate
string
Recorded to (MM/DD/YYYY)
Defaults to today.
Default
none
lookbackDays
number
Lookback (days)
Default
7
Range
1 to 3650

Advanced

nameMatchType
number
Name match
The portal's own numbering: 0 starts with, 1 contains, 2 equals.
Default
0
Range
0 to 2
partyType
number
Party type
0 both, 1 grantor, 2 grantee.
Default
0
Range
0 to 2
recordCount
number
Records requested
0 asks the portal for its own default cap.
Default
0
Range
0 to 10000
maxPages
number
Max result pages
Default
10
Range
1 to 200
maxRecords
number
Max records per run
Default
5000
Range
1 to 200000
requestDelayMs
number
Delay between requests (ms)
Default
2000
Range
0 to 60000
captchaTimeoutMs
number
Captcha solve timeout (ms)
A reCAPTCHA v2 image challenge typically takes 15-60s at 2Captcha.
Default
180000
Range
10000 to 600000

Credentials

twoCaptchaApiKey
string
2Captcha API key override
Defaults to TWO_CAPTCHA_API_KEY. Prefer the environment variable; run options are stored in plain text on the config row.
Default
none

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "searchMode": {      "type": "string",      "enum": [        "recordDate",        "name"      ],      "title": "Search by",      "description": "A date sweep needs no name and is what a scheduled run wants. Name search falls back to a date sweep if no name is given.",      "default": "recordDate"    },    "name": {      "type": "string",      "maxLength": 2000,      "title": "Party name",      "examples": [        "Last name, First name"      ]    },    "documentTypes": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Document types",      "description": "Codes or numeric ids; resolved against the catalogue the portal publishes. Common: NTS, ANTS, DT, D, LP. Empty means every type.",      "default": [        "NTS"      ],      "examples": [        "NTS, DT"      ]    },    "beginDate": {      "type": "string",      "maxLength": 2000,      "title": "Recorded from (MM/DD/YYYY)",      "description": "Overrides the lookback window."    },    "endDate": {      "type": "string",      "maxLength": 2000,      "title": "Recorded to (MM/DD/YYYY)",      "description": "Defaults to today."    },    "lookbackDays": {      "type": "number",      "minimum": 1,      "maximum": 3650,      "title": "Lookback (days)",      "default": 7    },    "nameMatchType": {      "type": "number",      "minimum": 0,      "maximum": 2,      "title": "Name match",      "description": "The portal's own numbering: 0 starts with, 1 contains, 2 equals.",      "default": 0    },    "partyType": {      "type": "number",      "minimum": 0,      "maximum": 2,      "title": "Party type",      "description": "0 both, 1 grantor, 2 grantee.",      "default": 0    },    "recordCount": {      "type": "number",      "minimum": 0,      "maximum": 10000,      "title": "Records requested",      "description": "0 asks the portal for its own default cap.",      "default": 0    },    "maxPages": {      "type": "number",      "minimum": 1,      "maximum": 200,      "title": "Max result pages",      "default": 10    },    "maxRecords": {      "type": "number",      "minimum": 1,      "maximum": 200000,      "title": "Max records per run",      "default": 5000    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 60000,      "title": "Delay between requests (ms)",      "default": 2000    },    "captchaTimeoutMs": {      "type": "number",      "minimum": 10000,      "maximum": 600000,      "title": "Captcha solve timeout (ms)",      "description": "A reCAPTCHA v2 image challenge typically takes 15-60s at 2Captcha.",      "default": 180000    },    "twoCaptchaApiKey": {      "type": "string",      "maxLength": 2000,      "title": "2Captcha API key override",      "description": "Defaults to TWO_CAPTCHA_API_KEY. Prefer the environment variable; run options are stored in plain text on the config row."    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/king-county-recorder/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "searchMode": "recordDate",      "name": "Last name, First name",      "documentTypes": [        "NTS"      ],      "lookbackDays": 7    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

No rows collected yet, so no fields have been observed. Run the scraper once and they will appear here.