简体中文 | English

Use Devnors Data from Python with one API Key.

Call legal cases, laws, enterprise data, content indexes, academic research (papers / patents / journals / scholars), express tracking, and more through a single POST /v1/data/query gateway. Every hit is designed for AI agents, with official-source traceability where applicable.

pip install devnors-data

Create an API Key in the developer console, then:

from devnors_data import DevnorsData

client = DevnorsData(api_key="devnors_sk_live_xxx")  # or set DEVNORS_API_KEY

# Legal judgment documents
res = client.legal_cases("民间借贷 利息", top_k=10)
for hit in res["hits"]:
    print(hit.get("case_no"), hit.get("title"))

# Law articles
laws = client.legal_laws("合同解除 违约金")

# Unified entry for any domain / type
res = client.query(domain="legal", type="case", query="劳动争议", top_k=5)
print(res["units"], "tokens used")

Async:

import asyncio
from devnors_data import AsyncDevnorsData

async def main():
    client = AsyncDevnorsData(api_key="devnors_sk_live_xxx")
    res = await client.legal_cases("交通事故 责任认定")
    print(res["total_hits"])

asyncio.run(main())

Use your Devnors Data API Key in one of these ways:

DevnorsData(api_key="devnors_sk_live_xxx")

or:

DEVNORS_API_KEY=devnors_sk_live_xxx

Optional private / self-hosted base URL:

DEVNORS_DATA_BASE_URL=https://data.devnors.com

Search Chinese legal judgment documents for private lending disputes.

Look up current PRC law articles about contract termination and liquidated damages.

Query company registration details with a credit code or company name.

Check whether a company is on the dishonest judgment debtor list.

Get Baidu suggest keywords for "lawyer".

Track a parcel with company code and tracking number.

Search academic papers, patents, journals, or scholars, then fetch a detail by ID.

Paginate legal case hits until I have 100 results.

• Automatic retry for 429 / 5xx / connection errors (bounded exponential backoff). Non-retryable errors such as 400 / 401 / 402 / 501 are never retried. Disable with DevnorsData(..., max_retries=0).
• Pagination helper: paginate(...) walks pages using total_hits.

for hit in client.paginate("legal", "case", "借贷纠纷", page_size=20, max_items=100):
    print(hit.get("case_no"))

• Successful calls return units (tokens charged) and request_id.
• Insufficient balance raises DevnorsDataError(code="insufficient_balance", status=402).
• Rate limit raises code="rate_limited" (429).
• Each DevnorsDataError includes code / retryable / next_action / request_id.

Docs: https://data.devnors.com/docs

• MCP server for Claude / Cursor / WorkBuddy: devnors-data-mcp
• Product site: https://data.devnors.com

MIT