release: 0.46.0

.github/workflows/ci.yml

@@ -21,10 +21,10 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/profound-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2
         with:
           version: '0.10.2'
 
@@ -43,10 +43,10 @@ jobs:
       id-token: write
     runs-on: ${{ github.repository == 'stainless-sdks/profound-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2
         with:
           version: '0.10.2'
 
@@ -61,7 +61,7 @@ jobs:
           github.repository == 'stainless-sdks/profound-python' &&
           !startsWith(github.ref, 'refs/heads/stl/')
         id: github-oidc
-        uses: actions/github-script@v8
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
@@ -81,10 +81,10 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/profound-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2
         with:
           version: '0.10.2'
 

.github/workflows/publish-pypi.yml

@@ -17,10 +17,10 @@ jobs:
       id-token: write
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2
         with:
           version: '0.9.13'
 

.github/workflows/release-doctor.yml

@@ -12,7 +12,7 @@ jobs:
     if: github.repository == 'cooper-square-technologies/profound-python-sdk' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Check release environment
         run: |

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.45.0"
+  ".": "0.46.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 42
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/profound/profound-39c677653dce3a2119784c3e7920341806ecb04f570586e67da2812c0918224f.yml
-openapi_spec_hash: fe9e8287add64a2ee6962e3ff46ad910
-config_hash: 49f12dcc01ab5f70d3b39f508d96153b
+configured_endpoints: 44
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/profound/profound-c0a8a60fb266537ae26999b8684f15f0d04b8f8f68c10e9c8b436ddbf0718462.yml
+openapi_spec_hash: 41991a62855a570749555b4f2e2a6a61
+config_hash: 7eef30f341128d7bf491d472a777e46c

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.46.0 (2026-05-15)
+
+Full Changelog: [v0.45.0...v0.46.0](https://github.com/cooper-square-technologies/profound-python-sdk/compare/v0.45.0...v0.46.0)
+
+### Features
+
+* **api:** added filters and web search results ([a051830](https://github.com/cooper-square-technologies/profound-python-sdk/commit/a051830bf93f0e8602a2a88d9a963d6d177f3bd2))
+* **api:** api update ([4380770](https://github.com/cooper-square-technologies/profound-python-sdk/commit/43807702e18b8159fc041dd7e6e0c0e5d48fba9f))
+
 ## 0.45.0 (2026-05-12)
 
 Full Changelog: [v0.44.0...v0.45.0](https://github.com/cooper-square-technologies/profound-python-sdk/compare/v0.44.0...v0.45.0)

api.md

@@ -103,12 +103,15 @@ Types:
 
 ```python
 from profound.types import (
+    HostnameFilter,
     PromptIDFilter,
     ReportInfo,
     ReportResponse,
     ReportResult,
+    RootDomainFilter,
     TagNameFilter,
     TopicNameFilter,
+    URLFilter,
     ReportCitationsResponse,
     ReportStreamCitationsResponse,
     ReportStreamSentimentResponse,
@@ -118,17 +121,30 @@ from profound.types import (
 
 Methods:
 
-- <code title="post /v1/reports/citations">client.reports.<a href="./src/profound/resources/reports.py">citations</a>(\*\*<a href="src/profound/types/report_citations_params.py">params</a>) -> <a href="./src/profound/types/report_citations_response.py">ReportCitationsResponse</a></code>
-- <code title="post /v1/reports/bots">client.reports.<a href="./src/profound/resources/reports.py">get_bots_report</a>(\*\*<a href="src/profound/types/report_get_bots_report_params.py">params</a>) -> <a href="./src/profound/types/report_response.py">ReportResponse</a></code>
-- <code title="post /v2/reports/bots">client.reports.<a href="./src/profound/resources/reports.py">get_bots_report_v2</a>(\*\*<a href="src/profound/types/report_get_bots_report_v2_params.py">params</a>) -> <a href="./src/profound/types/report_response.py">ReportResponse</a></code>
-- <code title="post /v1/reports/referrals">client.reports.<a href="./src/profound/resources/reports.py">get_referrals_report</a>(\*\*<a href="src/profound/types/report_get_referrals_report_params.py">params</a>) -> <a href="./src/profound/types/report_response.py">ReportResponse</a></code>
-- <code title="post /v2/reports/referrals">client.reports.<a href="./src/profound/resources/reports.py">get_referrals_report_v2</a>(\*\*<a href="src/profound/types/report_get_referrals_report_v2_params.py">params</a>) -> <a href="./src/profound/types/report_response.py">ReportResponse</a></code>
-- <code title="post /v1/reports/query-fanouts">client.reports.<a href="./src/profound/resources/reports.py">query_fanouts</a>(\*\*<a href="src/profound/types/report_query_fanouts_params.py">params</a>) -> <a href="./src/profound/types/report_response.py">ReportResponse</a></code>
-- <code title="post /v1/reports/sentiment">client.reports.<a href="./src/profound/resources/reports.py">sentiment</a>(\*\*<a href="src/profound/types/report_sentiment_params.py">params</a>) -> <a href="./src/profound/types/report_response.py">ReportResponse</a></code>
-- <code title="post /v1/reports/citations/stream">client.reports.<a href="./src/profound/resources/reports.py">stream_citations</a>(\*\*<a href="src/profound/types/report_stream_citations_params.py">params</a>) -> <a href="./src/profound/types/report_stream_citations_response.py">ReportStreamCitationsResponse</a></code>
-- <code title="post /v1/reports/sentiment/stream">client.reports.<a href="./src/profound/resources/reports.py">stream_sentiment</a>(\*\*<a href="src/profound/types/report_stream_sentiment_params.py">params</a>) -> <a href="./src/profound/types/report_stream_sentiment_response.py">ReportStreamSentimentResponse</a></code>
-- <code title="post /v1/reports/visibility/stream">client.reports.<a href="./src/profound/resources/reports.py">stream_visibility</a>(\*\*<a href="src/profound/types/report_stream_visibility_params.py">params</a>) -> <a href="./src/profound/types/report_stream_visibility_response.py">ReportStreamVisibilityResponse</a></code>
-- <code title="post /v1/reports/visibility">client.reports.<a href="./src/profound/resources/reports.py">visibility</a>(\*\*<a href="src/profound/types/report_visibility_params.py">params</a>) -> <a href="./src/profound/types/report_response.py">ReportResponse</a></code>
+- <code title="post /v1/reports/citations">client.reports.<a href="./src/profound/resources/reports/reports.py">citations</a>(\*\*<a href="src/profound/types/report_citations_params.py">params</a>) -> <a href="./src/profound/types/report_citations_response.py">ReportCitationsResponse</a></code>
+- <code title="post /v1/reports/bots">client.reports.<a href="./src/profound/resources/reports/reports.py">get_bots_report</a>(\*\*<a href="src/profound/types/report_get_bots_report_params.py">params</a>) -> <a href="./src/profound/types/report_response.py">ReportResponse</a></code>
+- <code title="post /v2/reports/bots">client.reports.<a href="./src/profound/resources/reports/reports.py">get_bots_report_v2</a>(\*\*<a href="src/profound/types/report_get_bots_report_v2_params.py">params</a>) -> <a href="./src/profound/types/report_response.py">ReportResponse</a></code>
+- <code title="post /v1/reports/referrals">client.reports.<a href="./src/profound/resources/reports/reports.py">get_referrals_report</a>(\*\*<a href="src/profound/types/report_get_referrals_report_params.py">params</a>) -> <a href="./src/profound/types/report_response.py">ReportResponse</a></code>
+- <code title="post /v2/reports/referrals">client.reports.<a href="./src/profound/resources/reports/reports.py">get_referrals_report_v2</a>(\*\*<a href="src/profound/types/report_get_referrals_report_v2_params.py">params</a>) -> <a href="./src/profound/types/report_response.py">ReportResponse</a></code>
+- <code title="post /v1/reports/query-fanouts">client.reports.<a href="./src/profound/resources/reports/reports.py">query_fanouts</a>(\*\*<a href="src/profound/types/report_query_fanouts_params.py">params</a>) -> <a href="./src/profound/types/report_response.py">ReportResponse</a></code>
+- <code title="post /v1/reports/sentiment">client.reports.<a href="./src/profound/resources/reports/reports.py">sentiment</a>(\*\*<a href="src/profound/types/report_sentiment_params.py">params</a>) -> <a href="./src/profound/types/report_response.py">ReportResponse</a></code>
+- <code title="post /v1/reports/citations/stream">client.reports.<a href="./src/profound/resources/reports/reports.py">stream_citations</a>(\*\*<a href="src/profound/types/report_stream_citations_params.py">params</a>) -> <a href="./src/profound/types/report_stream_citations_response.py">ReportStreamCitationsResponse</a></code>
+- <code title="post /v1/reports/sentiment/stream">client.reports.<a href="./src/profound/resources/reports/reports.py">stream_sentiment</a>(\*\*<a href="src/profound/types/report_stream_sentiment_params.py">params</a>) -> <a href="./src/profound/types/report_stream_sentiment_response.py">ReportStreamSentimentResponse</a></code>
+- <code title="post /v1/reports/visibility/stream">client.reports.<a href="./src/profound/resources/reports/reports.py">stream_visibility</a>(\*\*<a href="src/profound/types/report_stream_visibility_params.py">params</a>) -> <a href="./src/profound/types/report_stream_visibility_response.py">ReportStreamVisibilityResponse</a></code>
+- <code title="post /v1/reports/visibility">client.reports.<a href="./src/profound/resources/reports/reports.py">visibility</a>(\*\*<a href="src/profound/types/report_visibility_params.py">params</a>) -> <a href="./src/profound/types/report_response.py">ReportResponse</a></code>
+
+## WebSearchResults
+
+Types:
+
+```python
+from profound.types.reports import WebSearchResultQueryResponse, WebSearchResultStreamResponse
+```
+
+Methods:
+
+- <code title="post /v1/reports/web-search-results">client.reports.web_search_results.<a href="./src/profound/resources/reports/web_search_results.py">query</a>(\*\*<a href="src/profound/types/reports/web_search_result_query_params.py">params</a>) -> <a href="./src/profound/types/reports/web_search_result_query_response.py">WebSearchResultQueryResponse</a></code>
+- <code title="post /v1/reports/web-search-results/stream">client.reports.web_search_results.<a href="./src/profound/resources/reports/web_search_results.py">stream</a>(\*\*<a href="src/profound/types/reports/web_search_result_stream_params.py">params</a>) -> <a href="./src/profound/types/reports/web_search_result_stream_response.py">WebSearchResultStreamResponse</a></code>
 
 # Logs
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "profound"
-version = "0.45.0"
+version = "0.46.0"
 description = "The official Python library for the profound API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/profound/_client.py

@@ -38,10 +38,10 @@
 if TYPE_CHECKING:
     from .resources import logs, agents, content, prompts, reports, organizations, knowledge_bases
     from .resources.prompts import PromptsResource, AsyncPromptsResource
-    from .resources.reports import ReportsResource, AsyncReportsResource
     from .resources.logs.logs import LogsResource, AsyncLogsResource
     from .resources.agents.agents import AgentsResource, AsyncAgentsResource
     from .resources.content.content import ContentResource, AsyncContentResource
+    from .resources.reports.reports import ReportsResource, AsyncReportsResource
     from .resources.organizations.organizations import OrganizationsResource, AsyncOrganizationsResource
     from .resources.knowledge_bases.knowledge_bases import KnowledgeBasesResource, AsyncKnowledgeBasesResource
 

src/profound/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "profound"
-__version__ = "0.45.0"  # x-release-please-version
+__version__ = "0.46.0"  # x-release-please-version

src/profound/resources/reports/__init__.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .reports import (
+    ReportsResource,
+    AsyncReportsResource,
+    ReportsResourceWithRawResponse,
+    AsyncReportsResourceWithRawResponse,
+    ReportsResourceWithStreamingResponse,
+    AsyncReportsResourceWithStreamingResponse,
+)
+from .web_search_results import (
+    WebSearchResultsResource,
+    AsyncWebSearchResultsResource,
+    WebSearchResultsResourceWithRawResponse,
+    AsyncWebSearchResultsResourceWithRawResponse,
+    WebSearchResultsResourceWithStreamingResponse,
+    AsyncWebSearchResultsResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "WebSearchResultsResource",
+    "AsyncWebSearchResultsResource",
+    "WebSearchResultsResourceWithRawResponse",
+    "AsyncWebSearchResultsResourceWithRawResponse",
+    "WebSearchResultsResourceWithStreamingResponse",
+    "AsyncWebSearchResultsResourceWithStreamingResponse",
+    "ReportsResource",
+    "AsyncReportsResource",
+    "ReportsResourceWithRawResponse",
+    "AsyncReportsResourceWithRawResponse",
+    "ReportsResourceWithStreamingResponse",
+    "AsyncReportsResourceWithStreamingResponse",
+]

src/profound/resources/reports.py → src/profound/resources/reports/reports.py

@@ -8,7 +8,7 @@
 
 import httpx
 
-from ..types import (
+from ...types import (
     report_citations_params,
     report_sentiment_params,
     report_visibility_params,
@@ -21,29 +21,41 @@
     report_get_referrals_report_params,
     report_get_referrals_report_v2_params,
 )
-from .._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
-from .._utils import maybe_transform, async_maybe_transform
-from .._compat import cached_property
-from .._resource import SyncAPIResource, AsyncAPIResource
-from .._response import (
+from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
+from ..._utils import maybe_transform, async_maybe_transform
+from ..._compat import cached_property
+from ..._resource import SyncAPIResource, AsyncAPIResource
+from ..._response import (
     to_raw_response_wrapper,
     to_streamed_response_wrapper,
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
-from .._streaming import Stream, AsyncStream
-from .._base_client import make_request_options
-from ..types.report_response import ReportResponse
-from ..types.shared_params.pagination import Pagination
-from ..types.report_citations_response import ReportCitationsResponse
-from ..types.report_stream_citations_response import ReportStreamCitationsResponse
-from ..types.report_stream_sentiment_response import ReportStreamSentimentResponse
-from ..types.report_stream_visibility_response import ReportStreamVisibilityResponse
+from ..._streaming import Stream, AsyncStream
+from ..._base_client import make_request_options
+from .web_search_results import (
+    WebSearchResultsResource,
+    AsyncWebSearchResultsResource,
+    WebSearchResultsResourceWithRawResponse,
+    AsyncWebSearchResultsResourceWithRawResponse,
+    WebSearchResultsResourceWithStreamingResponse,
+    AsyncWebSearchResultsResourceWithStreamingResponse,
+)
+from ...types.report_response import ReportResponse
+from ...types.shared_params.pagination import Pagination
+from ...types.report_citations_response import ReportCitationsResponse
+from ...types.report_stream_citations_response import ReportStreamCitationsResponse
+from ...types.report_stream_sentiment_response import ReportStreamSentimentResponse
+from ...types.report_stream_visibility_response import ReportStreamVisibilityResponse
 
 __all__ = ["ReportsResource", "AsyncReportsResource"]
 
 
 class ReportsResource(SyncAPIResource):
+    @cached_property
+    def web_search_results(self) -> WebSearchResultsResource:
+        return WebSearchResultsResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> ReportsResourceWithRawResponse:
         """
@@ -1088,6 +1100,10 @@ def visibility(
 
 
 class AsyncReportsResource(AsyncAPIResource):
+    @cached_property
+    def web_search_results(self) -> AsyncWebSearchResultsResource:
+        return AsyncWebSearchResultsResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> AsyncReportsResourceWithRawResponse:
         """
@@ -2169,6 +2185,10 @@ def __init__(self, reports: ReportsResource) -> None:
             reports.visibility,
         )
 
+    @cached_property
+    def web_search_results(self) -> WebSearchResultsResourceWithRawResponse:
+        return WebSearchResultsResourceWithRawResponse(self._reports.web_search_results)
+
 
 class AsyncReportsResourceWithRawResponse:
     def __init__(self, reports: AsyncReportsResource) -> None:
@@ -2208,6 +2228,10 @@ def __init__(self, reports: AsyncReportsResource) -> None:
             reports.visibility,
         )
 
+    @cached_property
+    def web_search_results(self) -> AsyncWebSearchResultsResourceWithRawResponse:
+        return AsyncWebSearchResultsResourceWithRawResponse(self._reports.web_search_results)
+
 
 class ReportsResourceWithStreamingResponse:
     def __init__(self, reports: ReportsResource) -> None:
@@ -2247,6 +2271,10 @@ def __init__(self, reports: ReportsResource) -> None:
             reports.visibility,
         )
 
+    @cached_property
+    def web_search_results(self) -> WebSearchResultsResourceWithStreamingResponse:
+        return WebSearchResultsResourceWithStreamingResponse(self._reports.web_search_results)
+
 
 class AsyncReportsResourceWithStreamingResponse:
     def __init__(self, reports: AsyncReportsResource) -> None:
@@ -2285,3 +2313,7 @@ def __init__(self, reports: AsyncReportsResource) -> None:
         self.visibility = async_to_streamed_response_wrapper(
             reports.visibility,
         )
+
+    @cached_property
+    def web_search_results(self) -> AsyncWebSearchResultsResourceWithStreamingResponse:
+        return AsyncWebSearchResultsResourceWithStreamingResponse(self._reports.web_search_results)