[Get] Search For Articles By Id Or Link

GET {{baseUrl}}/api/search_by_link

This endpoint allows you to search for articles. You can search for articles by id(s) or link(s).

Request Params

KeyDatatypeRequiredDescription
idsstringNewscatcher article id (_id in API response) or a list of artilce ids you want to search for
linksstringarticle link or list of article links you want to search for
pagestringThe number of the page. Use it to scroll through the results.

This parameter is used to paginate: scroll through results because one API response cannot return more than 1000 articles. | | page_size | string | | [1:1000] How many articles to return per page. |

HEADERS

KeyDatatypeRequiredDescription
x-api-tokenstring(Required)
Acceptstring

RESPONSES

status: OK

{"total_hits":"\u003cinteger\u003e","page":"\u003cinteger\u003e","total_pages":"\u003cinteger\u003e","page_size":"\u003cinteger\u003e","articles":[],"user_input":{},"status":"ok"}