listingsapi 0.5.2__tar.gz → 0.5.4__tar.gz

{listingsapi-0.5.2/src/listingsapi.egg-info → listingsapi-0.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: listingsapi
-Version: 0.5.2
+Version: 0.5.4
 Summary: Python SDK for listingsAPI — listings, reviews, posts, and analytics for local marketing
 Author-email: listingsAPI <support@listingsapi.com>
 License: MIT License
@@ -355,7 +355,7 @@ client.connected_accounts.oauth_disconnect(16808, "FACEBOOK")
 
 ```python
 sites = client.plan_sites()          # directories included in your plan
-countries = client.countries()       # supported countries and states
+countries = client.countries()       # supported countries, states, and address rules
 subcategories = client.subcategories()  # business categories (IDs for locations.add)
 subs = client.subscriptions()        # active subscriptions
 ```
@@ -389,7 +389,7 @@ print(f"Score: {audit.health_score}%, Issues: {audit.issue_count}")
 | Method | Description |
 |--------|-------------|
 | `client.plan_sites()` | Directories included in your plan |
-| `client.countries()` | Supported countries and states (ISO codes) |
+| `client.countries()` | Supported countries and states (ISO codes), with `hasCity`, `stateRequired` and `hasPostalCode` for each country |
 | `client.subcategories()` | Business categories (IDs for `locations.add`) |
 | `client.subscriptions()` | Active subscriptions for the account |
 

{listingsapi-0.5.2 → listingsapi-0.5.4}/README.md

@@ -303,7 +303,7 @@ client.connected_accounts.oauth_disconnect(16808, "FACEBOOK")
 
 ```python
 sites = client.plan_sites()          # directories included in your plan
-countries = client.countries()       # supported countries and states
+countries = client.countries()       # supported countries, states, and address rules
 subcategories = client.subcategories()  # business categories (IDs for locations.add)
 subs = client.subscriptions()        # active subscriptions
 ```
@@ -337,7 +337,7 @@ print(f"Score: {audit.health_score}%, Issues: {audit.issue_count}")
 | Method | Description |
 |--------|-------------|
 | `client.plan_sites()` | Directories included in your plan |
-| `client.countries()` | Supported countries and states (ISO codes) |
+| `client.countries()` | Supported countries and states (ISO codes), with `hasCity`, `stateRequired` and `hasPostalCode` for each country |
 | `client.subcategories()` | Business categories (IDs for `locations.add`) |
 | `client.subscriptions()` | Active subscriptions for the account |
 

{listingsapi-0.5.2 → listingsapi-0.5.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "listingsapi"
-version = "0.5.2"
+version = "0.5.4"
 description = "Python SDK for listingsAPI — listings, reviews, posts, and analytics for local marketing"
 readme = "README.md"
 requires-python = ">=3.9"

{listingsapi-0.5.2 → listingsapi-0.5.4}/src/listingsapi/__init__.py

@@ -23,7 +23,7 @@ from listingsapi.exceptions import (
     ValidationError,
 )
 
-__version__ = "0.5.2"
+__version__ = "0.5.4"
 
 __all__ = [
     # Client

{listingsapi-0.5.2 → listingsapi-0.5.4}/src/listingsapi/_client.py

@@ -263,7 +263,11 @@ class ListingsAPI:
         return [APIObject(item) for item in items]
 
     def countries(self) -> list[APIObject]:
-        """Get supported countries and states (ISO codes)."""
+        """Get supported countries and states (ISO codes).
+
+        Each country has ``hasCity``, ``stateRequired`` and ``hasPostalCode``,
+        which tell you which address fields a location in that country needs.
+        """
         data = self._get("countries")
         items = data.get("data", {}).get("supportedCountries") or []
         return [APIObject(item) for item in items]

{listingsapi-0.5.2 → listingsapi-0.5.4}/src/listingsapi/resources/connected_accounts.py

@@ -147,7 +147,7 @@ class ConnectedAccounts(APIResource):
                 }
             },
         )
-        return APIObject(data.get("data", {}).get("connectUrl") or {})
+        return APIObject(data.get("data", {}).get("createConnectUrl") or {})
 
     def oauth_disconnect(self, location_id: str | int, site: str) -> APIObject:
         """Disconnect a Google/Facebook profile from a single location."""

{listingsapi-0.5.2 → listingsapi-0.5.4}/src/listingsapi/resources/locations.py

@@ -191,8 +191,10 @@ class Locations(APIResource):
             city: City. Required for countries with city-level addressing; may be
                 omitted only for service-area businesses with hide_address=True.
             street: Street address.
-            state_iso: State/region ISO code.
-            postal_code: Postal or ZIP code.
+            state_iso: State/region ISO code. Required when the country's
+                ``stateRequired`` is true (see ``client.countries()``).
+            postal_code: Postal or ZIP code. Send it when the country's
+                ``hasPostalCode`` is true.
             phone: Primary phone number, validated for the country.
             website: Business website URL.
             store_id: Your unique store code; must be unique across the account.

{listingsapi-0.5.2 → listingsapi-0.5.4}/src/listingsapi/resources/photos.py

@@ -44,7 +44,7 @@ class Photos(APIResource):
         """Star or unstar photos. Max 4 starred photos per account."""
         data = self._post(
             "locations/photos/star",
-            {"input": {"locationId": encode_location_id(location_id), "mediaIds": media_ids, "starred": starred}},
+            {"input": {"locationId": encode_location_id(location_id), "photoIds": media_ids, "starred": starred}},
         )
         return APIObject(data.get("data", {}).get("starUnstarLocationPhotos") or {})
 

{listingsapi-0.5.2 → listingsapi-0.5.4}/src/listingsapi/resources/posts.py

@@ -30,13 +30,14 @@ class Posts(APIResource):
     """
 
     def create(self, body: dict[str, Any]) -> APIObject:
-        """Create a post from a raw body dict (flat fields, not input-wrapped).
+        """Create a post from a raw field dict.
 
-        Required: postName, locationIds (base64), postType, postSites. Prefer
-        create_announcement / create_event / create_offer for keyword arguments
-        and client-side validation.
+        Pass the fields flat — they are wrapped in the ``input`` object the API
+        requires before sending. Required: postName, locationIds (base64),
+        postType, postSites. Prefer create_announcement / create_event /
+        create_offer for keyword arguments and client-side validation.
         """
-        data = self._post("posts", body)
+        data = self._post("posts", {"input": body})
         return APIObject(data.get("data", {}).get("createSocialPost") or {})
 
     def create_announcement(
@@ -232,8 +233,8 @@ class Posts(APIResource):
             context_info=context_info,
             additional_fields=additional_fields,
         )
-        data = self._post("bulk-posts", body)
-        return APIObject(data.get("data", {}).get("createBulkSocialPost") or {})
+        data = self._post("bulk-posts", {"input": body})
+        return APIObject(data.get("data", {}).get("createSocialPost") or {})
 
     def retrieve(self, post_id: str) -> APIObject:
         """Get a post with its content, per-site publish status, and analytics."""
@@ -258,13 +259,16 @@ class Posts(APIResource):
         """List post campaigns targeting a location.
 
         Offset-paginated: returns .records plus .pageInfo with totalPages,
-        totalRecords, hasNextPage. tag defaults to "all" (the API errors when
-        it is omitted).
+        totalRecords, hasNextPage.
+
+        Note: this route rejects a tag — the API errors when one is sent — so
+        ``tag`` is accepted for backwards compatibility and never put on the
+        wire. Use bulk_list_for_location when you need tag filtering.
         """
-        params = self._list_params(tag, page, per_page, filters, sort_fields)
+        params = self._list_params(None, page, per_page, filters, sort_fields)
         encoded = encode_location_id(location_id)
         data = self._get(f"locations/{encoded}/posts", params)
-        return APIObject(data.get("data", {}).get("rollupSocialPosts") or {})
+        return APIObject(data.get("data", {}).get("postsByLocation") or {})
 
     def bulk_retrieve(self, bulk_post_id: str) -> APIObject:
         """Get a bulk campaign with per-location publish status and analytics."""
@@ -293,7 +297,7 @@ class Posts(APIResource):
             sites=sites if sites is not None else ["GOOGLE"],
             **kwargs,
         )
-        data = self._post("posts", body)
+        data = self._post("posts", {"input": body})
         return APIObject(data.get("data", {}).get("createSocialPost") or {})
 
     def _build_post_body(
@@ -358,13 +362,15 @@ class Posts(APIResource):
 
     def _list_params(
         self,
-        tag: str,
+        tag: str | None,
         page: int | None,
         per_page: int | None,
         filters: dict[str, Any] | None,
         sort_fields: dict[str, Any] | None,
     ) -> dict[str, Any]:
-        params: dict[str, Any] = {"tag": tag}
+        params: dict[str, Any] = {}
+        if tag is not None:
+            params["tag"] = tag
         if page is not None:
             params["page"] = page
         if per_page is not None:

{listingsapi-0.5.2 → listingsapi-0.5.4/src/listingsapi.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: listingsapi
-Version: 0.5.2
+Version: 0.5.4
 Summary: Python SDK for listingsAPI — listings, reviews, posts, and analytics for local marketing
 Author-email: listingsAPI <support@listingsapi.com>
 License: MIT License
@@ -355,7 +355,7 @@ client.connected_accounts.oauth_disconnect(16808, "FACEBOOK")
 
 ```python
 sites = client.plan_sites()          # directories included in your plan
-countries = client.countries()       # supported countries and states
+countries = client.countries()       # supported countries, states, and address rules
 subcategories = client.subcategories()  # business categories (IDs for locations.add)
 subs = client.subscriptions()        # active subscriptions
 ```
@@ -389,7 +389,7 @@ print(f"Score: {audit.health_score}%, Issues: {audit.issue_count}")
 | Method | Description |
 |--------|-------------|
 | `client.plan_sites()` | Directories included in your plan |
-| `client.countries()` | Supported countries and states (ISO codes) |
+| `client.countries()` | Supported countries and states (ISO codes), with `hasCity`, `stateRequired` and `hasPostalCode` for each country |
 | `client.subcategories()` | Business categories (IDs for `locations.add`) |
 | `client.subscriptions()` | Active subscriptions for the account |
 

{listingsapi-0.5.2 → listingsapi-0.5.4}/tests/test_listingsapi.py

@@ -450,7 +450,7 @@ def test_analytics_google(client):
 
 
 def test_version():
-    assert listingsapi.__version__ == "0.5.2"
+    assert listingsapi.__version__ == "0.5.4"
 
 
 # --- locations.add (one-call create with validation) ---
@@ -658,7 +658,7 @@ CREATE_POST_OK = {
 }
 BULK_POST_OK = {
     "data": {
-        "createBulkSocialPost": {
+        "createSocialPost": {
             "success": True,
             "errors": [],
             "socialPost": {"id": "QnVsa1Bvc3Q6OTk=", "status": "INPROGRESS"},
@@ -667,7 +667,7 @@ BULK_POST_OK = {
 }
 
 
-def test_posts_create_announcement_builds_flat_body(client):
+def test_posts_create_announcement_wraps_body_in_input(client):
     with requests_mock.Mocker() as m:
         m.post("https://listingsapi.com/api/v4/posts", json=CREATE_POST_OK)
         result = client.posts.create_announcement(
@@ -680,8 +680,9 @@ def test_posts_create_announcement_builds_flat_body(client):
             media_url="https://cdn.example.com/opening.jpg",
         )
         assert result.success is True
-        sent = m.last_request.json()
-        assert "input" not in sent
+        envelope = m.last_request.json()
+        assert list(envelope) == ["input"]
+        sent = envelope["input"]
         assert sent["postName"] == "Grand Opening"
         assert sent["postType"] == "ANNOUNCEMENT"
         assert sent["postSites"] == ["GOOGLE"]
@@ -691,6 +692,34 @@ def test_posts_create_announcement_builds_flat_body(client):
         assert sent["postMediaUrl"] == [{"site": "GOOGLE", "url": "https://cdn.example.com/opening.jpg", "type": "IMAGE"}]
 
 
+def test_posts_create_raw_body_is_input_wrapped(client):
+    with requests_mock.Mocker() as m:
+        m.post("https://listingsapi.com/api/v4/posts", json=CREATE_POST_OK)
+        result = client.posts.create({
+            "postName": "Raw",
+            "locationIds": ["TG9jYXRpb246MTY4MDg="],
+            "postType": "ANNOUNCEMENT",
+            "postSites": ["GOOGLE"],
+        })
+        assert result.success is True
+        envelope = m.last_request.json()
+        assert list(envelope) == ["input"]
+        assert envelope["input"]["postName"] == "Raw"
+
+
+def test_posts_bulk_publish_wraps_body_in_input(client):
+    with requests_mock.Mocker() as m:
+        m.post("https://listingsapi.com/api/v4/bulk-posts", json=BULK_POST_OK)
+        result = client.posts.bulk_publish(
+            name="Holiday hours", location_ids=[16808], message="Open late!",
+        )
+        # reads createSocialPost, not createBulkSocialPost
+        assert result.socialPost.id == "QnVsa1Bvc3Q6OTk="
+        envelope = m.last_request.json()
+        assert list(envelope) == ["input"]
+        assert envelope["input"]["postName"] == "Holiday hours"
+
+
 def test_posts_bulk_publish_defaults_to_google_and_facebook(client):
     with requests_mock.Mocker() as m:
         m.post("https://listingsapi.com/api/v4/bulk-posts", json=BULK_POST_OK)
@@ -700,7 +729,7 @@ def test_posts_bulk_publish_defaults_to_google_and_facebook(client):
             message="Open late through the holidays!",
         )
         assert result.success is True
-        sent = m.last_request.json()
+        sent = m.last_request.json()["input"]
         assert sent["postSites"] == ["GOOGLE", "FACEBOOK"]
         assert len(sent["postMessage"]) == 2
         assert {e["site"] for e in sent["postMessage"]} == {"GOOGLE", "FACEBOOK"}
@@ -715,7 +744,7 @@ def test_posts_bulk_publish_per_site_messages(client):
             location_ids=[16808],
             message={"GOOGLE": "New summer menu!", "FACEBOOK": "Swing by for the summer menu."},
         )
-        sent = m.last_request.json()
+        sent = m.last_request.json()["input"]
         by_site = {e["site"]: e["message"] for e in sent["postMessage"]}
         assert by_site["GOOGLE"] == "New summer menu!"
         assert by_site["FACEBOOK"] == "Swing by for the summer menu."
@@ -767,7 +796,7 @@ def test_posts_create_event_context(client):
             start_time="7:00pm",
             end_time="10:00pm",
         )
-        sent = m.last_request.json()
+        sent = m.last_request.json()["input"]
         assert sent["postType"] == "EVENT"
         assert sent["postContextInfo"] == {
             "title": "Jazz Night", "startDay": "2026-08-01", "endDay": "2026-08-01",
@@ -789,7 +818,7 @@ def test_posts_create_offer_context(client):
             start_day="2026-08-01",
             end_day="2026-08-07",
         )
-        sent = m.last_request.json()
+        sent = m.last_request.json()["input"]
         assert sent["postType"] == "OFFER"
         assert sent["postContextInfo"]["couponCode"] == "SUMMER20"
         assert sent["postContextInfo"]["title"] == "Summer Sale"
@@ -808,17 +837,35 @@ def test_posts_retrieve_and_bulk_retrieve(client):
         assert bulk.socialPostId == "QnVsa1Bvc3Q6OTk="
 
 
-def test_posts_list_for_location_defaults_tag_all(client):
-    response = {"data": {"rollupSocialPosts": {"records": [{"id": "p1"}], "pageInfo": {"totalPages": 1, "totalRecords": 1, "hasNextPage": False}}}}
+def test_posts_list_for_location_sends_no_tag_and_reads_posts_by_location(client):
+    response = {"data": {"postsByLocation": {"records": [{"id": "p1"}], "pageInfo": {"totalPages": 1, "totalRecords": 1, "hasNextPage": False}}}}
     with requests_mock.Mocker() as m:
         m.get("https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTY4MDg=/posts", json=response)
         result = client.posts.list_for_location(16808, page=1, per_page=10)
         assert result.records[0].id == "p1"
         assert result.pageInfo.totalRecords == 1
-        assert m.last_request.qs["tag"] == ["all"]
+        # the route raises when a tag is supplied, so none is sent
+        assert "tag" not in m.last_request.qs
         assert m.last_request.qs["page"] == ["1"]
 
 
+def test_posts_list_for_location_ignores_tag_argument(client):
+    response = {"data": {"postsByLocation": {"records": []}}}
+    with requests_mock.Mocker() as m:
+        m.get("https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTY4MDg=/posts", json=response)
+        client.posts.list_for_location(16808, tag="all")
+        assert "tag" not in m.last_request.qs
+
+
+def test_posts_bulk_list_for_location_still_sends_tag(client):
+    response = {"data": {"rollupSocialPosts": {"records": [{"id": "b1"}]}}}
+    with requests_mock.Mocker() as m:
+        m.get("https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTY4MDg=/bulk-posts", json=response)
+        result = client.posts.bulk_list_for_location(16808)
+        assert result.records[0].id == "b1"
+        assert m.last_request.qs["tag"] == ["all"]
+
+
 def test_posts_delete(client):
     with requests_mock.Mocker() as m:
         m.delete("https://listingsapi.com/api/v4/posts/U29jaWFsUG9zdDo0NDEyMg==",
@@ -828,7 +875,7 @@ def test_posts_delete(client):
 
 
 def test_posts_bulk_publish_api_failure_raises(client):
-    body = {"data": {"createBulkSocialPost": {"success": False, "errors": [{"code": "SY20001", "message": "Image URL unreachable"}]}}}
+    body = {"data": {"createSocialPost": {"success": False, "errors": [{"code": "SY20001", "message": "Image URL unreachable"}]}}}
     with requests_mock.Mocker() as m:
         m.post("https://listingsapi.com/api/v4/bulk-posts", json=body)
         with pytest.raises(ValidationError) as exc:
@@ -955,3 +1002,31 @@ def test_post_without_key_sends_no_idempotency_header(client):
         m.post("https://listingsapi.com/api/v4/locations", json={"data": {}})
         client._post("locations", {"input": {"name": "Acme"}})
         assert "Idempotency-Key" not in m.last_request.headers
+
+
+# --- Wire-shape fixes swept in 0.5.3 ---
+
+def test_photos_star_sends_photo_ids(client):
+    response = {"data": {"starUnstarLocationPhotos": {"success": True}}}
+    with requests_mock.Mocker() as m:
+        m.post("https://listingsapi.com/api/v4/locations/photos/star", json=response)
+        result = client.photos.star(16808, ["TWVkaWFGaWxlOjE="])
+        assert result.success is True
+        sent = m.last_request.json()["input"]
+        assert sent["photoIds"] == ["TWVkaWFGaWxlOjE="]
+        assert "mediaIds" not in sent
+        assert sent["starred"] is True
+        assert sent["locationId"] == "TG9jYXRpb246MTY4MDg="
+
+
+def test_connected_accounts_oauth_url_reads_create_connect_url(client):
+    response = {"data": {"createConnectUrl": {"url": "https://oauth.example/x", "success": True}}}
+    with requests_mock.Mocker() as m:
+        m.post("https://listingsapi.com/api/v4/locations/oauth_connect_url", json=response)
+        result = client.connected_accounts.oauth_url(
+            16808, "google", "https://ok.example", "https://err.example"
+        )
+        assert result.url == "https://oauth.example/x"
+        sent = m.last_request.json()["input"]
+        assert sent["locationId"] == "TG9jYXRpb246MTY4MDg="
+        assert sent["site"] == "GOOGLE"