API reference & examples
Try asking your connected assistant
Find Dallas County probate leads and help me organize the available records.
Connection details
Use these settings in a compatible tool or share this public page with whoever is helping you connect. Share the instructions—not your key.
| API base URL | https://lienscraper.com/api/v1/ |
|---|---|
| OpenAPI | https://lienscraper.com/agents/openapi.json |
| Authentication | Authorization: Bearer YOUR_PRIVATE_KEY |
| Available datasets | https://lienscraper.com/agents/catalog.json |
Choose a catalog entry with api_available set to true. Send your key only to https://lienscraper.com in the Authorization header, never in a URL or browser-side code.
Search and keep the same list
GET /api/v1/leads/?dataset=tx/dallas-county/property-liens
Authorization: Bearer YOUR_PRIVATE_KEY
Save the returned version. Follow next for additional pages or csv_url to download that version and filter selection. Keep version on subsequent requests so newly published records do not change your selection. CSV requires export permission.
| Parameter | Meaning |
|---|---|
dataset | Exact county dataset ID from the catalog. |
version | Published version returned by search. Required for CSV. |
page | Page number, starting at 1. Fifteen records per JSON page. |
start_date / end_date | Inclusive YYYY-MM-DD limits on event date, not publication date. Event date can differ from recording date. |
sort | desc (default) or asc, by event date. |
lien_type | Property-liens lists only. Exact subtype values are in the OpenAPI specification. |
format | json (default) or csv. CSV exports the entire filtered version, up to 10,000 records. |
Dates and reliable results
Publication dates describe when LienScraper published a list, not when each document was recorded. Preserve document types, statuses and source links in your results. A missing value is not proof that a record or condition does not exist.
HTTP 400: check the request. 401: replace invalid, expired or revoked credentials. 403: CSV permission required. 404: dataset or version unavailable. 409: retry the pinned version. 413: narrow the date range. 429: honor Retry-After. 503: temporarily unavailable. Do not report a failed request as an empty or complete list.
Use the data under our terms. API access does not grant consent to contact a person. Terms · Privacy