cooper-square-technologies · stainless-app · Jun 18, 2026 · Jun 18, 2026 · Jun 18, 2026 · Jun 19, 2026
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.50.0"
+  ".": "0.51.0"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 75
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/profound/profound-877efb225a136be0aae8263a10935ef8b95f8385487840f27f3c83a401981af8.yml
-openapi_spec_hash: 713311bd044cbfc0b31e25d7538f0bc3
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/profound/profound-30fae74d1df17644ef789b2de6080b0ad6a3fb63c6f64cdaec914267395d1a6a.yml
+openapi_spec_hash: 835cfb97bbf14c31c152221350117f14
 config_hash: 341368a8c64fae1694b7fad2df7c56e0
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.51.0 (2026-06-25)
+
+Full Changelog: [v0.50.0...v0.51.0](https://github.com/cooper-square-technologies/profound-python-sdk/compare/v0.50.0...v0.51.0)
+
+### Features
+
+* **api:** api update ([afa40e4](https://github.com/cooper-square-technologies/profound-python-sdk/commit/afa40e42bb60bc81555759d7e2845d112fea30a9))
+* **api:** api update ([bb2a85d](https://github.com/cooper-square-technologies/profound-python-sdk/commit/bb2a85d5a029e323656569bc05736789b0503857))
+* **api:** api update ([90d8c7c](https://github.com/cooper-square-technologies/profound-python-sdk/commit/90d8c7c7a95dd2fd14cfbcc652e8a1a4178f2696))
+* **api:** api update ([5b6f4bd](https://github.com/cooper-square-technologies/profound-python-sdk/commit/5b6f4bd921006e33d4e32915e0c14218fa6d0a4c))
+* **api:** api update ([84612c6](https://github.com/cooper-square-technologies/profound-python-sdk/commit/84612c603c3b8993b441565b8fb04f343c38b303))
+* **api:** api update ([e5ec5f3](https://github.com/cooper-square-technologies/profound-python-sdk/commit/e5ec5f38cc317bc92859ca6efc1e9b812a7a1eb9))
+* **api:** api update ([25a1ba5](https://github.com/cooper-square-technologies/profound-python-sdk/commit/25a1ba52db42b607436eb0f84f7b1ba5f580b9e7))
+
 ## 0.50.0 (2026-06-18)
 
 Full Changelog: [v0.49.0...v0.50.0](https://github.com/cooper-square-technologies/profound-python-sdk/compare/v0.49.0...v0.50.0)

diff --git a/pyproject.toml b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "profound"
-version = "0.50.0"
+version = "0.51.0"
 description = "The official Python library for the profound API"
 dynamic = ["readme"]
 license = "Apache-2.0"

diff --git a/src/profound/_version.py b/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.50.0"  # x-release-please-version
+__version__ = "0.51.0"  # x-release-please-version
diff --git a/src/profound/resources/reports/reports.py b/src/profound/resources/reports/reports.py
@@ -22,7 +22,7 @@
     report_get_referrals_report_params,
     report_get_referrals_report_v2_params,
 )
-from ..._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
+from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
 from ..._utils import maybe_transform, async_maybe_transform
 from .accuracy import (
     AccuracyResource,
@@ -649,49 +649,54 @@ def query_sentiment_v2(
         *,
         asset_name: str,
         category_id: str,
-        end_date: str,
-        start_date: str,
-        claim_filters: Optional[report_query_sentiment_v2_params.ClaimFilters] | Omit = omit,
-        comparison_end_date: Optional[str] | Omit = omit,
-        comparison_start_date: Optional[str] | Omit = omit,
-        date_bucket: Optional[Literal["daily", "weekly", "monthly"]] | Omit = omit,
-        exclude_topic_ids: bool | Omit = omit,
-        group_by: Optional[
-            List[
-                Literal[
-                    "topic", "region", "platform", "prompt", "persona", "tag", "theme", "claim", "run", "competitor"
-                ]
+        end_date: Union[str, datetime],
+        metrics: List[Literal["sentiment", "occurrence"]],
+        start_date: Union[str, datetime],
+        comparison_end_date: Union[str, datetime, None] | Omit = omit,
+        comparison_start_date: Union[str, datetime, None] | Omit = omit,
+        date_interval: Literal["hour", "day", "week", "month", "quarter", "year", "relative_week"] | Omit = omit,
+        dimensions: List[
+            Literal[
+                "date", "topic", "region", "model", "prompt", "persona", "tag", "theme", "claim", "run", "asset_name"
             ]
         ]
         | Omit = omit,
-        include_no_persona: bool | Omit = omit,
-        include_no_tag: bool | Omit = omit,
-        limit: Optional[int] | Omit = omit,
-        metrics: Optional[List[Literal["sentiment", "occurrence"]]] | Omit = omit,
-        offset: int | Omit = omit,
-        owned_asset_names_to_exclude: SequenceNotStr[str] | Omit = omit,
-        persona_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        platform_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        prompt_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        region_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        run_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        sort_by: Optional[Literal["occurrence", "assessment_count", "positive_sentiment", "negative_sentiment"]]
-        | Omit = omit,
-        sort_direction: Literal["asc", "desc"] | Omit = omit,
-        tag_filter_type: Literal["all", "any"] | Omit = omit,
-        tag_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        topic_ids: Optional[SequenceNotStr[str]] | Omit = omit,
+        filters: Iterable[report_query_sentiment_v2_params.Filter] | Omit = omit,
+        order_by: Dict[str, Literal["asc", "desc"]] | Omit = omit,
+        pagination: Pagination | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ReportQuerySentimentV2Response:
-        """
-        Query Sentiment V2
+        """Query Sentiment V2
 
         Args:
+          end_date: End date for the report.
+
+        Accepts formats: YYYY-MM-DD, YYYY-MM-DD HH:MM, or full
+              ISO timestamp.
+
+          start_date: Start date for the report. Accepts formats: YYYY-MM-DD, YYYY-MM-DD HH:MM, or
+              full ISO timestamp.
+
+          comparison_end_date: End of the previous period for delta computation.
+
+          comparison_start_date: Start of the previous period for delta computation.
+
+          date_interval: Date interval for the report. Only used when dimensions includes date.
+
+          dimensions: Dimensions to group the report by.
+
+          filters: List of filters to apply to the sentiment-v2 report.
+
+          order_by: Custom ordering of report results. Dimension keys must also be present in
+              dimensions. The sentiment metric orders by positive_sentiment.
+
+          pagination: Pagination settings for the report results.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -707,29 +712,15 @@ def query_sentiment_v2(
                     "asset_name": asset_name,
                     "category_id": category_id,
                     "end_date": end_date,
+                    "metrics": metrics,
                     "start_date": start_date,
-                    "claim_filters": claim_filters,
                     "comparison_end_date": comparison_end_date,
                     "comparison_start_date": comparison_start_date,
-                    "date_bucket": date_bucket,
-                    "exclude_topic_ids": exclude_topic_ids,
-                    "group_by": group_by,
-                    "include_no_persona": include_no_persona,
-                    "include_no_tag": include_no_tag,
-                    "limit": limit,
-                    "metrics": metrics,
-                    "offset": offset,
-                    "owned_asset_names_to_exclude": owned_asset_names_to_exclude,
-                    "persona_ids": persona_ids,
-                    "platform_ids": platform_ids,
-                    "prompt_ids": prompt_ids,
-                    "region_ids": region_ids,
-                    "run_ids": run_ids,
-                    "sort_by": sort_by,
-                    "sort_direction": sort_direction,
-                    "tag_filter_type": tag_filter_type,
-                    "tag_ids": tag_ids,
-                    "topic_ids": topic_ids,
+                    "date_interval": date_interval,
+                    "dimensions": dimensions,
+                    "filters": filters,
+                    "order_by": order_by,
+                    "pagination": pagination,
                 },
                 report_query_sentiment_v2_params.ReportQuerySentimentV2Params,
             ),
@@ -1816,49 +1807,54 @@ async def query_sentiment_v2(
         *,
         asset_name: str,
         category_id: str,
-        end_date: str,
-        start_date: str,
-        claim_filters: Optional[report_query_sentiment_v2_params.ClaimFilters] | Omit = omit,
-        comparison_end_date: Optional[str] | Omit = omit,
-        comparison_start_date: Optional[str] | Omit = omit,
-        date_bucket: Optional[Literal["daily", "weekly", "monthly"]] | Omit = omit,
-        exclude_topic_ids: bool | Omit = omit,
-        group_by: Optional[
-            List[
-                Literal[
-                    "topic", "region", "platform", "prompt", "persona", "tag", "theme", "claim", "run", "competitor"
-                ]
+        end_date: Union[str, datetime],
+        metrics: List[Literal["sentiment", "occurrence"]],
+        start_date: Union[str, datetime],
+        comparison_end_date: Union[str, datetime, None] | Omit = omit,
+        comparison_start_date: Union[str, datetime, None] | Omit = omit,
+        date_interval: Literal["hour", "day", "week", "month", "quarter", "year", "relative_week"] | Omit = omit,
+        dimensions: List[
+            Literal[
+                "date", "topic", "region", "model", "prompt", "persona", "tag", "theme", "claim", "run", "asset_name"
             ]
         ]
         | Omit = omit,
-        include_no_persona: bool | Omit = omit,
-        include_no_tag: bool | Omit = omit,
-        limit: Optional[int] | Omit = omit,
-        metrics: Optional[List[Literal["sentiment", "occurrence"]]] | Omit = omit,
-        offset: int | Omit = omit,
-        owned_asset_names_to_exclude: SequenceNotStr[str] | Omit = omit,
-        persona_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        platform_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        prompt_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        region_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        run_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        sort_by: Optional[Literal["occurrence", "assessment_count", "positive_sentiment", "negative_sentiment"]]
-        | Omit = omit,
-        sort_direction: Literal["asc", "desc"] | Omit = omit,
-        tag_filter_type: Literal["all", "any"] | Omit = omit,
-        tag_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        topic_ids: Optional[SequenceNotStr[str]] | Omit = omit,
+        filters: Iterable[report_query_sentiment_v2_params.Filter] | Omit = omit,
+        order_by: Dict[str, Literal["asc", "desc"]] | Omit = omit,
+        pagination: Pagination | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ReportQuerySentimentV2Response:
-        """
-        Query Sentiment V2
+        """Query Sentiment V2
 
         Args:
+          end_date: End date for the report.
+
+        Accepts formats: YYYY-MM-DD, YYYY-MM-DD HH:MM, or full
+              ISO timestamp.
+
+          start_date: Start date for the report. Accepts formats: YYYY-MM-DD, YYYY-MM-DD HH:MM, or
+              full ISO timestamp.
+
+          comparison_end_date: End of the previous period for delta computation.
+
+          comparison_start_date: Start of the previous period for delta computation.
+
+          date_interval: Date interval for the report. Only used when dimensions includes date.
+
+          dimensions: Dimensions to group the report by.
+
+          filters: List of filters to apply to the sentiment-v2 report.
+
+          order_by: Custom ordering of report results. Dimension keys must also be present in
+              dimensions. The sentiment metric orders by positive_sentiment.
+
+          pagination: Pagination settings for the report results.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1874,29 +1870,15 @@ async def query_sentiment_v2(
                     "asset_name": asset_name,
                     "category_id": category_id,
                     "end_date": end_date,
+                    "metrics": metrics,
                     "start_date": start_date,
-                    "claim_filters": claim_filters,
                     "comparison_end_date": comparison_end_date,
                     "comparison_start_date": comparison_start_date,
-                    "date_bucket": date_bucket,
-                    "exclude_topic_ids": exclude_topic_ids,
-                    "group_by": group_by,
-                    "include_no_persona": include_no_persona,
-                    "include_no_tag": include_no_tag,
-                    "limit": limit,
-                    "metrics": metrics,
-                    "offset": offset,
-                    "owned_asset_names_to_exclude": owned_asset_names_to_exclude,
-                    "persona_ids": persona_ids,
-                    "platform_ids": platform_ids,
-                    "prompt_ids": prompt_ids,
-                    "region_ids": region_ids,
-                    "run_ids": run_ids,
-                    "sort_by": sort_by,
-                    "sort_direction": sort_direction,
-                    "tag_filter_type": tag_filter_type,
-                    "tag_ids": tag_ids,
-                    "topic_ids": topic_ids,
+                    "date_interval": date_interval,
+                    "dimensions": dimensions,
+                    "filters": filters,
+                    "order_by": order_by,
+                    "pagination": pagination,
                 },
                 report_query_sentiment_v2_params.ReportQuerySentimentV2Params,
             ),