aVenture APINews V1

Review news duplicate gates

View as Markdown

USE FOR: Deterministic duplicate-check identity gates before create or update. An empty page is not proof no article exists; when create returns 409, use that ProblemDetail.details.newsCandidate as the authoritative create decision surface. NOT FOR: General news/article browsing and list/search discovery flows.

Authentication

X-Client-Secretstring

Client secret for read-only service-to-service access (no writes)

Query parameters

pageintegerOptional

Zero-based page index (0..N)

sizeintegerOptional

The size of the page to be returned; duplicate-check default 10, maximum 100.

sortlist of stringsOptional
Sorting is not supported

Request

This endpoint expects an object.
excludeIdstring or integer or nullOptional
Exclude news id
externalIdstring or nullOptional
External identifier
publicationstring or nullOptional
Publication name
qwen4bFp16Embeddinglist of float or nullOptional

Embedding vector pinned to qwen-4b-fp16 (Qwen3-Embedding-4B-f16.gguf) from https://huggingface.co/Qwen/Qwen3-Embedding-4B-GGUF?show_file_info=Qwen3-Embedding-4B-f16.gguf; only this fp16 model is accepted and exactly 2560 floats are required

searchstring or nullOptional

Full-text search query

slugstring or nullOptional

URL-safe identifier

titlestring or nullOptional
Article title
urlstring or nullOptional
Article URL
urlDomainstring or nullOptional
URL domain match
urlMatchModeenum or nullOptional
URL match mode

Response

OK
contentlist of objectsOptional
emptybooleanOptional
firstbooleanOptional
lastbooleanOptional
numberintegerOptional
numberOfElementsintegerOptional
pageableobjectOptional
sizeintegerOptional
sortobjectOptional
totalElementslongOptional
totalPagesintegerOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
409
Conflict Error
415
Unsupported Media Type Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error