{"name":"The Hindu News Articles API","description":"News articles from The Hindu's section pages, such as India, Science and Health, with headline, summary, author, section, image caption and article link.","api_id":"generated_3eb0d16897dd16d799cf741b","slug":"the-hindu-news-articles-api","source":{"name":"The Hindu","domain":"thehindu.com","url":"https://www.thehindu.com/"},"category":"news_content","countries":["IN"],"languages":["en"],"record_types":[],"tags":[],"limitations":[],"updated":"2026-11-17","note":"Sample records are saved samples, not a live run. CleanedWeb is not affiliated with the source.","version":"1.1","versions":[{"major":1,"latest_minor":"1.1","status":"current","sunset_at":null}],"changelog":[{"version":"1.1","date":"2026-11-17T04:59:33.000Z","kind":"minor","changes":[]},{"version":"1.0","date":"2026-11-15T07:57:35.000Z","kind":"major","changes":[]}],"version_note":"Pin a major with \"version\": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.","endpoints":[{"endpoint_id":"generated_3eb0d16897dd16d799cf741b_search","name":"Extract records","description":"Return records within the accepted scope.","definition_version":"67188c0324a43282c51d910537529ff573c9928af577d2773f68635afe219018","method":"POST","path":"/v1/catalog/public/apis/generated_3eb0d16897dd16d799cf741b/endpoints/generated_3eb0d16897dd16d799cf741b_search/run","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_3eb0d16897dd16d799cf741b/endpoints/generated_3eb0d16897dd16d799cf741b_search/run","authentication":{"type":"bearer","scheme":"Authorization: Bearer <API key>","scope":"run","note":"Reading this file and the live catalog needs no credential. A run needs a CleanedWeb account and uses the credits of its workspace.","docs":"https://cleanedweb.com/docs/run-catalog-api/"},"required_headers":[{"name":"Authorization","value":"Bearer YOUR_API_KEY","description":"An API key with the run scope."},{"name":"Idempotency-Key","value":"UNIQUE_REQUEST_ID","description":"Required. Save it before you send; reuse it only to retry the same request and to read the result. 1-200 characters: letters, numbers, . _ : -"},{"name":"Content-Type","value":"application/json","description":"The body is JSON."}],"request_body":{"input":"An object that follows input_schema.","max_items":"Optional. Stop after this many records.","timeout_seconds":"Optional, 60-86400, default 10800.","wait_seconds":"Optional, 0-86400, default 90. How long the request waits before answering 202.","version":"Optional integer major. Leave it out for the latest major."},"input_schema":{"type":"object","properties":{"collection":{"type":"string","enum":["India","Cities","Books","Entertainment","Data","Health","Science","News","Israel-US strikes on Iran","Delimitation","Ground Zero","Spotlight","Art","Dance","Movies","Music","Reviews","Theatre"],"description":"Choose an independently verified source collection/filter route. Omit it to read the pasted collection itself."},"category":{"x-enum-labels":["Health","Science","Technology","Agriculture"],"x-value-status":["verified","verified","verified","observed"],"x-source-key":"category","type":"string","pattern":"^[A-Za-z][A-Za-z\\-]{0,43}$","minLength":1,"maxLength":44,"examples":["health","science","technology","agriculture"],"x-open-values":true,"description":"Optional. The name of a page of the same kind as the pages the pasted one links (any name that fits the pattern; the examples are the names it links). The site decides: a name it does not serve is refused as input_value_unverified. Omit for the pasted page (its own name asks for it too). Setting this input runs the item's alternate html route (input_route:1), which reads the source page itself and is slower than the default route; limits and continuations are that route's; it does not deliver image_caption, institutional_subscriber_url, media, summary.","not":{"type":"string","pattern":"\\n"},"x-source-route":"path_segment","x-input-route":"input_route:1"},"enrich_records":{"type":"boolean","default":false,"description":"true: read each returned record's product/detail page and merge its fields into the record. false: return list/search-level fields only, with no detail page reads. Every returned record's detail page is read within the run's time budget; records the time budget leaves unread are returned without detail fields, and summary.record_enrichment reports how many records were enriched and why any were not (run_time_budget). Detail fields are optional."}},"required":[],"additionalProperties":false},"output_schema":{"type":"object","additionalProperties":false,"required":["title","url"],"properties":{"alt":{"type":["string"]},"author":{"type":"string"},"author_url":{"type":"string"},"device_variant":{"type":["string"]},"original":{"type":["string"]},"src":{"type":["string"]},"src_template":{"type":["string"]},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"category":{"type":"string"},"category_path":{"type":"array","items":{"type":"string"}},"institutional_subscriber_url":{"type":"string","description":"institutional subscriber url"},"media":{"type":"array","items":{"type":"object","additionalProperties":{"type":["string","number","array"],"items":{"type":"string"}}},"description":"media"},"summary":{"type":"string"},"image_caption":{"type":"string"}}},"examples":[{"kind":"saved_validation_records","saved_at":"2026-11-17T04:59:33.880Z","live_verified":false,"request":{"input":{}},"records_shown":2,"records_saved":2,"records":[{"alt":"Shiv Sena (UBT) leader and former Maharashtra Environment Minister Aaditya Thackeray. File","author":"Yohaan Varghese","author_url":"https://www.thehindu.com/profile/author/yohaan-varghese-30395/","category":"Environment","category_path":["Sci-Tech","Environment"],"device_variant":"SQUARE~SQUARE~SQUARE~SQUARE","image_caption":"Shiv Sena (UBT) leader and former Maharashtra Environment Minister Aaditya Thackeray. File | Photo Credit: EMMANUAL YOGINI","institutional_subscriber_url":"https://forms.office.com/r/tz7UETzxUs","original":"https://th-i.thgim.com/public/incoming/rsz3r1/article71698505.ece/alternates/SQUARE_80/11908_28_5_2025_18_38_37_2_DSC_4903.JPG","src":"https://www.thehindu.com/theme/images/th-online/1x1_spacer.png","src_template":"https://th-i.thgim.com/public/incoming/rsz3r1/article71698505.ece/alternates/SQUARE_80/11908_28_5_2025_18_38_37_2_DSC_4903.JPG","summary":"At the State level, he proposed similar councils chaired by the respective Chief Ministers, with participation from relevant departments to monitor the implementation of climate action plans","title":"Aaditya Thackeray calls for Climate Change Councils at Centre, State levels to tackle pollution","url":"https://www.thehindu.com/sci-tech/energy-and-environment/aaditya-thackeray-calls-for-climate-change-councils-at-centre-state-levels-to-tackle-pollution/article71698204.ece"},{"alt":"Paris Agreement, a legally binding treaty to limit temperature rise adopted at the COP 21 held in the city housing this famous monument.","author":"Vighnesh P. Venkitesh","author_url":"https://www.thehindu.com/profile/author/vighnesh-p-venkitesh-20060/","category":"Environment","category_path":["Sci-Tech","Environment"],"device_variant":"SQUARE~SQUARE~SQUARE~SQUARE","image_caption":"Paris Agreement, a legally binding treaty to limit temperature rise adopted at the COP 21 held in the city housing this famous monument. | Photo Credit: Reuters","institutional_subscriber_url":"https://forms.office.com/r/tz7UETzxUs","original":"https://th-i.thgim.com/public/sci-tech/energy-and-environment/4ctjoz/article71696568.ece/alternates/SQUARE_80/Quiz.jpg","src":"https://www.thehindu.com/theme/images/th-online/1x1_spacer.png","src_template":"https://th-i.thgim.com/public/sci-tech/energy-and-environment/4ctjoz/article71696568.ece/alternates/SQUARE_80/Quiz.jpg","summary":"As the COP 31 kicked off in Turkiye on Monday (November 9, 2026), a quiz on the annual gatherings which have delivered some landmark treaties to address the climate crisis","title":"Daily Quiz: On Climate Change summit","url":"https://www.thehindu.com/sci-tech/energy-and-environment/daily-quiz-on-climate-change-summit/article71696564.ece"}]}],"request_example":{"body":{"input":{"category":"Environment"},"version":1,"max_items":25},"curl":"curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_3eb0d16897dd16d799cf741b/endpoints/generated_3eb0d16897dd16d799cf741b_search/run \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Idempotency-Key: UNIQUE_REQUEST_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"input\": {\n    \"category\": \"Environment\"\n  },\n  \"version\": 1,\n  \"max_items\": 25\n}'"},"result":{"method":"GET","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_3eb0d16897dd16d799cf741b/endpoints/generated_3eb0d16897dd16d799cf741b_search/result","note":"A run that does not end within wait_seconds answers 202. Read the result with the same API key and the same Idempotency-Key."},"links":{"page":"https://cleanedweb.com/catalog/the-hindu-news-articles-api/","markdown":"https://cleanedweb.com/catalog/the-hindu-news-articles-api/index.md","live_contract":"https://app.cleanedweb.com/api/catalog/apis/generated_3eb0d16897dd16d799cf741b/endpoints/generated_3eb0d16897dd16d799cf741b_search/contract","run_docs":"https://cleanedweb.com/docs/run-catalog-api/"}}],"links":{"page":"https://cleanedweb.com/catalog/the-hindu-news-articles-api/","markdown":"https://cleanedweb.com/catalog/the-hindu-news-articles-api/index.md","contract":"https://cleanedweb.com/catalog/the-hindu-news-articles-api/contract.json","catalog":"https://cleanedweb.com/catalog/","index":"https://cleanedweb.com/catalog/index.json","openapi":"https://cleanedweb.com/catalog/openapi.json"}}
