zernio-sdk 1.4.331__tar.gz → 1.4.332__tar.gz

{zernio_sdk-1.4.331 → zernio_sdk-1.4.332}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: zernio-sdk
-Version: 1.4.331
+Version: 1.4.332
 Summary: The official Python library for the Zernio API
 Project-URL: Homepage, https://zernio.com
 Project-URL: Documentation, https://docs.zernio.com
@@ -459,6 +459,7 @@ Both `from zernio import ...` and `from late import ...` work identically. The `
 | Method | Description |
 |--------|-------------|
 | `ad_campaigns.list_ad_campaigns()` | List campaigns |
+| `ad_campaigns.list_ad_keywords()` | List Search keywords |
 | `ad_campaigns.list_ads()` | List ads |
 | `ad_campaigns.bulk_update_ad_campaign_status()` | Pause or resume many campaigns |
 | `ad_campaigns.create_ad_campaign()` | Create a standalone campaign |

{zernio_sdk-1.4.331 → zernio_sdk-1.4.332}/README.md

@@ -406,6 +406,7 @@ Both `from zernio import ...` and `from late import ...` work identically. The `
 | Method | Description |
 |--------|-------------|
 | `ad_campaigns.list_ad_campaigns()` | List campaigns |
+| `ad_campaigns.list_ad_keywords()` | List Search keywords |
 | `ad_campaigns.list_ads()` | List ads |
 | `ad_campaigns.bulk_update_ad_campaign_status()` | Pause or resume many campaigns |
 | `ad_campaigns.create_ad_campaign()` | Create a standalone campaign |

{zernio_sdk-1.4.331 → zernio_sdk-1.4.332}/openapi.yaml

@@ -33711,6 +33711,67 @@ paths:
         '403':
           description: Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans.
 
+  /v1/ads/keywords:
+    get:
+      operationId: listAdKeywords
+      tags: ["Ad Campaigns"]
+      x-platforms: ["google"]
+      summary: List Search keywords
+      description: |
+        Returns the Google Search keyword criteria (positive and negative) synced from
+        connected Google Ads accounts, one row per ad-group keyword. Populated by the
+        periodic ads discovery sweep (roughly every 3 hours per account), so keywords
+        added on Google appear with that delay. Campaign-level negative keywords are
+        not included; only ad-group-level criteria are.
+      security:
+        - bearerAuth: []
+      parameters:
+        - $ref: '#/components/parameters/PageParam'
+        - { name: limit, in: query, schema: { type: integer, minimum: 1, maximum: 500, default: 50 } }
+        - { name: accountId, in: query, schema: { type: string }, description: Social account ID }
+        - { name: adAccountId, in: query, schema: { type: string }, description: 'Platform ad account ID (Google customer ID). Mirrors the same filter on /v1/ads.' }
+        - { name: profileId, in: query, schema: { type: string }, description: Profile ID }
+        - { name: campaignId, in: query, schema: { type: string }, description: Platform campaign ID }
+        - { name: adSetId, in: query, schema: { type: string }, description: 'Platform ad group ID (Google ad group)' }
+        - { name: status, in: query, schema: { type: string, enum: [active, paused] }, description: Keyword criterion status }
+        - { name: matchType, in: query, schema: { type: string, enum: [exact, phrase, broad, unknown] } }
+        - { name: negative, in: query, schema: { type: boolean }, description: 'true = negative keywords only, false = positive only. Omit for both.' }
+        - { name: search, in: query, schema: { type: string, maxLength: 200 }, description: 'Case-insensitive substring match on the keyword text' }
+      responses:
+        '200':
+          description: Paginated keywords
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  keywords:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id: { type: string }
+                        accountId: { type: string, description: Social account ID owning the sync }
+                        profileId: { type: string }
+                        platform: { type: string, enum: [google] }
+                        adAccountId: { type: string, description: Google customer ID }
+                        campaignId: { type: string }
+                        campaignName: { type: [string, "null"] }
+                        campaignStatus: { type: [string, "null"] }
+                        adSetId: { type: string, description: Google ad group ID }
+                        adSetName: { type: [string, "null"] }
+                        adSetStatus: { type: [string, "null"] }
+                        keyword: { type: string }
+                        matchType: { type: string, enum: [exact, phrase, broad, unknown] }
+                        status: { type: string, enum: [active, paused] }
+                        negative: { type: boolean }
+                        syncedAt: { type: [string, "null"], format: date-time }
+                  pagination: { $ref: '#/components/schemas/Pagination' }
+        '400': { $ref: '#/components/responses/BadRequest' }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans.
+
   /v1/ads/campaigns:
     get:
       operationId: listAdCampaigns

{zernio_sdk-1.4.331 → zernio_sdk-1.4.332}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "zernio-sdk"
-version = "1.4.331"
+version = "1.4.332"
 description = "The official Python library for the Zernio API"
 readme = "README.md"
 requires-python = ">=3.10"

{zernio_sdk-1.4.331 → zernio_sdk-1.4.332}/src/late/__init__.py

@@ -42,7 +42,7 @@ from .enums import (
     Visibility,
 )
 
-__version__ = "1.4.331"
+__version__ = "1.4.332"
 
 __all__ = [
     # Client

{zernio_sdk-1.4.331 → zernio_sdk-1.4.332}/src/late/mcp/generated_tools.py

@@ -1777,6 +1777,60 @@ def register_generated_tools(mcp, _get_client):
         except Exception as e:
             return f"Error: {e}"
 
+    @mcp.tool(
+        annotations=ToolAnnotations(
+            title="List Search keywords",
+            readOnlyHint=True,
+            destructiveHint=False,
+            openWorldHint=False,
+        )
+    )
+    def ad_campaigns_list_ad_keywords(
+        page: int = 1,
+        limit: int = 50,
+        account_id: str | None = None,
+        ad_account_id: str | None = None,
+        profile_id: str | None = None,
+        campaign_id: str | None = None,
+        ad_set_id: str | None = None,
+        status: str | None = None,
+        match_type: str | None = None,
+        negative: bool | None = None,
+        search: str | None = None,
+    ) -> str:
+        """List Search keywords
+
+        Args:
+            page: Page number
+            limit
+            account_id: Social account ID
+            ad_account_id: Platform ad account ID (Google customer ID). Mirrors the same filter on /v1/ads.
+            profile_id: Profile ID
+            campaign_id: Platform campaign ID
+            ad_set_id: Platform ad group ID (Google ad group)
+            status: Keyword criterion status
+            match_type
+            negative: true = negative keywords only, false = positive only. Omit for both.
+            search: Case-insensitive substring match on the keyword text"""
+        client = _get_client()
+        try:
+            response = client.ad_campaigns.list_ad_keywords(
+                page=page,
+                limit=limit,
+                account_id=account_id,
+                ad_account_id=ad_account_id,
+                profile_id=profile_id,
+                campaign_id=campaign_id,
+                ad_set_id=ad_set_id,
+                status=status,
+                match_type=match_type,
+                negative=negative,
+                search=search,
+            )
+            return _format_response(response)
+        except Exception as e:
+            return f"Error: {e}"
+
     @mcp.tool(
         annotations=ToolAnnotations(
             title="List campaigns",

{zernio_sdk-1.4.331 → zernio_sdk-1.4.332}/src/late/models/_generated/models.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  openapi.yaml
-#   timestamp: 2026-07-24T18:20:53+00:00
+#   timestamp: 2026-07-27T09:31:44+00:00
 
 from __future__ import annotations
 

{zernio_sdk-1.4.331 → zernio_sdk-1.4.332}/src/late/resources/_generated/ad_campaigns.py

@@ -93,6 +93,37 @@ class AdCampaignsResource:
         )
         return self._client._get("/v1/ads", params=params)
 
+    def list_ad_keywords(
+        self,
+        *,
+        page: int | None = 1,
+        limit: int | None = 50,
+        account_id: str | None = None,
+        ad_account_id: str | None = None,
+        profile_id: str | None = None,
+        campaign_id: str | None = None,
+        ad_set_id: str | None = None,
+        status: str | None = None,
+        match_type: str | None = None,
+        negative: bool | None = None,
+        search: str | None = None,
+    ) -> dict[str, Any]:
+        """List Search keywords"""
+        params = self._build_params(
+            page=page,
+            limit=limit,
+            account_id=account_id,
+            ad_account_id=ad_account_id,
+            profile_id=profile_id,
+            campaign_id=campaign_id,
+            ad_set_id=ad_set_id,
+            status=status,
+            match_type=match_type,
+            negative=negative,
+            search=search,
+        )
+        return self._client._get("/v1/ads/keywords", params=params)
+
     def list_ad_campaigns(
         self,
         *,
@@ -670,6 +701,37 @@ class AdCampaignsResource:
         )
         return await self._client._aget("/v1/ads", params=params)
 
+    async def alist_ad_keywords(
+        self,
+        *,
+        page: int | None = 1,
+        limit: int | None = 50,
+        account_id: str | None = None,
+        ad_account_id: str | None = None,
+        profile_id: str | None = None,
+        campaign_id: str | None = None,
+        ad_set_id: str | None = None,
+        status: str | None = None,
+        match_type: str | None = None,
+        negative: bool | None = None,
+        search: str | None = None,
+    ) -> dict[str, Any]:
+        """List Search keywords (async)"""
+        params = self._build_params(
+            page=page,
+            limit=limit,
+            account_id=account_id,
+            ad_account_id=ad_account_id,
+            profile_id=profile_id,
+            campaign_id=campaign_id,
+            ad_set_id=ad_set_id,
+            status=status,
+            match_type=match_type,
+            negative=negative,
+            search=search,
+        )
+        return await self._client._aget("/v1/ads/keywords", params=params)
+
     async def alist_ad_campaigns(
         self,
         *,

{zernio_sdk-1.4.331 → zernio_sdk-1.4.332}/uv.lock

@@ -2389,7 +2389,7 @@ wheels = [
 
 [[package]]
 name = "zernio-sdk"
-version = "1.4.330"
+version = "1.4.331"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },