hydrafetch 0.5.0__tar.gz → 0.6.0__tar.gz

{hydrafetch-0.5.0 → hydrafetch-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: hydrafetch
-Version: 0.5.0
+Version: 0.6.0
 Summary: Official Python client for the Hydrafetch web data API. Turn any URL into clean Markdown and structured data.
 Project-URL: Homepage, https://hydrafetch.com
 Project-URL: Documentation, https://docs.hydrafetch.com
@@ -165,6 +165,19 @@ for r in res["results"]:
     print(((r.get("data") or {}).get("markdown") or "")[:500])
 ```
 
+## News
+
+Find recent news articles about anything, newest first, each with its outlet and publish time:
+
+```python
+found = hf.news("acme raises funding", timeRange="week", limit=10)
+
+for article in found["results"]:
+    print(article["publishedAt"], article["source"], article["title"], article["url"])
+```
+
+A news search costs 1 credit, and one that finds nothing is free. Pass `scrapeResults=True` to also read each article as clean data, at 1 extra credit per article.
+
 ## Jobs
 
 Search open jobs collected from company career sites and hiring platforms, by the words in the job title:
@@ -293,6 +306,7 @@ hf = Hydrafetch(
 | `markdown(url, **options)` | `str` | 1 |
 | `map(url, **options)` | links dict | 1 |
 | `search(query, **options)` | results dict | 1 + 1 per scraped result |
+| `news(query, **options)` | articles, newest first | 1 + 1 per article read; free when empty |
 | `search_jobs(query, **options)` | list of jobs | 1 per 10 jobs |
 | `hiring_changes(domains, since, **options)` | list of companies | 1 per company with jobs |
 | `extract(urls, **options)` | dict with `"results"` | 5 per URL |

{hydrafetch-0.5.0 → hydrafetch-0.6.0}/README.md

@@ -142,6 +142,19 @@ for r in res["results"]:
     print(((r.get("data") or {}).get("markdown") or "")[:500])
 ```
 
+## News
+
+Find recent news articles about anything, newest first, each with its outlet and publish time:
+
+```python
+found = hf.news("acme raises funding", timeRange="week", limit=10)
+
+for article in found["results"]:
+    print(article["publishedAt"], article["source"], article["title"], article["url"])
+```
+
+A news search costs 1 credit, and one that finds nothing is free. Pass `scrapeResults=True` to also read each article as clean data, at 1 extra credit per article.
+
 ## Jobs
 
 Search open jobs collected from company career sites and hiring platforms, by the words in the job title:
@@ -270,6 +283,7 @@ hf = Hydrafetch(
 | `markdown(url, **options)` | `str` | 1 |
 | `map(url, **options)` | links dict | 1 |
 | `search(query, **options)` | results dict | 1 + 1 per scraped result |
+| `news(query, **options)` | articles, newest first | 1 + 1 per article read; free when empty |
 | `search_jobs(query, **options)` | list of jobs | 1 per 10 jobs |
 | `hiring_changes(domains, since, **options)` | list of companies | 1 per company with jobs |
 | `extract(urls, **options)` | dict with `"results"` | 5 per URL |

{hydrafetch-0.5.0 → hydrafetch-0.6.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "hydrafetch"
-version = "0.5.0"
+version = "0.6.0"
 description = "Official Python client for the Hydrafetch web data API. Turn any URL into clean Markdown and structured data."
 readme = "README.md"
 license = "MIT"

{hydrafetch-0.5.0 → hydrafetch-0.6.0}/src/hydrafetch/__init__.py

@@ -4,4 +4,4 @@ from ._client import AsyncHydrafetch, Hydrafetch
 from .errors import HydrafetchError, HydrafetchTimeout
 
 __all__ = ["AsyncHydrafetch", "Hydrafetch", "HydrafetchError", "HydrafetchTimeout"]
-__version__ = "0.5.0"
+__version__ = "0.6.0"

{hydrafetch-0.5.0 → hydrafetch-0.6.0}/src/hydrafetch/_client.py

@@ -214,6 +214,9 @@ class Hydrafetch(_Base):
     def search(self, query: str, **options: Any) -> dict[str, Any]:
         return self._request("POST", "/v1/web/search", json={"query": query, **_drop_none(options)})
 
+    def news(self, query: str, **options: Any) -> dict[str, Any]:
+        return self._request("POST", "/v1/web/news", json={"query": query, **_drop_none(options)})
+
     def search_jobs(self, query: str, **options: Any) -> list[dict[str, Any]]:
         return self._request(
             "POST", "/v1/web/index/jobs/search", json={"query": query, **_drop_none(options)}
@@ -386,6 +389,11 @@ class AsyncHydrafetch(_Base):
             "POST", "/v1/web/search", json={"query": query, **_drop_none(options)}
         )
 
+    async def news(self, query: str, **options: Any) -> dict[str, Any]:
+        return await self._request(
+            "POST", "/v1/web/news", json={"query": query, **_drop_none(options)}
+        )
+
     async def search_jobs(self, query: str, **options: Any) -> list[dict[str, Any]]:
         return await self._request(
             "POST", "/v1/web/index/jobs/search", json={"query": query, **_drop_none(options)}

{hydrafetch-0.5.0 → hydrafetch-0.6.0}/tests/test_client.py

@@ -325,3 +325,13 @@ def test_hiring_changes_takes_one_domain_or_many_and_a_datetime() -> None:
         "since": "2026-10-01",
         "includeDescriptions": True,
     }
+
+
+def test_news_posts_the_query_and_window() -> None:
+    found = {"query": "acme raises", "status": "ok", "results": [{"title": "Acme raises $10M"}]}
+    rec = Recorder({"success": True, "data": found})
+    client = make_client(rec)
+    out = client.news("acme raises", timeRange="day", limit=5, country=None)
+    assert out == found
+    assert rec.last.url.path == "/v1/web/news"
+    assert json.loads(rec.last.content) == {"query": "acme raises", "timeRange": "day", "limit": 5}

{hydrafetch-0.5.0 → hydrafetch-0.6.0}/uv.lock

@@ -143,7 +143,7 @@ wheels = [
 
 [[package]]
 name = "hydrafetch"
-version = "0.5.0"
+version = "0.6.0"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },