/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": []
  }
]

Aljazeera

/aljazeera/categories/articles

List Al Jazeera articles for a site section (news, sports, economy, opinion, videos), topic tag (football, crime) or country/region (iran, europe, us-canada). Returns listing items with title, excerpt, publish date, link, authors, featured image, video, audio version and liveblog updates, newest first.

Price: 1 credit

💡 AI Hint: Browse Al Jazeera articles by category: pass a category slug or a section/tag/country page URL (URL form also resolves category_type for /tag/ and /where/ pages). The category slug must exist in the chosen category_type taxonomy: sections like ‘news’ or ‘economy’ are ‘categories’, topics like ‘football’ are ‘tags’, places like ‘iran’ or ‘us-canada’ are ‘where’. Returns newest-first items with title, excerpt, published_at, web_url, post_type, authors, sources, image, video, audio_url and child_posts (latest liveblog updates). Use aljazeera/articles with an item’s web_url to fetch the full text.

⚠️ Common errors: 412: Category, tag or place not found in the chosen category_type taxonomy

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[]

Show child attributes

sources

string[]

labels

string[]

image

string | null

image_caption

string | null

image_credit

string | null

thumbnail

string | null

gallery_images

AljazeeraGalleryImage · object[]

Show child attributes

gallery_image_count

integer | null

video

AljazeeraVideo · object

Show child attributes

audio_url

string | null

audio_duration

number | null

programs

AljazeeraTerm · object[]

Show child attributes

child_posts

AljazeeraChildPost · object[]

Show child attributes

/aljazeera/authors/articles /amazon/products