Skip to main content
POST
/
api
/
aljazeera
/
categories
/
articles
/aljazeera/categories/articles
curl --request POST \
  --url https://api.anysite.io/api/aljazeera/categories/articles \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "category": "<string>",
  "count": 2,
  "timeout": 300,
  "category_type": "categories"
}
'
[
  {
    "id": 123,
    "title": "<string>",
    "@type": "@aljazeera_category_article",
    "replacement_title": "<string>",
    "post_type": "<string>",
    "excerpt": "<string>",
    "published_at": "<string>",
    "web_url": "<string>",
    "short_url": "<string>",
    "proxy_short_url": "<string>",
    "is_breaking": false,
    "is_developing": false,
    "is_live": false,
    "authors": [],
    "sources": [],
    "labels": [],
    "image": "<string>",
    "image_caption": "<string>",
    "image_credit": "<string>",
    "thumbnail": "<string>",
    "gallery_images": [],
    "gallery_image_count": 123,
    "video": {
      "id": "<string>",
      "@type": "@aljazeera_video",
      "title": "<string>",
      "duration": "<string>",
      "url": "<string>",
      "aspect_ratio": "<string>"
    },
    "audio_url": "<string>",
    "audio_duration": 123,
    "programs": [],
    "child_posts": []
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
category
string
required

Category slug or Al Jazeera section, tag or country page URL

Minimum string length: 1
Examples:

"news"

"https://www.aljazeera.com/economy/"

"https://www.aljazeera.com/tag/football/"

count
integer
required

Max number of articles to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
category_type
enum<string>
default:categories

Taxonomy the category belongs to: 'categories' for site sections (news, sports, economy, opinion, videos), 'tags' for topics (football, crime), 'where' for geography (iran, europe, asia, us-canada)

Available options:
categories,
tags,
where

Response

Successful Response

id
integer
required
title
string
required
@type
string
default:@aljazeera_category_article
replacement_title
string | null
post_type
string | null
excerpt
string | null
published_at
string | null
web_url
string | null
short_url
string | null
proxy_short_url
string | null
is_breaking
boolean
default:false
is_developing
boolean
default:false
is_live
boolean
default:false
authors
AljazeeraAuthor · object[]
sources
string[]
labels
string[]
image
string | null
image_caption
string | null
image_credit
string | null
thumbnail
string | null
video
AljazeeraVideo · object
audio_url
string | null
audio_duration
number | null
programs
AljazeeraTerm · object[]
child_posts
AljazeeraChildPost · object[]