unique-search-proxy-sdk 2026.44.0.dev1__tar.gz → 2026.44.0.dev3__tar.gz

{unique_search_proxy_sdk-2026.44.0.dev1 → unique_search_proxy_sdk-2026.44.0.dev3}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.3
 Name: unique-search-proxy-sdk
-Version: 2026.44.0.dev1
+Version: 2026.44.0.dev3
 Summary: Async HTTP client for the Unique Search Proxy API
 Author: ThePhilAz
 Author-email: ThePhilAz <rami.azouz@philico.com>
 Requires-Dist: attrs>=24.3.0,<26
 Requires-Dist: httpx>=0.28.0,<0.29.0
 Requires-Dist: pydantic>=2.12.5,<3.0.0
-Requires-Dist: unique-search-proxy-core>=2026.44.0.dev2,<2026.44.0rc0
+Requires-Dist: unique-search-proxy-core>=2026.44.0.dev5,<2026.44.0rc0
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 

{unique_search_proxy_sdk-2026.44.0.dev1 → unique_search_proxy_sdk-2026.44.0.dev3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "unique-search-proxy-sdk"
-version = "2026.44.0.dev1"
+version = "2026.44.0.dev3"
 description = "Async HTTP client for the Unique Search Proxy API"
 authors = [{ name = "ThePhilAz", email = "rami.azouz@philico.com" }]
 readme = "README.md"
@@ -9,7 +9,7 @@ dependencies = [
     "attrs>=24.3.0,<26",
     "httpx>=0.28.0,<0.29.0",
     "pydantic>=2.12.5,<3.0.0",
-    "unique-search-proxy-core>=2026.44.0.dev2,<2026.44.0rc0",
+    "unique-search-proxy-core>=2026.44.0.dev5,<2026.44.0rc0",
 ]
 
 [dependency-groups]

{unique_search_proxy_sdk-2026.44.0.dev1 → unique_search_proxy_sdk-2026.44.0.dev3}/unique_search_proxy_sdk/_generated/api/search/search_v1_search_post.py

@@ -6,6 +6,7 @@ import httpx
 from ... import errors
 from ...client import AuthenticatedClient, Client
 from ...models.brave_search_request import BraveSearchRequest
+from ...models.custom_api_search_request import CustomApiSearchRequest
 from ...models.google_search_request import GoogleSearchRequest
 from ...models.http_validation_error import HTTPValidationError
 from ...models.perplexity_search_request import PerplexitySearchRequest
@@ -15,7 +16,10 @@ from ...types import Response, Unset
 
 def _get_kwargs(
     *,
-    body: BraveSearchRequest | GoogleSearchRequest | PerplexitySearchRequest,
+    body: BraveSearchRequest
+    | CustomApiSearchRequest
+    | GoogleSearchRequest
+    | PerplexitySearchRequest,
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
@@ -39,6 +43,8 @@ def _get_kwargs(
         _kwargs["json"] = body.to_dict()
     elif isinstance(body, BraveSearchRequest):
         _kwargs["json"] = body.to_dict()
+    elif isinstance(body, PerplexitySearchRequest):
+        _kwargs["json"] = body.to_dict()
     else:
         _kwargs["json"] = body.to_dict()
 
@@ -81,7 +87,10 @@ def _build_response(
 def sync_detailed(
     *,
     client: AuthenticatedClient | Client,
-    body: BraveSearchRequest | GoogleSearchRequest | PerplexitySearchRequest,
+    body: BraveSearchRequest
+    | CustomApiSearchRequest
+    | GoogleSearchRequest
+    | PerplexitySearchRequest,
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
@@ -92,7 +101,8 @@ def sync_detailed(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
-        body (BraveSearchRequest | GoogleSearchRequest | PerplexitySearchRequest):
+        body (BraveSearchRequest | CustomApiSearchRequest | GoogleSearchRequest |
+            PerplexitySearchRequest):
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -119,7 +129,10 @@ def sync_detailed(
 def sync(
     *,
     client: AuthenticatedClient | Client,
-    body: BraveSearchRequest | GoogleSearchRequest | PerplexitySearchRequest,
+    body: BraveSearchRequest
+    | CustomApiSearchRequest
+    | GoogleSearchRequest
+    | PerplexitySearchRequest,
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
@@ -130,7 +143,8 @@ def sync(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
-        body (BraveSearchRequest | GoogleSearchRequest | PerplexitySearchRequest):
+        body (BraveSearchRequest | CustomApiSearchRequest | GoogleSearchRequest |
+            PerplexitySearchRequest):
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -152,7 +166,10 @@ def sync(
 async def asyncio_detailed(
     *,
     client: AuthenticatedClient | Client,
-    body: BraveSearchRequest | GoogleSearchRequest | PerplexitySearchRequest,
+    body: BraveSearchRequest
+    | CustomApiSearchRequest
+    | GoogleSearchRequest
+    | PerplexitySearchRequest,
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
@@ -163,7 +180,8 @@ async def asyncio_detailed(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
-        body (BraveSearchRequest | GoogleSearchRequest | PerplexitySearchRequest):
+        body (BraveSearchRequest | CustomApiSearchRequest | GoogleSearchRequest |
+            PerplexitySearchRequest):
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -188,7 +206,10 @@ async def asyncio_detailed(
 async def asyncio(
     *,
     client: AuthenticatedClient | Client,
-    body: BraveSearchRequest | GoogleSearchRequest | PerplexitySearchRequest,
+    body: BraveSearchRequest
+    | CustomApiSearchRequest
+    | GoogleSearchRequest
+    | PerplexitySearchRequest,
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
@@ -199,7 +220,8 @@ async def asyncio(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
-        body (BraveSearchRequest | GoogleSearchRequest | PerplexitySearchRequest):
+        body (BraveSearchRequest | CustomApiSearchRequest | GoogleSearchRequest |
+            PerplexitySearchRequest):
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

{unique_search_proxy_sdk-2026.44.0.dev1 → unique_search_proxy_sdk-2026.44.0.dev3}/unique_search_proxy_sdk/_generated/models/__init__.py

@@ -19,6 +19,8 @@ from .brave_search_request_units_type_0 import BraveSearchRequestUnitsType0
 from .content_types import ContentTypes
 from .crawl_response import CrawlResponse
 from .crawl_url_result import CrawlUrlResult
+from .custom_api_request_method import CustomApiRequestMethod
+from .custom_api_search_request import CustomApiSearchRequest
 from .firecrawl_crawl_request import FirecrawlCrawlRequest
 from .firecrawl_crawl_request_proxy_mode import FirecrawlCrawlRequestProxyMode
 from .firecrawl_crawl_request_scrape_headers_type_0 import (
@@ -72,6 +74,8 @@ __all__ = (
     "ContentTypes",
     "CrawlResponse",
     "CrawlUrlResult",
+    "CustomApiRequestMethod",
+    "CustomApiSearchRequest",
     "FirecrawlCrawlRequest",
     "FirecrawlCrawlRequestProxyMode",
     "FirecrawlCrawlRequestScrapeHeadersType0",

unique_search_proxy_sdk-2026.44.0.dev3/unique_search_proxy_sdk/_generated/models/custom_api_request_method.py

@@ -0,0 +1,9 @@
+from enum import Enum
+
+
+class CustomApiRequestMethod(str, Enum):
+    GET = "GET"
+    POST = "POST"
+
+    def __str__(self) -> str:
+        return str(self.value)

unique_search_proxy_sdk-2026.44.0.dev3/unique_search_proxy_sdk/_generated/models/custom_api_search_request.py

@@ -0,0 +1,144 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import (
+    Any,
+    Literal,
+    TypeVar,
+    cast,
+)
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..models.custom_api_request_method import CustomApiRequestMethod
+from ..types import UNSET, Unset
+
+T = TypeVar("T", bound="CustomApiSearchRequest")
+
+
+@_attrs_define
+class CustomApiSearchRequest:
+    r"""
+    Attributes:
+        query (str): Search query string
+        engine (Literal['custom_api'] | Unset): Provider discriminator; must be `custom_api` for this config. Default:
+            'custom_api'.
+        api_endpoint (str | Unset): HTTP(S) endpoint called by Search Proxy. Default: 'https://api.example.com/search'.
+        api_headers (str | Unset): JSON object containing headers sent to the custom API. Default: '{\\"Content-Type\\":
+            \\"application/json\\"}'.
+        api_additional_query_params (str | Unset): JSON object merged into the custom API query parameters. Default:
+            '{}'.
+        api_additional_body_params (str | Unset): JSON object merged into the custom API JSON body. Default: '{}'.
+        api_request_method (CustomApiRequestMethod | Unset):
+        timeout (int | Unset): Custom API request timeout in seconds. Default: 120.
+    """
+
+    query: str
+    engine: Literal["custom_api"] | Unset = "custom_api"
+    api_endpoint: str | Unset = "https://api.example.com/search"
+    api_headers: str | Unset = '{\\"Content-Type\\": \\"application/json\\"}'
+    api_additional_query_params: str | Unset = "{}"
+    api_additional_body_params: str | Unset = "{}"
+    api_request_method: CustomApiRequestMethod | Unset = UNSET
+    timeout: int | Unset = 120
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        query = self.query
+
+        engine = self.engine
+
+        api_endpoint = self.api_endpoint
+
+        api_headers = self.api_headers
+
+        api_additional_query_params = self.api_additional_query_params
+
+        api_additional_body_params = self.api_additional_body_params
+
+        api_request_method: str | Unset = UNSET
+        if not isinstance(self.api_request_method, Unset):
+            api_request_method = self.api_request_method.value
+
+        timeout = self.timeout
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "query": query,
+            }
+        )
+        if engine is not UNSET:
+            field_dict["engine"] = engine
+        if api_endpoint is not UNSET:
+            field_dict["apiEndpoint"] = api_endpoint
+        if api_headers is not UNSET:
+            field_dict["apiHeaders"] = api_headers
+        if api_additional_query_params is not UNSET:
+            field_dict["apiAdditionalQueryParams"] = api_additional_query_params
+        if api_additional_body_params is not UNSET:
+            field_dict["apiAdditionalBodyParams"] = api_additional_body_params
+        if api_request_method is not UNSET:
+            field_dict["apiRequestMethod"] = api_request_method
+        if timeout is not UNSET:
+            field_dict["timeout"] = timeout
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        query = d.pop("query")
+
+        engine = cast(Literal["custom_api"] | Unset, d.pop("engine", UNSET))
+        if engine != "custom_api" and not isinstance(engine, Unset):
+            raise ValueError(f"engine must match const 'custom_api', got '{engine}'")
+
+        api_endpoint = d.pop("apiEndpoint", UNSET)
+
+        api_headers = d.pop("apiHeaders", UNSET)
+
+        api_additional_query_params = d.pop("apiAdditionalQueryParams", UNSET)
+
+        api_additional_body_params = d.pop("apiAdditionalBodyParams", UNSET)
+
+        _api_request_method = d.pop("apiRequestMethod", UNSET)
+        api_request_method: CustomApiRequestMethod | Unset
+        if isinstance(_api_request_method, Unset):
+            api_request_method = UNSET
+        else:
+            api_request_method = CustomApiRequestMethod(_api_request_method)
+
+        timeout = d.pop("timeout", UNSET)
+
+        custom_api_search_request = cls(
+            query=query,
+            engine=engine,
+            api_endpoint=api_endpoint,
+            api_headers=api_headers,
+            api_additional_query_params=api_additional_query_params,
+            api_additional_body_params=api_additional_body_params,
+            api_request_method=api_request_method,
+            timeout=timeout,
+        )
+
+        custom_api_search_request.additional_properties = d
+        return custom_api_search_request
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

{unique_search_proxy_sdk-2026.44.0.dev1 → unique_search_proxy_sdk-2026.44.0.dev3}/unique_search_proxy_sdk/_generated/models/vertex_ai_agent_search_request.py

@@ -35,6 +35,7 @@ class VertexAiAgentSearchRequest:
         timeout (int | Unset): Request timeout in seconds (agent runs can be slow). Default: 120.
         vertexai_model_name (str | Unset): Gemini model name for grounded generation Default: 'gemini-3-flash-preview'.
         enable_enterprise_search (bool | Unset):  Default: False.
+        enable_redirect_resolution (bool | Unset): Whether to enable redirect resolution. Default: True.
     """
 
     query: str
@@ -45,6 +46,7 @@ class VertexAiAgentSearchRequest:
     timeout: int | Unset = 120
     vertexai_model_name: str | Unset = "gemini-3-flash-preview"
     enable_enterprise_search: bool | Unset = False
+    enable_redirect_resolution: bool | Unset = True
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
     def to_dict(self) -> dict[str, Any]:
@@ -60,6 +62,8 @@ class VertexAiAgentSearchRequest:
 
         enable_enterprise_search = self.enable_enterprise_search
 
+        enable_redirect_resolution = self.enable_redirect_resolution
+
         field_dict: dict[str, Any] = {}
         field_dict.update(self.additional_properties)
         field_dict.update(
@@ -77,6 +81,8 @@ class VertexAiAgentSearchRequest:
             field_dict["vertexaiModelName"] = vertexai_model_name
         if enable_enterprise_search is not UNSET:
             field_dict["enableEnterpriseSearch"] = enable_enterprise_search
+        if enable_redirect_resolution is not UNSET:
+            field_dict["enableRedirectResolution"] = enable_redirect_resolution
 
         return field_dict
 
@@ -97,6 +103,8 @@ class VertexAiAgentSearchRequest:
 
         enable_enterprise_search = d.pop("enableEnterpriseSearch", UNSET)
 
+        enable_redirect_resolution = d.pop("enableRedirectResolution", UNSET)
+
         vertex_ai_agent_search_request = cls(
             query=query,
             engine=engine,
@@ -104,6 +112,7 @@ class VertexAiAgentSearchRequest:
             timeout=timeout,
             vertexai_model_name=vertexai_model_name,
             enable_enterprise_search=enable_enterprise_search,
+            enable_redirect_resolution=enable_redirect_resolution,
         )
 
         vertex_ai_agent_search_request.additional_properties = d

{unique_search_proxy_sdk-2026.44.0.dev1 → unique_search_proxy_sdk-2026.44.0.dev3}/unique_search_proxy_sdk/_typed_endpoints.py

@@ -24,6 +24,9 @@ from unique_search_proxy_core.search_engines.brave.schema import (
     BraveSafesearch,
     BraveUnits,
 )
+from unique_search_proxy_core.search_engines.custom_api.schema import (
+    CustomApiRequestMethod,
+)
 from unique_search_proxy_core.search_engines.google.schema import (
     GoogleSafeDefault,
     GoogleSiteSearchFilter,
@@ -174,6 +177,31 @@ class PerplexitySearchEndpoint(_TypedPostEndpoint[SearchResponse]):
         )
 
 
+class CustomApiSearchEndpoint(_TypedPostEndpoint[SearchResponse]):
+    async def __call__(
+        self,
+        *,
+        query: str,
+        api_endpoint: str,
+        engine: Literal["custom_api"] = "custom_api",
+        timeout: int = 120,
+        api_headers: str = '{"Content-Type": "application/json"}',
+        api_additional_query_params: str = "{}",
+        api_additional_body_params: str = "{}",
+        api_request_method: CustomApiRequestMethod = CustomApiRequestMethod.GET,
+    ) -> SearchResponse:
+        return await self._call(
+            query=query,
+            api_endpoint=api_endpoint,
+            engine=engine,
+            timeout=timeout,
+            api_headers=api_headers,
+            api_additional_query_params=api_additional_query_params,
+            api_additional_body_params=api_additional_body_params,
+            api_request_method=api_request_method,
+        )
+
+
 class BingAgentSearchEndpoint(_TypedPostEndpoint[AgentSearchResponse]):
     async def __call__(
         self,
@@ -207,6 +235,7 @@ class VertexAIAgentSearchEndpoint(_TypedPostEndpoint[AgentSearchResponse]):
         timeout: int = 120,
         vertexai_model_name: str = "gemini-3-flash-preview",
         enable_enterprise_search: bool = False,
+        enable_redirect_resolution: bool = True,
     ) -> AgentSearchResponse:
         return await self._call(
             query=query,
@@ -215,6 +244,7 @@ class VertexAIAgentSearchEndpoint(_TypedPostEndpoint[AgentSearchResponse]):
             timeout=timeout,
             vertexai_model_name=vertexai_model_name,
             enable_enterprise_search=enable_enterprise_search,
+            enable_redirect_resolution=enable_redirect_resolution,
         )
 
 
@@ -417,6 +447,7 @@ __all__ = [
     "BingAgentSearchEndpoint",
     "BingAgentSearchStreamEndpoint",
     "BraveSearchEndpoint",
+    "CustomApiSearchEndpoint",
     "FirecrawlCrawlEndpoint",
     "GoogleSearchEndpoint",
     "JinaCrawlEndpoint",

{unique_search_proxy_sdk-2026.44.0.dev1 → unique_search_proxy_sdk-2026.44.0.dev3}/unique_search_proxy_sdk/search_client.py

@@ -6,6 +6,9 @@ from typing import Any
 
 from unique_search_proxy_core.search_engines.brave.schema import BraveSearchRequest
 from unique_search_proxy_core.search_engines.config_types import parse_search_request
+from unique_search_proxy_core.search_engines.custom_api.schema import (
+    CustomApiSearchRequest,
+)
 from unique_search_proxy_core.search_engines.google.schema import GoogleSearchRequest
 from unique_search_proxy_core.search_engines.perplexity.schema import (
     PerplexitySearchRequest,
@@ -17,12 +20,13 @@ from unique_search_proxy_sdk._generated.models.search_response import SearchResp
 from unique_search_proxy_sdk._transport import OpenapiTransport
 from unique_search_proxy_sdk._typed_endpoints import (
     BraveSearchEndpoint,
+    CustomApiSearchEndpoint,
     GoogleSearchEndpoint,
     PerplexitySearchEndpoint,
 )
 from unique_search_proxy_sdk.converters import to_sdk_search_request
 
-_SEARCH_PROVIDERS = frozenset({"google", "brave", "perplexity"})
+_SEARCH_PROVIDERS = frozenset({"google", "brave", "perplexity", "custom_api"})
 
 
 class SearchClient:
@@ -31,6 +35,7 @@ class SearchClient:
     google: GoogleSearchEndpoint
     brave: BraveSearchEndpoint
     perplexity: PerplexitySearchEndpoint
+    custom_api: CustomApiSearchEndpoint
 
     def __init__(self, transport: OpenapiTransport) -> None:
         self._transport = transport
@@ -64,6 +69,16 @@ class SearchClient:
                 response_type=SearchResponse,
             ),
         )
+        self.custom_api = CustomApiSearchEndpoint(
+            async_post_endpoint(
+                transport,
+                CustomApiSearchRequest,
+                parse=parse_search_request,
+                to_sdk=to_sdk_search_request,
+                post=search_v1_search_post.asyncio_detailed,
+                response_type=SearchResponse,
+            ),
+        )
 
     async def search(
         self,