Review news duplicate gates (GET)

GET

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

GET

/v1/news/duplicate-check

$ curl -G https://api.aventure.vc/v1/news/duplicate-check \
>      -H "X-Client-Secret: <apiKey>" \
>      -d excludeId=123 \
>      -d externalId=rss-guid-1234 \
>      -d page=0 \
>      -d publication=TechCrunch \
>      --data-urlencode "search=OpenAI GPT-5" \
>      -d size=10 \
>      -d slug=openai-announces-gpt5 \
>      --data-urlencode "title=OpenAI announces GPT-5" \
>      --data-urlencode url=https://techcrunch.com/example \
>      -d urlDomain=techcrunch.com \
>      -d urlMatchMode=hostPath

1 {
2   "content": [
3     {
4       "core": {
5         "id": 1,
6         "title": "string",
7         "author": "string",
8         "category": "string",
9         "createdAt": "2024-01-15T09:30:00Z",
10         "excerpt": "string",
11         "externalNewsArticle": true,
12         "newsImageThumbnail": "string",
13         "newsUrlOriginal": "string",
14         "pendingApproval": 1,
15         "publication": "string",
16         "publishedAt": "2024-01-15T09:30:00Z",
17         "slug": "aventure-vc",
18         "updatedAt": "2024-01-15T09:30:00Z"
19       },
20       "entityMentionResolved": [
21         {
22           "createdAt": "2024-01-15T09:30:00Z",
23           "entityId": "string",
24           "internal": true,
25           "updatedAt": "2024-01-15T09:30:00Z",
26           "href": "string",
27           "matchScore": 1.1,
28           "matchType": "string",
29           "mention": "string",
30           "slug": "aventure-vc",
31           "typeRecord": "Company"
32         }
33       ],
34       "personMentionResolved": [
35         {
36           "createdAt": "2024-01-15T09:30:00Z",
37           "personId": "string",
38           "updatedAt": "2024-01-15T09:30:00Z",
39           "href": "string",
40           "matchScore": 1.1,
41           "matchType": "string",
42           "mention": "string",
43           "slug": "aventure-vc"
44         }
45       ],
46       "content": "string",
47       "externalId": "string",
48       "linkedContent": "string"
49     }
50   ],
51   "empty": true,
52   "first": true,
53   "last": true,
54   "number": 1,
55   "numberOfElements": 1,
56   "pageable": {
57     "offset": 1,
58     "pageNumber": 1,
59     "pageSize": 1,
60     "paged": true,
61     "sort": {
62       "empty": true,
63       "sorted": true,
64       "unsorted": true
65     },
66     "unpaged": true
67   },
68   "size": 1,
69   "sort": {
70     "empty": true,
71     "sorted": true,
72     "unsorted": true
73   },
74   "totalElements": 1,
75   "totalPages": 1
76 }

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

excludeIdintegerOptional

Exclude news id

slugstringOptional

URL-safe identifier

titlestringOptional

Article title

searchstringOptional

Full-text search query

publicationstringOptional

Publication name

urlstringOptional

Article URL

urlDomainstringOptional

URL domain match

urlMatchModeenumOptional

URL match mode

Allowed values:

externalIdstringOptional

External identifier

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

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

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error