[Docs](/docs) / News # News GA `news_search` is keyword search over news articles only, ranked by relevance with a boost for fresher articles. Its `near` filter finds articles by place, and every result shows the evidence for where it is located. ## Call it `news_search` and `web_fetch` are served on `/news` and, like every tool you have switched on, on `/mcp`. Open a result with `web_fetch` to read the article. ``` https://mcp.deep.navy/news ``` ``` https://mcp.deep.navy/mcp ``` ## Filters Up to 100 results per call, 10 by default. **Time.** `recency` keeps articles from the last hour, day, week, month or year (`RECENCY_HOUR` to `RECENCY_YEAR`), and `publishedAfter` and `publishedBefore` bound the publication time. **Domains.** `includeDomains` keeps only articles from up to 50 domains and their subdomains, and `excludeDomains` drops them. Articles are discovered through the feeds and news sitemaps of known news hosts and through the CC-NEWS dataset, synced every hour, and a page is labelled news by rule `news.v1` only when it came from one of those routes and declares a publication date. ## Location Each article carries location signals assigned at indexing by rule `geo.news.v1`, each stored with its evidence. Nothing is guessed from body text, and an ambiguous name stores no signal. | Basis | Means | Read from | | --------------- | ------------------------------------ | ------------------------------------------------------------------- | | BASIS_CONTENT | The story is about this place. | The page's schema.org contentLocation or spatialCoverage. | | BASIS_DATELINE | The story was filed from this place. | The dateline the article opens with, such as "PORTLAND, Ore. (AP)". | | BASIS_PUBLISHER | The outlet is local to this place. | The Wikidata place of publication of the article's publisher. | **The area.** `near` takes one of a `place` name, an Overture `divisionId` from `geo_places`, a `circle` (a `center` with `lon` and `lat` and a `radiusKm` up to 2,000) or a `bbox`. A place name uses administrative containment, so "California" matches an article located in Los Angeles. **The basis.** `near.basis` picks which signals count. By default `BASIS_CONTENT` and `BASIS_DATELINE` count, so "filed from Kyiv" and "a Kyiv local paper" stay distinguishable; add `BASIS_PUBLISHER` to include local outlets. ## news_search GA It returns the matching articles with their publisher, author, publication time, a matching passage and a score, and each article's location signals with the rule and the text that produced them. ### What comes back | Field | Type | Meaning | | ------------------------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | results | NewsResult\[] | They are the matching articles, best first. | | results.​url | string | It is the article's URL. Open it with `web_fetch`. | | results.​title | string | It is the article's headline. | | results.​publishedAt | timestamp | It is the publication time the article declares. | | results.​publisher | string | It is the site name as the publisher declares it, such as "Los Angeles Times". | | results.​author | string | It is the byline the article declares. | | results.​snippet | string | It is a matching passage from the article, empty when the page sets `nosnippet`. | | results.​score | float | It is the relevance with the freshness boost. Scores compare within one response only. | | results.​locations | Location\[] | They are the article's location signals, so you can see why it matched a `near` filter. | | results.​locations.​basis | Basis | It is `BASIS_CONTENT` for the place the story is about, `BASIS_DATELINE` for where it was filed, or `BASIS_PUBLISHER` for where the outlet is based. | | results.​locations.​divisionId · name | string | They are the Overture division the signal points to and its name. | | results.​locations.​ancestorIds | string\[] | They are the ids of the containing divisions, largest first. | | results.​locations.​point | Point | It is the division's centre, as `lon` and `lat`. | | results.​locations.​ruleId | string | It is the rule that produced the signal, such as `geo.news.v1/dateline`. | | results.​locations.​evidence | string | It is the matched text or property, such as the dateline `SAN DIEGO-` or the publisher's domain and Wikidata QID. | Unset optional fields are omitted; explicitly set zero and false values are preserved. Empty lists are explicit arrays, and 64-bit integers are strings, as protojson writes them. `news_search` ### Search this week's news A keyword search over articles published in the last seven days, ranked by relevance with a boost for fresher articles. **Request** ``` { "query": "Nobel", "numResults": 3, "recency": "RECENCY_WEEK" } ``` **Response** ``` { "results": [ { "url": "https://www.radioiasi.ro/stiri/prim-plan/nobel-2026-karl-deisseroth-peter-hegemann-si-georg-nagel-laureatii-premiului-nobel-pentru-medicina/", "title": "Nobel 2026: Karl Deisseroth, Peter Hegemann şi Georg Nagel, laureaţii Premiului Nobel pentru Medicină", "publishedAt": "2026-10-05T09:35:27Z", "publisher": "Radio Iaşi – Cel mai ascultat radio regional - știri, muzică și evenimente", "author": "Gabriela Rotaru", "snippet": "Premiile Nobel sunt înmânate laureaţilor, anual, la data de 10 decembrie, ziua morţii lui Alfred Nobel. (Agerpres/ FOTO edupedu.ro)", "score": 0.5 }, { "url": "https://www.boursorama.com/actualite-economique/actualites/cinq-choses-a-savoir-sur-les-prix-nobel-1bf383570294ca66e7383158511fb886", "title": "Cinq choses à savoir sur les prix Nobel", "publishedAt": "2026-10-05T06:03:09Z", "publisher": "Boursorama.com", "author": "AFP", "snippet": "Un buste du Suédois Alfred Nobel devant l'Institut Nobel norvégien à Oslo, en Norvège, le 8 janvier 2026 ( AFP / Jonathan NACKSTRAND )\nLes prix Nobel sont attribués entre les 5 et 12 octobre à Stockholm", "score": 0.5 }, { "url": "https://en.prothomalo.com/international/arivttmlsz", "title": "Five things to know about the Nobel Prize", "publishedAt": "2026-10-05T07:10:52Z", "publisher": "Prothom Alo English", "author": "AFP", "snippet": "prizes' founder, inventor Alfred Nobel.", "score": 0.42400587 } ] } ``` Captured 2026-10-05 17:28 UTC from production `news_search` ### News filed from California Articles whose dateline places them in California; San Diego matches by administrative containment, and each result shows the dateline text it matched on. **Request** ``` { "query": "contract", "numResults": 3, "recency": "RECENCY_WEEK", "near": { "place": "California", "basis": [ "BASIS_DATELINE" ] } } ``` **Response** ``` { "results": [ { "url": "https://www.biospace.com/press-releases/exthymic-secures-up-to-25m-arpa-h-contract-to-enable-hospital-based-cell-therapy-production-prototype", "title": "Exthymic Secures up to $25M ARPA-H Contract to Enable Hospital-Based Cell Therapy Production Prototype", "publishedAt": "2026-10-05T13:48:04.298Z", "publisher": "BioSpace", "author": "Gabrielle Masson", "snippet": "Department of Health and Human Services, has awarded Exthymic a contract to develop a cell therapy device to address key issues underlying patient access and affordability.", "score": 0.5005, "locations": [ { "basis": "BASIS_DATELINE", "divisionId": "404bedf1-d466-49e6-a1c7-5b21bbb63272", "name": "San Diego", "ancestorIds": [ "f39eb4af-5206-481b-b19e-bd784ded3f05", "4c555166-326b-48b4-8a33-155eb7c23e8d", "64f3a908-7db6-42fb-9e77-c49de3f0bd2d" ], "point": { "lon": -117.13342518227492, "lat": 32.81681803554754 }, "ruleId": "geo.news.v1/dateline", "evidence": "SAN DIEGO-" } ] }, { "url": "https://www.adnkronos.com/immediapress/eng/singcore-unveils-s1-pro-an-all-in-one-ai-karaoke-system-launching-on-kickstarter-in-october-2026_1oV7axtO7Rg690rHjTsdjI", "title": "Singcore Unveils S1 Pro: an All-in-One AI Karaoke System Launching on Kickstarter in October 2026", "publishedAt": "2026-10-02T01:04:00Z", "publisher": "Adnkronos", "author": "Redazione Adnkronos", "snippet": "RANCHO CUCAMONGA, Calif., Oct. 2, 2026 /PRNewswire/ -- Singcore, an AI singing entertainment brand, announces the upcoming launch of its all-in-one AI karaoke system, Singcore S1 Pro, on Kickstarter in", "score": 0.5, "locations": [ { "basis": "BASIS_DATELINE", "divisionId": "5a7842b9-02d8-4549-a7d1-bd9ba80e3553", "name": "Rancho Cucamonga", "ancestorIds": [ "f39eb4af-5206-481b-b19e-bd784ded3f05", "4c555166-326b-48b4-8a33-155eb7c23e8d", "ae9c832a-d4b4-42a5-b601-fef7dc4787f1" ], "point": { "lon": -117.56200179807384, "lat": 34.1303570543043 }, "ruleId": "geo.news.v1/dateline", "evidence": "RANCHO CUCAMONGA, Calif.," } ] }, { "url": "https://www.finanznachrichten.de/nachrichten-2026-10/69756472-presidio-property-trust-announces-expiration-and-results-of-exchange-offer-for-all-outstanding-shares-of-its-series-d-preferred-stock-200.htm", "title": "Presidio Property Trust Announces Expiration and Results of Exchange Offer for All Outstanding Shares of its Series D Preferred Stock", "publishedAt": "2026-10-05T00:00:00Z", "publisher": "FinanzNachrichten.de", "snippet": "SAN DIEGO, CA / ACCESS Newswire / October 5, 2026 / (NASDAQ:SQFT)(NASDAQ:SQFTP)(NASDAQ:SQFTW) Presidio Property Trust, Inc. (\"Presidio\" or the \"Company\"), an internally managed, diversified real estate", "score": 0.12800528, "locations": [ { "basis": "BASIS_DATELINE", "divisionId": "404bedf1-d466-49e6-a1c7-5b21bbb63272", "name": "San Diego", "ancestorIds": [ "f39eb4af-5206-481b-b19e-bd784ded3f05", "4c555166-326b-48b4-8a33-155eb7c23e8d", "64f3a908-7db6-42fb-9e77-c49de3f0bd2d" ], "point": { "lon": -117.13342518227492, "lat": 32.81681803554754 }, "ruleId": "geo.news.v1/dateline", "evidence": "SAN DIEGO," } ] } ] } ``` Captured 2026-10-05 17:28 UTC from production `news_search` ### Local outlets within 50 km of Los Angeles Articles from publishers based within a 50 km circle around downtown Los Angeles, matched on the publisher's Wikidata place of publication. **Request** ``` { "query": "city council", "numResults": 3, "near": { "circle": { "center": { "lon": -118.2437, "lat": 34.0522 }, "radiusKm": 50 }, "basis": [ "BASIS_PUBLISHER" ] } } ``` **Response** ``` { "results": [ { "url": "https://www.latimes.com/world-nation/story/2026-10-04/yemens-government-declares-major-operation-against-houthis", "title": "Yemen's government declares a major operation against the Houthis", "publishedAt": "2026-10-04T18:06:13.427Z", "publisher": "Los Angeles Times", "author": "Associated Press", "snippet": "The Houthis have launched a major offensive in recent days against government forces and their allies on the outskirts of Taiz, disrupting a major road linking the city to the port city of Aden, the seat", "score": 0.5, "locations": [ { "basis": "BASIS_PUBLISHER", "divisionId": "5b65e181-2321-4234-88a0-89d92680c036", "name": "Los Angeles", "ancestorIds": [ "f39eb4af-5206-481b-b19e-bd784ded3f05", "4c555166-326b-48b4-8a33-155eb7c23e8d", "9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb" ], "point": { "lon": -118.40721994057964, "lat": 34.08953853340753 }, "ruleId": "geo.news.v1/publisher", "evidence": "www.latimes.com Q55665592" }, { "basis": "BASIS_PUBLISHER", "divisionId": "1818d3a1-16de-476e-9120-c0380b9d3359", "name": "Costa Mesa", "ancestorIds": [ "f39eb4af-5206-481b-b19e-bd784ded3f05", "4c555166-326b-48b4-8a33-155eb7c23e8d", "603bd196-dd4e-49e2-baaa-7b050c366032" ], "point": { "lon": -117.9134364220198, "lat": 33.66671575868219 }, "ruleId": "geo.news.v1/publisher", "evidence": "www.latimes.com Q55665592" }, { "basis": "BASIS_PUBLISHER", "divisionId": "111c37d9-3e49-4feb-83fb-e973b35a9e07", "name": "El Segundo", "ancestorIds": [ "f39eb4af-5206-481b-b19e-bd784ded3f05", "4c555166-326b-48b4-8a33-155eb7c23e8d", "9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb" ], "point": { "lon": -118.43124823401462, "lat": 33.91152851617659 }, "ruleId": "geo.news.v1/publisher", "evidence": "www.latimes.com Q55665592" } ] }, { "url": "https://www.latimes.com/california/story/2026-10-01/2026-california-election-los-angeles-city-amendment-ee-voter-guide", "title": "Your guide to L.A. City Charter Amendment EE: City Council meetings, ethics and elections", "publishedAt": "2026-10-01T10:00:00Z", "publisher": "Los Angeles Times", "author": "Sandra McDonald", "snippet": "A final change proposed by the amendment would clarify the definition of a “stakeholder” in the charter as it relates to who can sit on a neighborhood council, which makes recommendations to the City Council", "score": 0.5, "locations": [ { "basis": "BASIS_PUBLISHER", "divisionId": "5b65e181-2321-4234-88a0-89d92680c036", "name": "Los Angeles", "ancestorIds": [ "f39eb4af-5206-481b-b19e-bd784ded3f05", "4c555166-326b-48b4-8a33-155eb7c23e8d", "9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb" ], "point": { "lon": -118.40721994057964, "lat": 34.08953853340753 }, "ruleId": "geo.news.v1/publisher", "evidence": "www.latimes.com Q55665592" }, { "basis": "BASIS_PUBLISHER", "divisionId": "1818d3a1-16de-476e-9120-c0380b9d3359", "name": "Costa Mesa", "ancestorIds": [ "f39eb4af-5206-481b-b19e-bd784ded3f05", "4c555166-326b-48b4-8a33-155eb7c23e8d", "603bd196-dd4e-49e2-baaa-7b050c366032" ], "point": { "lon": -117.9134364220198, "lat": 33.66671575868219 }, "ruleId": "geo.news.v1/publisher", "evidence": "www.latimes.com Q55665592" }, { "basis": "BASIS_PUBLISHER", "divisionId": "111c37d9-3e49-4feb-83fb-e973b35a9e07", "name": "El Segundo", "ancestorIds": [ "f39eb4af-5206-481b-b19e-bd784ded3f05", "4c555166-326b-48b4-8a33-155eb7c23e8d", "9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb" ], "point": { "lon": -118.43124823401462, "lat": 33.91152851617659 }, "ruleId": "geo.news.v1/publisher", "evidence": "www.latimes.com Q55665592" } ] }, { "url": "https://www.latimes.com/world-nation/story/2026-10-05/saudi-led-coalition-says-its-fighter-jets-are-bombing-yemens-iran-backed-houthi-rebels", "title": "A Saudi-led coalition says its fighter jets are bombing Yemen's Iran-backed Houthi rebels", "publishedAt": "2026-10-05T16:30:34.540Z", "publisher": "Los Angeles Times", "author": "Ahmed Al-Haj; Samy Magdy", "snippet": "Rashad al-Alimi, head of the ruling Presidential Leadership Council, said in a televised speech that the operations were aiming at “recovering the remaining territories” controlled by the Houthis.", "score": 0.076434955, "locations": [ { "basis": "BASIS_PUBLISHER", "divisionId": "5b65e181-2321-4234-88a0-89d92680c036", "name": "Los Angeles", "ancestorIds": [ "f39eb4af-5206-481b-b19e-bd784ded3f05", "4c555166-326b-48b4-8a33-155eb7c23e8d", "9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb" ], "point": { "lon": -118.40721994057964, "lat": 34.08953853340753 }, "ruleId": "geo.news.v1/publisher", "evidence": "www.latimes.com Q55665592" }, { "basis": "BASIS_PUBLISHER", "divisionId": "1818d3a1-16de-476e-9120-c0380b9d3359", "name": "Costa Mesa", "ancestorIds": [ "f39eb4af-5206-481b-b19e-bd784ded3f05", "4c555166-326b-48b4-8a33-155eb7c23e8d", "603bd196-dd4e-49e2-baaa-7b050c366032" ], "point": { "lon": -117.9134364220198, "lat": 33.66671575868219 }, "ruleId": "geo.news.v1/publisher", "evidence": "www.latimes.com Q55665592" }, { "basis": "BASIS_PUBLISHER", "divisionId": "111c37d9-3e49-4feb-83fb-e973b35a9e07", "name": "El Segundo", "ancestorIds": [ "f39eb4af-5206-481b-b19e-bd784ded3f05", "4c555166-326b-48b4-8a33-155eb7c23e8d", "9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb" ], "point": { "lon": -118.43124823401462, "lat": 33.91152851617659 }, "ruleId": "geo.news.v1/publisher", "evidence": "www.latimes.com Q55665592" } ] } ] } ``` Captured 2026-10-05 17:28 UTC from production Read [provenance and trust](/docs/provenance) for source timestamps, historical limitations and handling untrusted text. See [limits and errors](/docs/limits) for request receipts and retry behavior. --- This is the Markdown copy of https://deep.navy/docs/news.