API changelog
Download source
  • JSON OpenAPI specification
  • YAML OpenAPI specification
GTRNews Articles API logo

Topics

  • Introduction

Endpoints

  • Articles
    • List all articles GET
    • Find an article by ID GET
  • Search
    • Search articles by title or content GET
  • Summary
    • Generate summary for an article POST
Powered by Bump.sh
API changelog
Download source
  • JSON OpenAPI specification
  • YAML OpenAPI specification
GTRNews Articles API logo

Search articles by title or content

GET /search

Searches for articles where the title or the decoded base64 content contains the search query (case insensitive).

Query parameters

  • query string Required

    The search query to match against article titles or decoded content

Responses

  • 200 application/json

    Successful search, returns an array of matching articles

    Hide response attributes Show response attributes object
    • _id string

      Unique identifier

    • title string

      Title of the article

    • content string

      Content of the article (base64 encoded)

    • author string

      Name or identifier of the author

    • createdAt string(date-time)

      Creation date

  • 400 text/plain

    Missing title query parameter

  • 500 text/plain

    Internal server error

GET /search
curl \
 --request GET 'https://articles.gtrnews.eu/api/search?query=string'
Response examples (200)
[
  {
    "_id": "string",
    "title": "string",
    "content": "string",
    "author": "string",
    "createdAt": "2025-05-04T09:42:00Z"
  }
]