NewTimeSpace API

For more information or technical support, please contact:

contact@newtimespace.com

NewTimeSpace API Get articles

Method: GET

Endpoint: /api/v1/article/getArticles

Description: Retrieves a list of news articles with support for pagination, category filtering, title/keyword search, date filtering, and sorting.

JSON Response Example
XML Response Example
Error Response (JSON Example)
                         {
 "status": "success",
 "articles": [
  {
   "article_id": "123",
   "language": "en",
   "title": "News Title",
   "description": "News description",
   "content": "News content",
   "tags": "Tag1,Tag2",
   "keywords": ["Keyword1", "Keyword2"],
   "authors": ["Author1", "Author2"],
   "category": "Category name",
   "dataType": "news",
   "url": "https://www.newtimespace.com/zh-cn/article/123",
   "pubDate": "2026-01-13 12:00:00",
   "pubDateTZ": "UTC",
   "date": "2026-01-13",
   "time": "12:00:00",
   "updated_at": "2026-01-13 13:00:00",
   "word_count": 500,
   "reading_time": 3,
   "is_breaking_news": false,
   "sentiment": "neutral",
   "related_articles": [],
   "geo_location": "",
   "source": {
     "id": "",
     "name": "NewTimeSpace",
     "url": "",
     "country": "",
   "icon": ""
   },
   "image": {
     "url": "",
     "alt": "",
     "caption": "",
     "source": "",
     "credit": ""
   },
   "video": {
     "url": null,
     "thumbnail": "",
     "duration": "",
     "source": "",
     "credit": ""
   }
  }
 ],
 "pagination": {
   "page": 1,
   "limit": 10,
   "total": 100,
   "pages": 10
  }
 }
                        
                      

Parameter arrow

parameter type required description default
page integer No Page number (must be > 0) 1
limit integer No Number of items per page (1–100). 10
category string No Category filter (English or Chinese category name) ''
title string No Title search (fuzzy match) ''
keyword string No Keyword search (tag match) ''
language string No Language (zh-cn, zh-hk, en) zh-cn
date string No Start date (YYYY-MM-DD, news of the specified date) ''
sortBy string No Sorting method (id or date) date
format string No Response json

Status Codes arrow

  • 200: Success.
  • 204: No content available.。
  • 400: Invalid parameters.。
  • 429: Too many requests.
  • 500: Internal server error.
  • 503: Service unavailable.