{"openapi":"3.1.0","info":{"title":"Noti Group API","version":"1.0.0","description":"Read-only access to the published stories of Noti Group. Free to use with attribution: link to each story's canonical URL and name the publisher (every record has an \"attribution\" object). Without a key you get summaries, 60 requests a minute. Partners with a key get their own limit and, with the full-text scope, the full text of stories. Ask for a key through the contact page.","contact":{"url":"https://noti.group/contacto/"},"termsOfService":"https://noti.group/terminos-y-condiciones/"},"servers":[{"url":"https://noti.group/api/v1"}],"paths":{"/articles":{"get":{"summary":"Published stories","description":"Newest first by default. Filters combine (AND).","parameters":[{"name":"lang","in":"query","description":"Edition: en.","schema":{"type":"string","enum":["en"],"default":"en"}},{"name":"section","in":"query","description":"Section key (e.g. music).","schema":{"type":"string"}},{"name":"hashtag","in":"query","description":"Hashtag key (e.g. taylor-swift).","schema":{"type":"string"}},{"name":"topic","in":"query","description":"Topic key.","schema":{"type":"string"}},{"name":"person","in":"query","description":"Person or organization key.","schema":{"type":"string"}},{"name":"type","in":"query","description":"Kind of story: news, analysis, opinion, review, interview, video, gallery, breaking, longform, audio, list, live.","schema":{"type":"string"}},{"name":"q","in":"query","description":"Full-text search (words, \"exact phrase\", -exclude).","schema":{"type":"string"}},{"name":"since","in":"query","description":"Published at or after (ISO 8601).","schema":{"type":"string","format":"date-time"}},{"name":"until","in":"query","description":"Published before (ISO 8601).","schema":{"type":"string","format":"date-time"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["-published","published","-updated","-views"],"default":"-published"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"A page of results.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Article"}},"meta":{"$ref":"#/components/schemas/Meta"},"links":{"type":"object","properties":{"next":{"type":["string","null"]}}}}}}}},"400":{"description":"A parameter is not valid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"The API key is not valid, inactive or expired.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (60 a minute without a key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{},{"bearer":[]},{"apiKey":[]}]}},"/articles/{id}":{"get":{"summary":"One published story","parameters":[{"name":"id","in":"path","required":true,"description":"Permanent id (attribution.id) or the address part of the story URL.","schema":{"type":"string"}},{"name":"lang","in":"query","description":"Optional: only in this edition.","schema":{"type":"string","enum":["en"],"default":"en"}}],"responses":{"200":{"description":"The story.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Article"}}}}}},"400":{"description":"A parameter is not valid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"The API key is not valid, inactive or expired.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No published story with that id."},"429":{"description":"Too many requests (60 a minute without a key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{},{"bearer":[]},{"apiKey":[]}]}},"/sections":{"get":{"summary":"Sections of the edition","description":"Only terms with at least one published story in the edition, most used first.","parameters":[{"name":"lang","in":"query","description":"Edition: en.","schema":{"type":"string","enum":["en"],"default":"en"}},{"name":"q","in":"query","description":"Only names containing this text.","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"A page of results.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Term"}},"meta":{"$ref":"#/components/schemas/Meta"},"links":{"type":"object","properties":{"next":{"type":["string","null"]}}}}}}}},"400":{"description":"A parameter is not valid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"The API key is not valid, inactive or expired.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (60 a minute without a key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{},{"bearer":[]},{"apiKey":[]}]}},"/hashtags":{"get":{"summary":"Hashtags","description":"Only terms with at least one published story in the edition, most used first.","parameters":[{"name":"lang","in":"query","description":"Edition: en.","schema":{"type":"string","enum":["en"],"default":"en"}},{"name":"q","in":"query","description":"Only names containing this text.","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"A page of results.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Term"}},"meta":{"$ref":"#/components/schemas/Meta"},"links":{"type":"object","properties":{"next":{"type":["string","null"]}}}}}}}},"400":{"description":"A parameter is not valid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"The API key is not valid, inactive or expired.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (60 a minute without a key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{},{"bearer":[]},{"apiKey":[]}]}},"/topics":{"get":{"summary":"Topics","description":"Only terms with at least one published story in the edition, most used first.","parameters":[{"name":"lang","in":"query","description":"Edition: en.","schema":{"type":"string","enum":["en"],"default":"en"}},{"name":"q","in":"query","description":"Only names containing this text.","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"A page of results.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Term"}},"meta":{"$ref":"#/components/schemas/Meta"},"links":{"type":"object","properties":{"next":{"type":["string","null"]}}}}}}}},"400":{"description":"A parameter is not valid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"The API key is not valid, inactive or expired.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (60 a minute without a key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{},{"bearer":[]},{"apiKey":[]}]}},"/people":{"get":{"summary":"People and organizations","description":"Only terms with at least one published story in the edition, most used first.","parameters":[{"name":"lang","in":"query","description":"Edition: en.","schema":{"type":"string","enum":["en"],"default":"en"}},{"name":"q","in":"query","description":"Only names containing this text.","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"A page of results.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Term"}},"meta":{"$ref":"#/components/schemas/Meta"},"links":{"type":"object","properties":{"next":{"type":["string","null"]}}}}}}}},"400":{"description":"A parameter is not valid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"The API key is not valid, inactive or expired.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (60 a minute without a key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{},{"bearer":[]},{"apiKey":[]}]}},"/authors":{"get":{"summary":"Authors","description":"Only terms with at least one published story in the edition, most used first.","parameters":[{"name":"lang","in":"query","description":"Edition: en.","schema":{"type":"string","enum":["en"],"default":"en"}},{"name":"q","in":"query","description":"Only names containing this text.","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"A page of results.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Term"}},"meta":{"$ref":"#/components/schemas/Meta"},"links":{"type":"object","properties":{"next":{"type":["string","null"]}}}}}}}},"400":{"description":"A parameter is not valid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"The API key is not valid, inactive or expired.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests (60 a minute without a key).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{},{"bearer":[]},{"apiKey":[]}]}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Authorization: Bearer clk_..."},"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"Meta":{"type":"object","properties":{"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"},"pages":{"type":"integer"},"fullText":{"type":"boolean"}}},"Link":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"}}},"Term":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"stories":{"type":"integer"},"type":{"type":"string"},"wikidata":{"type":["string","null"],"format":"uri"}}},"Article":{"type":"object","properties":{"id":{"type":"string","description":"Permanent id; stays the same when the headline or address changes."},"url":{"type":"string","format":"uri"},"language":{"type":"string"},"type":{"type":"string"},"title":{"type":"string"},"summary":{"type":["string","null"]},"published":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"},"firstPublished":{"type":"string","format":"date-time"},"section":{"$ref":"#/components/schemas/Link"},"hashtags":{"type":"array","items":{"$ref":"#/components/schemas/Link"}},"topics":{"type":"array","items":{"$ref":"#/components/schemas/Link"}},"people":{"type":"array","items":{"$ref":"#/components/schemas/Term"}},"authors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":["string","null"]}}}},"image":{"type":["object","null"],"properties":{"url":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"alt":{"type":["string","null"]},"credit":{"type":["string","null"]}}},"wordCount":{"type":"integer"},"body":{"type":"object","description":"Only with a key that has the full-text scope.","properties":{"html":{"type":"string"},"text":{"type":"string"}}},"attribution":{"type":"object","properties":{"publisher":{"type":"string"},"canonicalUrl":{"type":"string"},"id":{"type":"string"},"credit":{"type":"string"},"terms":{"type":"string"},"source":{"type":["object","null"],"properties":{"name":{"type":"string"},"url":{"type":"string"}}}}}}}}}}