{"openapi":"3.1.0","info":{"title":"National Tribune Content API","version":"1.0.0","description":"Versioned journalism, claims, entities, events, provenance, rights, quality and correction-aware delivery for AI and enterprise systems.","license":{"name":"Commercial license required for training and redistribution","url":"https://nationaltribune.com/licensing"}},"servers":[{"url":"https://nationaltribune.com"}],"security":[],"paths":{"/api/v1/content":{"get":{"operationId":"listContent","summary":"List published records","parameters":[{"name":"section","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string"}},{"name":"updated_after","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}}],"responses":{"200":{"description":"Content collection","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/content/{id}":{"get":{"operationId":"getContent","summary":"Get a record by stable ID or slug","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Content record","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://nationaltribune.com/schemas/content-v1.json","title":"National Tribune Content Record v1","description":"The canonical, versioned content contract used by National Tribune APIs, feeds and licensed datasets.","type":"object","additionalProperties":false,"required":["id","slug","section","contentType","status","headline","dek","updatedAt","version","rights","quality"],"properties":{"id":{"type":"string","minLength":1},"slug":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"section":{"type":"string"},"contentType":{"enum":["reportage","analysis","opinion","personal","sponsored","affiliate_review","live"]},"status":{"enum":["draft","review","scheduled","published","archived","corrected"]},"headline":{"type":"string"},"shortHeadline":{"type":"string"},"dek":{"type":"string"},"takeaways":{"type":"array","items":{"type":"string"}},"author":{"type":"object","required":["name","role"],"properties":{"name":{"type":"string"},"role":{"type":"string"}},"additionalProperties":false},"editor":{"type":["string","null"]},"media":{"type":"object","properties":{"url":{"type":"string"},"alt":{"type":"string"},"caption":{"type":"string"}}},"publishedAt":{"type":["string","null"],"format":"date-time"},"scheduledAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"version":{"type":"integer","minimum":1},"contentHash":{"type":["string","null"]},"body":{"type":"array","items":{"$ref":"#/$defs/contentBlock"}},"disclosure":{"type":["string","null"]},"sponsor":{"type":["string","null"]},"product":{"type":["object","null"]},"corrections":{"type":"array","items":{"type":"object","required":["summary","publishedAt"],"properties":{"summary":{"type":"string"},"publishedAt":{"type":"string","format":"date-time"}}}},"provenance":{"type":"object"},"digitalSourceType":{"type":"string"},"sources":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"string"},"publishedAt":{"type":"string","format":"date-time"}}}},"claims":{"type":"array","items":{"type":"object","required":["text","verdict","confidence","evidence"],"properties":{"text":{"type":"string"},"verdict":{"type":"string"},"confidence":{"type":"integer","minimum":0,"maximum":100},"evidence":{"type":"array","items":{"type":"string"}}}}},"entities":{"type":"array","items":{"type":"object"}},"events":{"type":"array","items":{"type":"object"}},"rights":{"$ref":"#/$defs/rights"},"quality":{"type":"object","required":["score","grade","flags"],"properties":{"score":{"type":"integer","minimum":0,"maximum":100},"grade":{"enum":["A","B","C","D","F"]},"checks":{"type":"object"},"flags":{"type":"array","items":{"type":"string"}}}},"reviewPros":{"type":"array","items":{"type":"string"}},"reviewCons":{"type":"array","items":{"type":"string"}}},"$defs":{"contentBlock":{"type":"object","required":["type","text"],"properties":{"type":{"enum":["paragraph","heading","quote"]},"text":{"type":"string"},"attribution":{"type":"string"}}},"rights":{"type":"object","required":["retrievalAllowed","trainingAllowed","embeddingsAllowed","redistributionAllowed","attributionRequired","commercialUseAllowed","licenseUrl","territories"],"properties":{"retrievalAllowed":{"type":"boolean"},"trainingAllowed":{"type":"boolean"},"embeddingsAllowed":{"type":"boolean"},"redistributionAllowed":{"type":"boolean"},"attributionRequired":{"type":"boolean"},"commercialUseAllowed":{"type":"boolean"},"licenseUrl":{"type":"string"},"territories":{"type":"string"},"expiresAt":{"type":["string","null"],"format":"date-time"}}}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/content/{id}/artifacts":{"get":{"operationId":"getContentArtifacts","summary":"Get approved social, newsletter, AI-summary and reel-script packages","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Approved channel artifacts","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Licensed artifacts entitlement required","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/changes":{"get":{"operationId":"listChanges","summary":"Correction-aware event stream","parameters":[{"name":"since","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Durable content changes","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/entities":{"get":{"operationId":"listEntities","summary":"Entity and topic graph","responses":{"200":{"description":"Entities","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/claims":{"get":{"operationId":"listClaims","summary":"Machine-readable reported claims","responses":{"200":{"description":"Claims","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/events":{"get":{"operationId":"listEvents","summary":"Developing news events","responses":{"200":{"description":"Events","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/export.ndjson":{"get":{"operationId":"exportNdjson","summary":"Licensed incremental NDJSON export","security":[{"bearerAuth":[]}],"parameters":[{"name":"section","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string"}},{"name":"updated_after","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}}],"responses":{"200":{"description":"One full content record per line","content":{"application/x-ndjson":{"schema":{"type":"string"}}}},"401":{"description":"Licensed key required","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Quota exceeded","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/manifest":{"get":{"operationId":"getManifest","summary":"Machine product discovery manifest","responses":{"200":{"description":"Dataset and schema links","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/plans":{"get":{"operationId":"listPlans","summary":"Machine-readable commercial plans and usage rights","responses":{"200":{"description":"Commercial plans","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/policies":{"get":{"operationId":"listPolicies","summary":"Machine-readable privacy, acceptable-use and evaluation controls","responses":{"200":{"description":"Platform policies","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/health":{"get":{"operationId":"getHealth","summary":"Public service and delivery health","responses":{"200":{"description":"Service health","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Service interruption","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/webhooks":{"get":{"operationId":"listWebhooks","summary":"List subscriptions","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Subscriptions","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"operationId":"createWebhook","summary":"Create a signed webhook subscription","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"Subscription and one-time secret","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"nt_live_*"}},"schemas":{"ContentRecord":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://nationaltribune.com/schemas/content-v1.json","title":"National Tribune Content Record v1","description":"The canonical, versioned content contract used by National Tribune APIs, feeds and licensed datasets.","type":"object","additionalProperties":false,"required":["id","slug","section","contentType","status","headline","dek","updatedAt","version","rights","quality"],"properties":{"id":{"type":"string","minLength":1},"slug":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"section":{"type":"string"},"contentType":{"enum":["reportage","analysis","opinion","personal","sponsored","affiliate_review","live"]},"status":{"enum":["draft","review","scheduled","published","archived","corrected"]},"headline":{"type":"string"},"shortHeadline":{"type":"string"},"dek":{"type":"string"},"takeaways":{"type":"array","items":{"type":"string"}},"author":{"type":"object","required":["name","role"],"properties":{"name":{"type":"string"},"role":{"type":"string"}},"additionalProperties":false},"editor":{"type":["string","null"]},"media":{"type":"object","properties":{"url":{"type":"string"},"alt":{"type":"string"},"caption":{"type":"string"}}},"publishedAt":{"type":["string","null"],"format":"date-time"},"scheduledAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"version":{"type":"integer","minimum":1},"contentHash":{"type":["string","null"]},"body":{"type":"array","items":{"$ref":"#/$defs/contentBlock"}},"disclosure":{"type":["string","null"]},"sponsor":{"type":["string","null"]},"product":{"type":["object","null"]},"corrections":{"type":"array","items":{"type":"object","required":["summary","publishedAt"],"properties":{"summary":{"type":"string"},"publishedAt":{"type":"string","format":"date-time"}}}},"provenance":{"type":"object"},"digitalSourceType":{"type":"string"},"sources":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"string"},"publishedAt":{"type":"string","format":"date-time"}}}},"claims":{"type":"array","items":{"type":"object","required":["text","verdict","confidence","evidence"],"properties":{"text":{"type":"string"},"verdict":{"type":"string"},"confidence":{"type":"integer","minimum":0,"maximum":100},"evidence":{"type":"array","items":{"type":"string"}}}}},"entities":{"type":"array","items":{"type":"object"}},"events":{"type":"array","items":{"type":"object"}},"rights":{"$ref":"#/$defs/rights"},"quality":{"type":"object","required":["score","grade","flags"],"properties":{"score":{"type":"integer","minimum":0,"maximum":100},"grade":{"enum":["A","B","C","D","F"]},"checks":{"type":"object"},"flags":{"type":"array","items":{"type":"string"}}}},"reviewPros":{"type":"array","items":{"type":"string"}},"reviewCons":{"type":"array","items":{"type":"string"}}},"$defs":{"contentBlock":{"type":"object","required":["type","text"],"properties":{"type":{"enum":["paragraph","heading","quote"]},"text":{"type":"string"},"attribution":{"type":"string"}}},"rights":{"type":"object","required":["retrievalAllowed","trainingAllowed","embeddingsAllowed","redistributionAllowed","attributionRequired","commercialUseAllowed","licenseUrl","territories"],"properties":{"retrievalAllowed":{"type":"boolean"},"trainingAllowed":{"type":"boolean"},"embeddingsAllowed":{"type":"boolean"},"redistributionAllowed":{"type":"boolean"},"attributionRequired":{"type":"boolean"},"commercialUseAllowed":{"type":"boolean"},"licenseUrl":{"type":"string"},"territories":{"type":"string"},"expiresAt":{"type":["string","null"],"format":"date-time"}}}}}}}}