profound 0.5.0__tar.gz → 0.7.0__tar.gz

profound-0.7.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.7.0"
+}

{profound-0.5.0 → profound-0.7.0}/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.7.0 (2025-10-27)
+
+Full Changelog: [v0.6.0...v0.7.0](https://github.com/cooper-square-technologies/profound-python-sdk/compare/v0.6.0...v0.7.0)
+
+### Features
+
+* **api:** api update ([375f64d](https://github.com/cooper-square-technologies/profound-python-sdk/commit/375f64db88b85ce558e5132e00067af6bdc4ff1f))
+
+## 0.6.0 (2025-10-21)
+
+Full Changelog: [v0.5.0...v0.6.0](https://github.com/cooper-square-technologies/profound-python-sdk/compare/v0.5.0...v0.6.0)
+
+### Features
+
+* **api:** api update ([4e244ad](https://github.com/cooper-square-technologies/profound-python-sdk/commit/4e244ad88c7e6185b4a3865b3db3b83981e2a865))
+
+
+### Chores
+
+* bump `httpx-aiohttp` version to 0.1.9 ([c4d4695](https://github.com/cooper-square-technologies/profound-python-sdk/commit/c4d46955efd31cff4e9d7d22bdd943b116ef5c08))
+
 ## 0.5.0 (2025-10-17)
 
 Full Changelog: [v0.4.0...v0.5.0](https://github.com/cooper-square-technologies/profound-python-sdk/compare/v0.4.0...v0.5.0)

{profound-0.5.0 → profound-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: profound
-Version: 0.5.0
+Version: 0.7.0
 Summary: The official Python library for the profound API
 Project-URL: Homepage, https://github.com/cooper-square-technologies/profound-python-sdk
 Project-URL: Repository, https://github.com/cooper-square-technologies/profound-python-sdk
@@ -30,7 +30,7 @@ Requires-Dist: sniffio
 Requires-Dist: typing-extensions<5,>=4.10
 Provides-Extra: aiohttp
 Requires-Dist: aiohttp; extra == 'aiohttp'
-Requires-Dist: httpx-aiohttp>=0.1.8; extra == 'aiohttp'
+Requires-Dist: httpx-aiohttp>=0.1.9; extra == 'aiohttp'
 Description-Content-Type: text/markdown
 
 # Profound Python API library

{profound-0.5.0 → profound-0.7.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "profound"
-version = "0.5.0"
+version = "0.7.0"
 description = "The official Python library for the profound API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -39,7 +39,7 @@ Homepage = "https://github.com/cooper-square-technologies/profound-python-sdk"
 Repository = "https://github.com/cooper-square-technologies/profound-python-sdk"
 
 [project.optional-dependencies]
-aiohttp = ["aiohttp", "httpx_aiohttp>=0.1.8"]
+aiohttp = ["aiohttp", "httpx_aiohttp>=0.1.9"]
 
 [tool.rye]
 managed = true

{profound-0.5.0 → profound-0.7.0}/requirements-dev.lock

@@ -56,7 +56,7 @@ httpx==0.28.1
     # via httpx-aiohttp
     # via profound
     # via respx
-httpx-aiohttp==0.1.8
+httpx-aiohttp==0.1.9
     # via profound
 idna==3.4
     # via anyio

{profound-0.5.0 → profound-0.7.0}/requirements.lock

@@ -43,7 +43,7 @@ httpcore==1.0.9
 httpx==0.28.1
     # via httpx-aiohttp
     # via profound
-httpx-aiohttp==0.1.8
+httpx-aiohttp==0.1.9
     # via profound
 idna==3.4
     # via anyio

{profound-0.5.0 → profound-0.7.0}/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.5.0"  # x-release-please-version
+__version__ = "0.7.0"  # x-release-please-version

{profound-0.5.0 → profound-0.7.0}/src/profound/resources/logs/raw.py

@@ -96,8 +96,7 @@ class RawResource(SyncAPIResource):
           end_date: End date for logs. Accepts same formats as start_date. Defaults to now if
               omitted.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: List of filters to apply to the bots logs query.
 
           order_by: Custom ordering of the report results.
 
@@ -195,8 +194,7 @@ class RawResource(SyncAPIResource):
           end_date: End date for logs. Accepts same formats as start_date. Defaults to now if
               omitted.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: Filters to apply to the logs query.
 
           order_by: Custom ordering of the report results.
 
@@ -314,8 +312,7 @@ class AsyncRawResource(AsyncAPIResource):
           end_date: End date for logs. Accepts same formats as start_date. Defaults to now if
               omitted.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: List of filters to apply to the bots logs query.
 
           order_by: Custom ordering of the report results.
 
@@ -413,8 +410,7 @@ class AsyncRawResource(AsyncAPIResource):
           end_date: End date for logs. Accepts same formats as start_date. Defaults to now if
               omitted.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: Filters to apply to the logs query.
 
           order_by: Custom ordering of the report results.
 

{profound-0.5.0 → profound-0.7.0}/src/profound/resources/prompts.py

@@ -65,6 +65,8 @@ class PromptsResource(SyncAPIResource):
         Get the answers for the prompts.
 
         Args:
+          filters: List of filters to apply to the answers report.
+
           pagination: Pagination parameters for the results. Default is 10,000 rows with no offset.
 
           extra_headers: Send extra headers
@@ -135,6 +137,8 @@ class AsyncPromptsResource(AsyncAPIResource):
         Get the answers for the prompts.
 
         Args:
+          filters: List of filters to apply to the answers report.
+
           pagination: Pagination parameters for the results. Default is 10,000 rows with no offset.
 
           extra_headers: Send extra headers

{profound-0.5.0 → profound-0.7.0}/src/profound/resources/reports.py

@@ -84,8 +84,7 @@ class ReportsResource(SyncAPIResource):
 
           dimensions: Dimensions to group the report by.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: List of filters to apply to the citations report.
 
           order_by: Custom ordering of the report results.
 
@@ -165,8 +164,7 @@ class ReportsResource(SyncAPIResource):
 
           dimensions: Dimensions to group the report by.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: List of filters to apply to the sentiment report.
 
           order_by: Custom ordering of the report results.
 
@@ -216,7 +214,7 @@ class ReportsResource(SyncAPIResource):
         *,
         category_id: str,
         end_date: Union[str, datetime],
-        metrics: List[Literal["share_of_voice", "mentions_count", "visibility_score"]],
+        metrics: List[Literal["share_of_voice", "mentions_count", "visibility_score", "executions"]],
         start_date: Union[str, datetime],
         date_interval: Literal["day", "week", "month", "year"] | Omit = omit,
         dimensions: List[Literal["date", "region", "topic", "model", "asset_name", "prompt", "tag"]] | Omit = omit,
@@ -245,8 +243,7 @@ class ReportsResource(SyncAPIResource):
 
           dimensions: Dimensions to group the report by.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: List of filters to apply to the visibility report.
 
           order_by: Custom ordering of the report results.
 
@@ -349,8 +346,7 @@ class AsyncReportsResource(AsyncAPIResource):
 
           dimensions: Dimensions to group the report by.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: List of filters to apply to the citations report.
 
           order_by: Custom ordering of the report results.
 
@@ -430,8 +426,7 @@ class AsyncReportsResource(AsyncAPIResource):
 
           dimensions: Dimensions to group the report by.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: List of filters to apply to the sentiment report.
 
           order_by: Custom ordering of the report results.
 
@@ -481,7 +476,7 @@ class AsyncReportsResource(AsyncAPIResource):
         *,
         category_id: str,
         end_date: Union[str, datetime],
-        metrics: List[Literal["share_of_voice", "mentions_count", "visibility_score"]],
+        metrics: List[Literal["share_of_voice", "mentions_count", "visibility_score", "executions"]],
         start_date: Union[str, datetime],
         date_interval: Literal["day", "week", "month", "year"] | Omit = omit,
         dimensions: List[Literal["date", "region", "topic", "model", "asset_name", "prompt", "tag"]] | Omit = omit,
@@ -510,8 +505,7 @@ class AsyncReportsResource(AsyncAPIResource):
 
           dimensions: Dimensions to group the report by.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: List of filters to apply to the visibility report.
 
           order_by: Custom ordering of the report results.
 

profound-0.7.0/src/profound/types/logs/raw_bots_params.py

@@ -0,0 +1,288 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, List, Union, Iterable
+from datetime import datetime
+from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
+
+from ..._types import SequenceNotStr
+from ..._utils import PropertyInfo
+from ..shared_params.pagination import Pagination
+
+__all__ = [
+    "RawBotsParams",
+    "Filter",
+    "FilterBotNameFilter",
+    "FilterBotProviderFilter",
+    "FilterBotTypesFilter",
+    "FilterMethodFilter",
+    "FilterAppModelsAgentAnalyticsFiltersPathFilter",
+    "FilterStatusCodeFilter",
+    "FilterIPFilter",
+    "FilterUserAgentFilter",
+    "FilterRefererFilter",
+    "FilterQueryParamsFilter",
+]
+
+
+class RawBotsParams(TypedDict, total=False):
+    domain: Required[str]
+    """Domain to query logs for."""
+
+    metrics: Required[List[Literal["count"]]]
+
+    start_date: Required[Annotated[Union[str, datetime], PropertyInfo(format="iso8601")]]
+    """Start date for logs.
+
+    Accepts: YYYY-MM-DD, YYYY-MM-DD HH:MM, YYYY-MM-DD HH:MM:SS, or full ISO
+    timestamp.
+    """
+
+    date_interval: Literal["day", "week", "month", "year"]
+    """Date interval for the report. (only used with date dimension)"""
+
+    dimensions: List[
+        Literal[
+            "method",
+            "path",
+            "status_code",
+            "ip",
+            "user_agent",
+            "referer",
+            "query_params",
+            "bot_name",
+            "bot_provider",
+            "bot_types",
+        ]
+    ]
+    """Dimensions to group the report by."""
+
+    end_date: Annotated[Union[str, datetime], PropertyInfo(format="iso8601")]
+    """End date for logs.
+
+    Accepts same formats as start_date. Defaults to now if omitted.
+    """
+
+    filters: Iterable[Filter]
+    """List of filters to apply to the bots logs query."""
+
+    order_by: Dict[str, Literal["asc", "desc"]]
+    """Custom ordering of the report results.
+
+    The order is a record of key-value pairs where:
+
+    - key is the field to order by, which can be a metric or dimension
+    - value is the direction of the order, either 'asc' for ascending or 'desc' for
+      descending.
+
+    When not specified, the default order is the first metric in the query
+    descending.
+    """
+
+    pagination: Pagination
+    """Pagination settings for the report results."""
+
+
+class FilterBotNameFilter(TypedDict, total=False):
+    field: Required[Literal["bot_name"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[Union[str, SequenceNotStr[str]]]
+
+
+class FilterBotProviderFilter(TypedDict, total=False):
+    field: Required[Literal["bot_provider"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[Union[str, SequenceNotStr[str]]]
+
+
+class FilterBotTypesFilter(TypedDict, total=False):
+    field: Required[Literal["bot_types"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[
+        Union[Literal["ai_assistant", "ai_training", "index"], List[Literal["ai_assistant", "ai_training", "index"]]]
+    ]
+
+
+class FilterMethodFilter(TypedDict, total=False):
+    field: Required[Literal["method"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[Union[str, SequenceNotStr[str]]]
+
+
+class FilterAppModelsAgentAnalyticsFiltersPathFilter(TypedDict, total=False):
+    field: Required[Literal["path"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[Union[str, SequenceNotStr[str]]]
+
+
+class FilterStatusCodeFilter(TypedDict, total=False):
+    field: Required[Literal["status_code"]]
+
+    operator: Required[Literal["is", "not_is", "in", "not_in"]]
+
+    value: Required[Union[int, Iterable[int]]]
+
+
+class FilterIPFilter(TypedDict, total=False):
+    field: Required[Literal["ip"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[Union[str, SequenceNotStr[str]]]
+
+
+class FilterUserAgentFilter(TypedDict, total=False):
+    field: Required[Literal["user_agent"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[Union[str, SequenceNotStr[str]]]
+
+
+class FilterRefererFilter(TypedDict, total=False):
+    field: Required[Literal["referer"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[Union[str, SequenceNotStr[str]]]
+
+
+class FilterQueryParamsFilter(TypedDict, total=False):
+    field: Required[Literal["query_params"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[Union[str, SequenceNotStr[str]]]
+
+
+Filter: TypeAlias = Union[
+    FilterBotNameFilter,
+    FilterBotProviderFilter,
+    FilterBotTypesFilter,
+    FilterMethodFilter,
+    FilterAppModelsAgentAnalyticsFiltersPathFilter,
+    FilterStatusCodeFilter,
+    FilterIPFilter,
+    FilterUserAgentFilter,
+    FilterRefererFilter,
+    FilterQueryParamsFilter,
+]