fix: Add countries_blacklist as an option

Author: robcaulk

asknews_sdk/api/news.py

@@ -93,6 +93,7 @@ def search_news(
         return_graphs: Optional[bool] = False,
         return_geo: Optional[bool] = False,
         countries: Optional[List[str]] = None,
+        countries_blacklist: Optional[List[str]] = None,
         languages: Optional[List[str]] = None,
         continents: Optional[List[str]] = None,
         sentiment: Optional[Literal["negative", "neutral", "positive"]] = None,
@@ -193,6 +194,7 @@ def search_news(
                 "return_graphs": return_graphs,
                 "return_geo": return_geo,
                 "countries": countries,
+                "countries_blacklist": countries_blacklist,
                 "languages": languages,
                 "continents": continents,
                 "sentiment": sentiment,
@@ -395,6 +397,7 @@ async def search_news(
         return_graphs: Optional[bool] = False,
         return_geo: Optional[bool] = False,
         countries: Optional[List[str]] = None,
+        countries_blacklist: Optional[List[str]] = None,
         languages: Optional[List[str]] = None,
         continents: Optional[List[str]] = None,
         sentiment: Optional[Literal["negative", "neutral", "positive"]] = None,
@@ -495,6 +498,7 @@ async def search_news(
                 "return_graphs": return_graphs,
                 "return_geo": return_geo,
                 "countries": countries,
+                "countries_blacklist": countries_blacklist,
                 "languages": languages,
                 "continents": continents,
                 "sentiment": sentiment,

asknews_sdk/dto/common.py

@@ -260,7 +260,19 @@ class FilterParams(BaseModel):
     )
     countries: Optional[List[str]] = Field(
         None,
-        description="Countries to filter by, this is the two-letter ISO country code"
+        description="Source countries to filter by (this is only for the publisher location, "
+        "not the locations mentioned in articles. For "
+        "Locations mentioned in articles, refer to entity_guarantee)"
+        ", countries must be the two-letter ISO country code"
+        "For example: United States is 'US', France is 'FR', Sweden is 'SE'.",
+    )
+    countries_blacklist: Optional[List[str]] = Field(
+        None,
+        description="Source countries to blacklist from search "
+        "(this is only for the publisher location, "
+        "not the locations mentioned in articles. For Locations mentioned in articles, "
+        "refer to reverse_entity_guarantee)"
+        ", countries must be the two-letter ISO country code"
         "For example: United States is 'US', France is 'FR', Sweden is 'SE'.",
     )
     continents: Optional[