all good

finder/rightmove.py

@@ -58,6 +58,7 @@ def _paginate(
     channel_cfg: dict,
     pc_index: PostcodeSpatialIndex,
     extra_params: dict | None = None,
+    max_properties: int | None = None,
 ) -> tuple[list[dict], int]:
     """Paginate through search results. Returns (properties, result_count)."""
     properties = []
@@ -94,6 +95,8 @@ def _paginate(
             transformed = transform_property(prop, outcode, pc_index)
             if transformed:
                 properties.append(transformed)
+                if max_properties is not None and len(properties) >= max_properties:
+                    return properties, result_count
 
         # Check if there are more pages
         result_count_str = data.get("resultCount", "0")
@@ -114,6 +117,7 @@ def search_outcode(
     outcode: str,
     channel_cfg: dict,
     pc_index: PostcodeSpatialIndex,
+    max_properties: int | None = None,
 ) -> list[dict]:
     """Paginate through search results for one outcode+channel. Returns transformed properties.
 
@@ -121,9 +125,12 @@ def search_outcode(
     re-queries per property type to recover listings beyond the cap.
     """
     properties, result_count = _paginate(
-        client, outcode_id, outcode, channel_cfg, pc_index
+        client, outcode_id, outcode, channel_cfg, pc_index, max_properties=max_properties
     )
 
+    if max_properties is not None and len(properties) >= max_properties:
+        return properties[:max_properties]
+
     if result_count <= _MAX_INDEX:
         return properties
 
@@ -140,17 +147,28 @@ def search_outcode(
         pt_props, _ = _paginate(
             client, outcode_id, outcode, channel_cfg, pc_index,
             extra_params={"propertyTypes": pt},
+            max_properties=max_properties,
         )
         new = 0
         for p in pt_props:
             if p["id"] not in all_by_id:
                 all_by_id[p["id"]] = p
                 new += 1
+                if (
+                    max_properties is not None
+                    and len(all_by_id) >= max_properties
+                ):
+                    break
         if new:
             log.debug("%s/%s type=%s: +%d new properties", outcode, ch, pt, new)
+        if max_properties is not None and len(all_by_id) >= max_properties:
+            break
 
     log.info(
         "%s/%s: type split recovered %d → %d properties",
         outcode, ch, len(properties), len(all_by_id),
     )
-    return list(all_by_id.values())
+    properties = list(all_by_id.values())
+    if max_properties is not None:
+        return properties[:max_properties]
+    return properties