{"openapi":"3.1.0","info":{"title":"Ajel Wire API","version":"1.0.0","description":"Official content-distribution API of Ajel (صحيفة عاجل) — Saudi news in 10 languages. Free with attribution. Every request requires an API key in the `x-api-key` header (no anonymous access); requests without a valid key get `401 key_required`. Create a free key from your account dashboard at https://ajel.sa/wire/dashboard. Rate limits per hour: developer 3000/hour, publisher 10000/hour, partner 50000/hour. Higher tiers are requested from the dashboard.","contact":{"url":"https://ajel.sa/wire"}},"servers":[{"url":"https://ajel.sa/api/wire"},{"url":"https://wire.ajel.sa"}],"security":[{"apiKey":[]}],"x-rate-limits":{"unit":"requests/hour","tiers":{"developer":3000,"publisher":10000,"partner":50000}},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Wire key (`ajw_...`) created from https://ajel.sa/wire/dashboard. Required on every request."}},"responses":{"KeyRequired":{"description":"Missing or invalid API key (`key_required`)"},"RateLimited":{"description":"Hourly limit of the key's tier exceeded (developer 3000/hour, publisher 10000/hour, partner 50000/hour)"}},"schemas":{"Article":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"language":{"type":"string","enum":["ar","en","ur","es","fr","id","bn","hi","ru","tr"]},"direction":{"type":"string","enum":["rtl","ltr"]},"translation_of":{"type":["string","null"],"description":"Arabic origin id when this is a translation"},"title":{"type":"string"},"summary":{"type":["string","null"]},"content_text":{"type":"string","description":"Full plain text (single-article endpoint only)"},"content_html":{"type":["string","null"],"description":"Full sanitized HTML (single-article endpoint only)"},"canonical_url":{"type":"string","format":"uri"},"published_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time","description":"EDITORIAL update time (never precedes published_at)"},"status":{"type":"string","enum":["published","updated"]},"breaking":{"type":"boolean"},"section":{"type":["object","null"]},"authors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"}}}},"media":{"type":"array","items":{"type":"object"}},"available_translations":{"type":"array","items":{"type":"string","enum":["ar","en","ur","es","fr","id","bn","hi","ru","tr"]}},"attribution":{"type":"object","properties":{"brand":{"type":"string"},"brand_latin":{"type":"string"},"text":{"type":"string"},"url":{"type":"string","format":"uri"}}},"usage":{"type":"object"}}}}},"paths":{"/v1/languages":{"get":{"summary":"Available language editions","responses":{"200":{"description":"OK"},"401":{"$ref":"#/components/responses/KeyRequired"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/sections":{"get":{"summary":"Active sections of an edition","parameters":[{"name":"language","in":"query","schema":{"type":"string","enum":["ar","en","ur","es","fr","id","bn","hi","ru","tr"],"default":"ar"},"description":"Edition language code"}],"responses":{"200":{"description":"OK"},"400":{"description":"Unknown language"},"401":{"$ref":"#/components/responses/KeyRequired"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/latest":{"get":{"summary":"Latest published articles","parameters":[{"name":"language","in":"query","schema":{"type":"string","enum":["ar","en","ur","es","fr","id","bn","hi","ru","tr"],"default":"ar"},"description":"Edition language code"},{"name":"section","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"$ref":"#/components/responses/KeyRequired"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/breaking":{"get":{"summary":"Breaking news (last 72h)","parameters":[{"name":"language","in":"query","schema":{"type":"string","enum":["ar","en","ur","es","fr","id","bn","hi","ru","tr"],"default":"ar"},"description":"Edition language code"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"OK"},"401":{"$ref":"#/components/responses/KeyRequired"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/search":{"get":{"summary":"Search headlines/summaries","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2}},{"name":"language","in":"query","schema":{"type":"string","enum":["ar","en","ur","es","fr","id","bn","hi","ru","tr"],"default":"ar"},"description":"Edition language code"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"OK"},"401":{"$ref":"#/components/responses/KeyRequired"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/articles":{"get":{"summary":"List articles (filters + cursor pagination; q switches to search)","parameters":[{"name":"language","in":"query","schema":{"type":"string","enum":["ar","en","ur","es","fr","id","bn","hi","ru","tr"],"default":"ar"},"description":"Edition language code"},{"name":"section","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"401":{"$ref":"#/components/responses/KeyRequired"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/articles/{id}":{"get":{"summary":"One article with full text and available translations","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"401":{"$ref":"#/components/responses/KeyRequired"},"404":{"description":"Not found or unpublished"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/articles/{id}/translations":{"get":{"summary":"All published language versions of an article","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"401":{"$ref":"#/components/responses/KeyRequired"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/keys":{"post":{"deprecated":true,"summary":"Retired — always returns 410 Gone","description":"Self-service key issuance over the API was retired. This endpoint always responds `410 Gone`. Create and manage keys from your account dashboard at https://ajel.sa/wire/dashboard.","security":[],"responses":{"410":{"description":"Gone — keys are issued from https://ajel.sa/wire/dashboard"}}}}}}