outscraper 0.3.6 → 0.3.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 36bc03b48faddd06287b3c11a0c457a80412221cc752e19834419b66791eb83b
-  data.tar.gz: 2d46d01a94f94ffd1cbd39d8718ecf6c31172ae9a274f9380f365295a5115454
+  metadata.gz: 97c677370f1667c0a830e12a858fc1aa0a830182c145830205151cbf2a0719a3
+  data.tar.gz: 541a28805f574e7ad9d57df8a7d90bb43ee7b03128cc3ca33c45e5d7f0c93a76
 SHA512:
-  metadata.gz: c359daeb150ec3e8c527b3d1e25cde39decf289215f17d47707089ca0d4e61de61a2ae8e837686bd3521e22f44c9746b5d0a73454dc3bf5ee4b6ddc06fa076e4
-  data.tar.gz: 715e674806c05bf2daf94f153b5c30c04639b4a6452178b82adb361cddca5c8e97d32783b5dc72f78569f541149f8ed2099fca624f75381346736c9363c433fb
+  metadata.gz: f67f131e3546b2628c35679312655d725fb18f9fa905d41030ca7744269b9508dc0f6dcba83d0ab30355ad43b4f7858a9b9209f08cbeada6ac7047bca57a8a32
+  data.tar.gz: 5d3d36c762fd24e04266b0bb4249ae9b3183de35bd27a77c39be630ccc2af243d4055d2bdac60a69814f80b7eca812d5be1d51af59a17d646805f517a767ae7a

data/examples/Businesses.md

@@ -95,6 +95,91 @@ When both structured params and `query` are provided:
 - for `limit`, `cursor`, and `include_total`, plain-text values take priority when present
 - if a value is not specified, API defaults are used
 
+### Search businesses with enrichments
+
+`enrichments` can be provided in three formats:
+
+- **Hash (recommended)** — send a structured object with options per enrichment
+- **Array** — enable enrichments without options
+- **String** — enable a single enrichment without options
+
+#### Enrichments as Hash (recommended)
+
+```ruby
+results = client.businessesSearch(
+  filters: {
+    country_code: "US",
+    states: ["CA", "NY"],
+    types: ["restaurant", "cafe"]
+  },
+  limit: 10,
+  fields: ["name", "phone", "website", "rating", "reviews"],
+  enrichments: {
+    "contacts_n_leads" => {
+      "contacts_per_company" => 4,
+      "emails_per_contact" => 2
+    },
+    "company_insights" => {}
+  }
+)
+
+puts results
+```
+
+#### Enrichments as Array
+
+```ruby
+results = client.businessesSearch(
+  filters: { country_code: "US", states: ["NY"] },
+  limit: 10,
+  enrichments: ["contacts_n_leads", "company_insights"]
+)
+
+puts results
+```
+
+#### Enrichments as String
+
+```ruby
+results = client.businessesSearch(
+  filters: { country_code: "US", states: ["NY"] },
+  limit: 10,
+  enrichments: "contacts_n_leads"
+)
+
+puts results
+```
+
+#### Full JSON-style parameters example
+
+```ruby
+params = {
+  filters: {
+    country_code: "US",
+    states: ["CA", "NY"],
+    types: ["restaurant", "cafe"]
+  },
+  limit: 900,
+  cursor: nil,
+  include_total: false,
+  fields: [
+    "name", "types", "address", "country", "website",
+    "phone", "rating", "reviews"
+  ],
+  enrichments: {
+    "contacts_n_leads" => {
+      "contacts_per_company" => 4,
+      "emails_per_contact" => 2
+    },
+    "company_insights" => {}
+  },
+  query: "Find hotels in California and Illinois with rating 4.2+ and status operational. Return fields: name, address, rating and reviews. Limit results to 6. Enrich data with contacts_n_leads. Contact per company set to 8"
+}
+
+results = client.businessesSearch(**params)
+puts results
+```
+
 ### Iterate through all results (auto-pagination)
 
 ```ruby

data/lib/outscraper/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Outscraper
-  VERSION = "0.3.6"
+  VERSION = "0.3.7"
 end

data/lib/outscraper.rb

@@ -378,7 +378,7 @@ module Outscraper
         async: async_request
       }).parsed_response['data']
     end
-    
+
     def yellowpages_search(query, location: 'New York, NY', limit: 100, region: nil, enrichment: [], fields: '', async_request: false, ui: nil, webhook: nil)
       enrichment_array = enrichment.is_a?(Array) ? enrichment : [enrichment]
       response = self.class.get('/yellowpages-search', query: {
@@ -412,27 +412,92 @@ module Outscraper
       include_total: false,
       cursor: nil,
       fields: nil,
+      enrichments: nil,
+      contacts_per_company: nil,
+      emails_per_contact: nil,
       async_request: false,
       ui: false,
       webhook: nil,
       query: nil
     )
-      payload = {
-        filters: (filters || {}),
-        limit: limit,
-        include_total: include_total,
-        cursor: cursor,
-        fields: fields ? Array(fields) : nil,
-        query: query,
-        async: async_request,
-        ui: ui,
-        webhook: webhook
-      }.compact
+      if contacts_per_company && contacts_per_company < 1
+        raise ArgumentError, 'contacts_per_company must be >= 1'
+      end
+
+      if emails_per_contact && emails_per_contact < 1
+        raise ArgumentError, 'emails_per_contact must be >= 1'
+      end
+
+enrichments_normalized = nil
+
+if enrichments.is_a?(Hash)
+  enrichments_normalized = enrichments
+elsif enrichments.is_a?(Array)
+  enrichments_normalized = enrichments
+elsif enrichments.is_a?(String) || enrichments.is_a?(Symbol)
+  enrichments_normalized = enrichments.to_s
+elsif !enrichments.nil?
+  enrichments_normalized = Array(enrichments)
+end
+
+if !contacts_per_company.nil? || !emails_per_contact.nil?
+  cpp = contacts_per_company || 3
+  epc = emails_per_contact || 1
+
+  case enrichments_normalized
+  when nil
+    enrichments_normalized = { 'contacts_n_leads' => { 'contacts_per_company' => cpp, 'emails_per_contact' => epc } }
+  when Hash
+    enrichments_normalized['contacts_n_leads'] ||= {}
+    enrichments_normalized['contacts_n_leads']['contacts_per_company'] = cpp
+    enrichments_normalized['contacts_n_leads']['emails_per_contact'] = epc
+  when Array
+    unless enrichments_normalized.map(&:to_s).include?('contacts_n_leads')
+      raise ArgumentError, 'contacts_per_company and emails_per_contact require enrichments to include "contacts_n_leads"'
+    end
+    # Expand array to object so we can include options
+    expanded = {}
+    enrichments_normalized.each { |name| expanded[name.to_s] = {} }
+    expanded['contacts_n_leads']['contacts_per_company'] = cpp
+    expanded['contacts_n_leads']['emails_per_contact'] = epc
+    enrichments_normalized = expanded
+  when String
+    unless enrichments_normalized == 'contacts_n_leads'
+      raise ArgumentError, 'contacts_per_company and emails_per_contact require enrichments to include "contacts_n_leads"'
+    end
+    enrichments_normalized = { 'contacts_n_leads' => { 'contacts_per_company' => cpp, 'emails_per_contact' => epc } }
+  else
+    raise ArgumentError, 'Invalid enrichments type'
+  end
+end
+
+payload = {
+  filters: (filters || {}),
+  limit: limit,
+  include_total: include_total,
+  cursor: cursor,
+  fields: fields ? Array(fields) : nil,
+  enrichments: enrichments_normalized,
+  query: query,
+  async: async_request,
+  ui: ui,
+  webhook: webhook
+}.compact
+
+postAPIRequest('/businesses', payload)
 
-      postAPIRequest('/businesses', payload)
     end
 
-    def businessesIterSearch(filters: {}, limit: 10, fields: nil, include_total: false)
+    def businessesIterSearch(
+      filters: {},
+      limit: 10,
+      fields: nil,
+      include_total: false,
+      enrichments: nil,
+      contacts_per_company: nil,
+      emails_per_contact: nil,
+      query: nil
+    )
       cursor = nil
       all_items = []
 
@@ -443,6 +508,10 @@ module Outscraper
           include_total: include_total,
           cursor: cursor,
           fields: fields,
+          enrichments: enrichments,
+          contacts_per_company: contacts_per_company,
+          emails_per_contact: emails_per_contact,
+          query: query,
           async_request: false
         )
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: outscraper
 version: !ruby/object:Gem::Version
-  version: 0.3.6
+  version: 0.3.7
 platform: ruby
 authors:
 - Outscraper
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-20 00:00:00.000000000 Z
+date: 2026-03-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty