Legal Data Hunter Search API
The Search API from Legal Data Hunter — 1 operation(s) for search.
The Search API from Legal Data Hunter — 1 operation(s) for search.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/legaldatahunter-com:legaldatahunter-com-search-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Legal Search API
description: Hybrid semantic + keyword search over EU legal data (case law, legislation, doctrine).
version: 0.1.0
tags:
- name: Search
paths:
/v1/search:
post:
tags:
- Search
summary: Search
description: 'Hybrid semantic + keyword search over legal documents.
Set `namespace` to "case_law", "legislation", or "doctrine" to choose which collection to search.
`result_detail` is opt-in. Omit it or pass "snippet" for the backward-compatible
default SearchHit shape. Pass "full_text" to include bounded document text
where available; if text cannot be loaded for a hit, that hit is returned with
`text_unavailable=true` instead of failing the whole search.'
operationId: search_v1_search_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SearchRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SearchResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
SearchRequest:
properties:
q:
type: string
maxLength: 10000
minLength: 1
title: Q
description: Search query text
top_k:
type: integer
maximum: 100.0
minimum: 1.0
title: Top K
description: Number of results
default: 10
alpha:
type: number
maximum: 1.0
minimum: 0.0
title: Alpha
description: Semantic vs keyword weight (1.0=pure semantic, 0.0=pure keyword)
default: 0.7
country:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Country
description: 'Strongly recommended: narrow searches are faster and more precise. LDH jurisdiction codes — mostly ISO 3166-1 alpha-2, plus aggregate/supranational codes such as EU, UN, CoE, INTL, and OECD. Call discover_countries for the full list. E.g. [''FR'', ''DE''].'
source:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Source
description: Recommended when you know the court or publisher. Source IDs from discover_sources (e.g. ['FR/CNIL']).
court:
anyOf:
- type: string
- type: 'null'
title: Court
court_tier:
anyOf:
- type: integer
maximum: 3.0
minimum: 1.0
- type: 'null'
title: Court Tier
jurisdiction:
anyOf:
- type: string
- type: 'null'
title: Jurisdiction
language:
anyOf:
- type: string
- type: 'null'
title: Language
description: Optional language-code filter (e.g. fr, de), mainly useful in multilingual jurisdictions. Do not infer it from the query language. Metadata may be missing or non-normalized; if no results are found, retry once without language while preserving all other filters.
date_start:
anyOf:
- type: string
format: date
- type: 'null'
title: Date Start
description: Start date filter (YYYY-MM-DD)
date_end:
anyOf:
- type: string
format: date
- type: 'null'
title: Date End
description: End date filter (YYYY-MM-DD)
namespace:
type: string
title: Namespace
description: 'Pinecone namespace: "case_law", "legislation", or "doctrine"'
default: case_law
result_detail:
type: string
enum:
- snippet
- summary_only
- full_text
- full_metadata
title: Result Detail
description: How much content to include per search hit. Omit or use 'snippet' for the backward-compatible default snippet response. Use 'summary_only' for concise summary/snippet content, 'full_text' to opt into document text where available, or 'full_metadata' for text plus public metadata. Large text is bounded and marked with text_truncated/full_text_size.
default: snippet
type: object
required:
- q
title: SearchRequest
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
SearchResponse:
properties:
query:
type: string
title: Query
hits:
items:
$ref: '#/components/schemas/SearchHit'
type: array
title: Hits
total_hits:
type: integer
title: Total Hits
alpha:
type: number
title: Alpha
namespace:
type: string
title: Namespace
elapsed_ms:
type: integer
title: Elapsed Ms
hint:
anyOf:
- type: string
- type: 'null'
title: Hint
access_notice:
anyOf:
- type: string
- type: 'null'
title: Access Notice
type: object
required:
- query
- hits
- total_hits
- alpha
- namespace
- elapsed_ms
title: SearchResponse
SearchHit:
properties:
id:
type: string
title: Id
source:
type: string
title: Source
source_id:
type: string
title: Source Id
score:
type: number
title: Score
title:
anyOf:
- type: string
- type: 'null'
title: Title
snippet:
anyOf:
- type: string
- type: 'null'
title: Snippet
text:
anyOf:
- type: string
- type: 'null'
title: Text
summary:
anyOf:
- type: string
- type: 'null'
title: Summary
text_truncated:
anyOf:
- type: boolean
- type: 'null'
title: Text Truncated
full_text_size:
anyOf:
- type: integer
- type: 'null'
title: Full Text Size
text_unavailable:
anyOf:
- type: boolean
- type: 'null'
title: Text Unavailable
url:
anyOf:
- type: string
- type: 'null'
title: Url
country:
anyOf:
- type: string
- type: 'null'
title: Country
court:
anyOf:
- type: string
- type: 'null'
title: Court
court_tier:
anyOf:
- type: integer
- type: 'null'
title: Court Tier
date:
anyOf:
- type: string
- type: 'null'
title: Date
jurisdiction:
anyOf:
- type: string
- type: 'null'
title: Jurisdiction
language:
anyOf:
- type: string
- type: 'null'
title: Language
ecli:
anyOf:
- type: string
- type: 'null'
title: Ecli
case_number:
anyOf:
- type: string
- type: 'null'
title: Case Number
chamber:
anyOf:
- type: string
- type: 'null'
title: Chamber
decision_type:
anyOf:
- type: string
- type: 'null'
title: Decision Type
decision_number:
anyOf:
- type: string
- type: 'null'
title: Decision Number
authority:
anyOf:
- type: string
- type: 'null'
title: Authority
document_type:
anyOf:
- type: string
- type: 'null'
title: Document Type
status:
anyOf:
- type: string
- type: 'null'
title: Status
identifier:
anyOf:
- type: string
- type: 'null'
title: Identifier
eli_uri:
anyOf:
- type: string
- type: 'null'
title: Eli Uri
effective_date:
anyOf:
- type: string
- type: 'null'
title: Effective Date
expiry_date:
anyOf:
- type: string
- type: 'null'
title: Expiry Date
quality_tier:
anyOf:
- type: integer
- type: 'null'
title: Quality Tier
granularity:
anyOf:
- type: string
- type: 'null'
title: Granularity
unit_type:
anyOf:
- type: string
- type: 'null'
title: Unit Type
unit_number:
anyOf:
- type: string
- type: 'null'
title: Unit Number
canonical_path:
anyOf:
- type: string
- type: 'null'
title: Canonical Path
parent_source_id:
anyOf:
- type: string
- type: 'null'
title: Parent Source Id
additionalProperties: true
type: object
required:
- id
- source
- source_id
- score
title: SearchHit