Score news duplicate candidates

POST

https://api.aventure.vc/v1/news/duplicate-check/candidates

POST

/v1/news/duplicate-check/candidates

$ curl -X POST "https://api.aventure.vc/v1/news/duplicate-check/candidates?page=0&size=10" \
>      -H "X-Client-Secret: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

1 {
2   "content": [
3     {
4       "id": 1,
5       "reason": [
6         "string"
7       ],
8       "score": 1,
9       "externalId": "string",
10       "slug": "aventure-vc"
11     }
12   ],
13   "empty": true,
14   "first": true,
15   "last": true,
16   "number": 1,
17   "numberOfElements": 1,
18   "pageable": {
19     "offset": 1,
20     "pageNumber": 1,
21     "pageSize": 1,
22     "paged": true,
23     "sort": {
24       "empty": true,
25       "sorted": true,
26       "unsorted": true
27     },
28     "unpaged": true
29   },
30   "size": 1,
31   "sort": {
32     "empty": true,
33     "sorted": true,
34     "unsorted": true
35   },
36   "totalElements": 1,
37   "totalPages": 1
38 }

Return scored duplicate candidates for news queries. Results are ordered by match score; custom sorting is not supported.

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

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