feat(scrape): add g2-reviews prebuilt parser (#1933)

Stainless-Generated-From: eb89afdde0b42786e66e41af2130cb057736b8c8

Author: stlc-bot

src/context/dev/types/batch_get_results_response.py

@@ -294,7 +294,7 @@ class DataOkResultMetadata(BaseModel):
 
 class DataOkResultParsed(BaseModel):
     """
-    Custom rules return fields after content filters; unmatched fields are null ([] for lists). The google-maps parser returns business records in data.results, google-maps-reviews returns data.reviews, and the google-play parser returns one app record as data, google-play-reviews returns data.reviews, app-store and app-store-reviews do the same for the App Store, emails, phone-numbers, and links return data.emails, data.phone_numbers, and data.links from the rendered page; the store and Maps parsers read their data directly, independently of DOM filters and other outputs.
+    Custom rules return fields after content filters; unmatched fields are null ([] for lists). The google-maps parser returns business records in data.results, google-maps-reviews returns data.reviews, and the google-play parser returns one app record as data, google-play-reviews returns data.reviews, app-store and app-store-reviews do the same for the App Store, g2-reviews returns data.reviews for a G2 product, emails, phone-numbers, and links return data.emails, data.phone_numbers, and data.links from the rendered page; the store, Maps, and G2 parsers read their data directly, independently of DOM filters and other outputs.
     """
 
     data: Optional[Dict[str, object]] = None
@@ -312,6 +312,7 @@ class DataOkResultParsed(BaseModel):
         "google-play-reviews",
         "app-store",
         "app-store-reviews",
+        "g2-reviews",
         "emails",
         "phone-numbers",
         "links",
@@ -506,10 +507,11 @@ class DataOkResult(BaseModel):
     for lists). The google-maps parser returns business records in data.results,
     google-maps-reviews returns data.reviews, and the google-play parser returns one
     app record as data, google-play-reviews returns data.reviews, app-store and
-    app-store-reviews do the same for the App Store, emails, phone-numbers, and
-    links return data.emails, data.phone_numbers, and data.links from the rendered
-    page; the store and Maps parsers read their data directly, independently of DOM
-    filters and other outputs.
+    app-store-reviews do the same for the App Store, g2-reviews returns data.reviews
+    for a G2 product, emails, phone-numbers, and links return data.emails,
+    data.phone_numbers, and data.links from the rendered page; the store, Maps, and
+    G2 parsers read their data directly, independently of DOM filters and other
+    outputs.
     """
 
     product: DataOkResultProduct
@@ -811,7 +813,7 @@ class DataErrorResultMetadata(BaseModel):
 
 class DataErrorResultParsed(BaseModel):
     """
-    Custom rules return fields after content filters; unmatched fields are null ([] for lists). The google-maps parser returns business records in data.results, google-maps-reviews returns data.reviews, and the google-play parser returns one app record as data, google-play-reviews returns data.reviews, app-store and app-store-reviews do the same for the App Store, emails, phone-numbers, and links return data.emails, data.phone_numbers, and data.links from the rendered page; the store and Maps parsers read their data directly, independently of DOM filters and other outputs.
+    Custom rules return fields after content filters; unmatched fields are null ([] for lists). The google-maps parser returns business records in data.results, google-maps-reviews returns data.reviews, and the google-play parser returns one app record as data, google-play-reviews returns data.reviews, app-store and app-store-reviews do the same for the App Store, g2-reviews returns data.reviews for a G2 product, emails, phone-numbers, and links return data.emails, data.phone_numbers, and data.links from the rendered page; the store, Maps, and G2 parsers read their data directly, independently of DOM filters and other outputs.
     """
 
     data: Optional[Dict[str, object]] = None
@@ -829,6 +831,7 @@ class DataErrorResultParsed(BaseModel):
         "google-play-reviews",
         "app-store",
         "app-store-reviews",
+        "g2-reviews",
         "emails",
         "phone-numbers",
         "links",
@@ -1024,10 +1027,11 @@ class DataErrorResult(BaseModel):
     for lists). The google-maps parser returns business records in data.results,
     google-maps-reviews returns data.reviews, and the google-play parser returns one
     app record as data, google-play-reviews returns data.reviews, app-store and
-    app-store-reviews do the same for the App Store, emails, phone-numbers, and
-    links return data.emails, data.phone_numbers, and data.links from the rendered
-    page; the store and Maps parsers read their data directly, independently of DOM
-    filters and other outputs.
+    app-store-reviews do the same for the App Store, g2-reviews returns data.reviews
+    for a G2 product, emails, phone-numbers, and links return data.emails,
+    data.phone_numbers, and data.links from the rendered page; the store, Maps, and
+    G2 parsers read their data directly, independently of DOM filters and other
+    outputs.
     """
 
     product: DataErrorResultProduct

src/context/dev/types/batch_submit_params.py

@@ -247,6 +247,7 @@ class InputScrapeDataParseParamsPrebuiltParser(TypedDict, total=False):
             "google-play-reviews",
             "app-store",
             "app-store-reviews",
+            "g2-reviews",
             "emails",
             "phone-numbers",
             "links",
@@ -272,17 +273,22 @@ class InputScrapeDataParseParamsPrebuiltParser(TypedDict, total=False):
     data: details, developer, ratings, price, version, and screenshots.
     app-store-reviews returns up to the 500 newest reviews in data.reviews. Both App
     Store parsers accept app URLs (apps.apple.com/us/app/…/id…); the country in the
-    path sets the storefront, defaulting to us. emails accepts any page and returns
-    its email addresses as data.emails ([{ email }]), read from mailto links,
-    Cloudflare-protected addresses, and visible text. phone-numbers accepts any page
-    and returns its valid phone numbers in E.164 as data.phone_numbers ([{ phone
-    }]), read from tel links and visible text; numbers without a country code are
-    read for the country of the site TLD, defaulting to US. links accepts any page
-    and returns its unique http(s) links as data.links ([{ url, text }]), with
-    absolute URLs; text falls back to aria-label or image alt and is null when a
-    link has none. The emails parser reads the rendered page and respects content
-    filters; the other prebuilt parsers read their data independently of DOM
-    filters.
+    path sets the storefront, defaulting to us. g2-reviews returns the 25 most
+    recently published reviews of a G2 product in data.reviews (rating, title,
+    likes, dislikes, problems_solved, reviewer role, company size, and industry),
+    plus data.product. It accepts G2 product URLs (g2.com/products/…), follows
+    renamed products, and keeps star-rating filters from the URL
+    (filters[nps_score][]=1 to 5); other filters, sort orders, and pages are
+    ignored. emails accepts any page and returns its email addresses as data.emails
+    ([{ email }]), read from mailto links, Cloudflare-protected addresses, and
+    visible text. phone-numbers accepts any page and returns its valid phone numbers
+    in E.164 as data.phone_numbers ([{ phone }]), read from tel links and visible
+    text; numbers without a country code are read for the country of the site TLD,
+    defaulting to US. links accepts any page and returns its unique http(s) links as
+    data.links ([{ url, text }]), with absolute URLs; text falls back to aria-label
+    or image alt and is null when a link has none. The emails parser reads the
+    rendered page and respects content filters; the other prebuilt parsers read
+    their data independently of DOM filters.
     """
 
     type: Required[Literal["prebuilt"]]
@@ -812,6 +818,7 @@ class InputCrawlDataParseParamsPrebuiltParser(TypedDict, total=False):
             "google-play-reviews",
             "app-store",
             "app-store-reviews",
+            "g2-reviews",
             "emails",
             "phone-numbers",
             "links",
@@ -837,17 +844,22 @@ class InputCrawlDataParseParamsPrebuiltParser(TypedDict, total=False):
     data: details, developer, ratings, price, version, and screenshots.
     app-store-reviews returns up to the 500 newest reviews in data.reviews. Both App
     Store parsers accept app URLs (apps.apple.com/us/app/…/id…); the country in the
-    path sets the storefront, defaulting to us. emails accepts any page and returns
-    its email addresses as data.emails ([{ email }]), read from mailto links,
-    Cloudflare-protected addresses, and visible text. phone-numbers accepts any page
-    and returns its valid phone numbers in E.164 as data.phone_numbers ([{ phone
-    }]), read from tel links and visible text; numbers without a country code are
-    read for the country of the site TLD, defaulting to US. links accepts any page
-    and returns its unique http(s) links as data.links ([{ url, text }]), with
-    absolute URLs; text falls back to aria-label or image alt and is null when a
-    link has none. The emails parser reads the rendered page and respects content
-    filters; the other prebuilt parsers read their data independently of DOM
-    filters.
+    path sets the storefront, defaulting to us. g2-reviews returns the 25 most
+    recently published reviews of a G2 product in data.reviews (rating, title,
+    likes, dislikes, problems_solved, reviewer role, company size, and industry),
+    plus data.product. It accepts G2 product URLs (g2.com/products/…), follows
+    renamed products, and keeps star-rating filters from the URL
+    (filters[nps_score][]=1 to 5); other filters, sort orders, and pages are
+    ignored. emails accepts any page and returns its email addresses as data.emails
+    ([{ email }]), read from mailto links, Cloudflare-protected addresses, and
+    visible text. phone-numbers accepts any page and returns its valid phone numbers
+    in E.164 as data.phone_numbers ([{ phone }]), read from tel links and visible
+    text; numbers without a country code are read for the country of the site TLD,
+    defaulting to US. links accepts any page and returns its unique http(s) links as
+    data.links ([{ url, text }]), with absolute URLs; text falls back to aria-label
+    or image alt and is null when a link has none. The emails parser reads the
+    rendered page and respects content filters; the other prebuilt parsers read
+    their data independently of DOM filters.
     """
 
     type: Required[Literal["prebuilt"]]

src/context/dev/types/web_scrape_params.py

@@ -215,6 +215,7 @@ class ParseParamsPrebuiltParser(TypedDict, total=False):
             "google-play-reviews",
             "app-store",
             "app-store-reviews",
+            "g2-reviews",
             "emails",
             "phone-numbers",
             "links",
@@ -240,17 +241,22 @@ class ParseParamsPrebuiltParser(TypedDict, total=False):
     data: details, developer, ratings, price, version, and screenshots.
     app-store-reviews returns up to the 500 newest reviews in data.reviews. Both App
     Store parsers accept app URLs (apps.apple.com/us/app/…/id…); the country in the
-    path sets the storefront, defaulting to us. emails accepts any page and returns
-    its email addresses as data.emails ([{ email }]), read from mailto links,
-    Cloudflare-protected addresses, and visible text. phone-numbers accepts any page
-    and returns its valid phone numbers in E.164 as data.phone_numbers ([{ phone
-    }]), read from tel links and visible text; numbers without a country code are
-    read for the country of the site TLD, defaulting to US. links accepts any page
-    and returns its unique http(s) links as data.links ([{ url, text }]), with
-    absolute URLs; text falls back to aria-label or image alt and is null when a
-    link has none. The emails parser reads the rendered page and respects content
-    filters; the other prebuilt parsers read their data independently of DOM
-    filters.
+    path sets the storefront, defaulting to us. g2-reviews returns the 25 most
+    recently published reviews of a G2 product in data.reviews (rating, title,
+    likes, dislikes, problems_solved, reviewer role, company size, and industry),
+    plus data.product. It accepts G2 product URLs (g2.com/products/…), follows
+    renamed products, and keeps star-rating filters from the URL
+    (filters[nps_score][]=1 to 5); other filters, sort orders, and pages are
+    ignored. emails accepts any page and returns its email addresses as data.emails
+    ([{ email }]), read from mailto links, Cloudflare-protected addresses, and
+    visible text. phone-numbers accepts any page and returns its valid phone numbers
+    in E.164 as data.phone_numbers ([{ phone }]), read from tel links and visible
+    text; numbers without a country code are read for the country of the site TLD,
+    defaulting to US. links accepts any page and returns its unique http(s) links as
+    data.links ([{ url, text }]), with absolute URLs; text falls back to aria-label
+    or image alt and is null when a link has none. The emails parser reads the
+    rendered page and respects content filters; the other prebuilt parsers read
+    their data independently of DOM filters.
     """
 
     type: Required[Literal["prebuilt"]]

src/context/dev/types/web_scrape_response.py

@@ -267,7 +267,7 @@ class Metadata(BaseModel):
 
 class Parsed(BaseModel):
     """
-    Custom rules return fields after content filters; unmatched fields are null ([] for lists). The google-maps parser returns business records in data.results, google-maps-reviews returns data.reviews, and the google-play parser returns one app record as data, google-play-reviews returns data.reviews, app-store and app-store-reviews do the same for the App Store, emails, phone-numbers, and links return data.emails, data.phone_numbers, and data.links from the rendered page; the store and Maps parsers read their data directly, independently of DOM filters and other outputs.
+    Custom rules return fields after content filters; unmatched fields are null ([] for lists). The google-maps parser returns business records in data.results, google-maps-reviews returns data.reviews, and the google-play parser returns one app record as data, google-play-reviews returns data.reviews, app-store and app-store-reviews do the same for the App Store, g2-reviews returns data.reviews for a G2 product, emails, phone-numbers, and links return data.emails, data.phone_numbers, and data.links from the rendered page; the store, Maps, and G2 parsers read their data directly, independently of DOM filters and other outputs.
     """
 
     data: Optional[Dict[str, object]] = None
@@ -285,6 +285,7 @@ class Parsed(BaseModel):
         "google-play-reviews",
         "app-store",
         "app-store-reviews",
+        "g2-reviews",
         "emails",
         "phone-numbers",
         "links",
@@ -475,10 +476,11 @@ class WebScrapeResponse(BaseModel):
     for lists). The google-maps parser returns business records in data.results,
     google-maps-reviews returns data.reviews, and the google-play parser returns one
     app record as data, google-play-reviews returns data.reviews, app-store and
-    app-store-reviews do the same for the App Store, emails, phone-numbers, and
-    links return data.emails, data.phone_numbers, and data.links from the rendered
-    page; the store and Maps parsers read their data directly, independently of DOM
-    filters and other outputs.
+    app-store-reviews do the same for the App Store, g2-reviews returns data.reviews
+    for a G2 product, emails, phone-numbers, and links return data.emails,
+    data.phone_numbers, and data.links from the rendered page; the store, Maps, and
+    G2 parsers read their data directly, independently of DOM filters and other
+    outputs.
     """
 
     product: Product