crunchbase4 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 116da8bf7036e9d4dba37ed63c85c7fa7cf44fa11c16f291045db209f4ab81b2
-  data.tar.gz: cb9d52123e679160e5055c6aeefbcf30be6924499f050105fa723c9412988587
+  metadata.gz: cb7a01707e086f0d73d6a92807f4d0a9e2dfab44e73647254781103792817373
+  data.tar.gz: b61240087a0344caf96bb065fa9c309f83e19d2357d805f74278cf2bda9381cc
 SHA512:
-  metadata.gz: a9cb04ffe4ed809a86743d76f2c815616b1d19ee132bf44fe04dc0fcd0d69265871cd4a827083a591630a9514c2f9d07c441a5bc9461ab14c4b3b31f021fc6bf
-  data.tar.gz: 66a0327303a29efc601bac09788f8cd363bde4aedb0245f56d85d6c39eae02f531e1cbae6bd21db3c01e140e27a5c0f70c6bee069b761364902b69b2d3d194b9
+  metadata.gz: b08389e81858a042b5204787ef8c25a78f712f23688cfb40e81a428298205748158d2e5380a9a24551b896c103212dab8b10b183e4d5ef8d357fb0b0c02f3515
+  data.tar.gz: cc99c470c8838170978d862a738283ca2481bbf75deeeb9e4760b46902321ddd3469e31e6e01183917cea54794a20187c0b1648ba2962ce675a1bf6ccac3bea1

data/.rubocop_todo.yml

@@ -35,6 +35,11 @@ Metrics/BlockLength:
   Max: 200
   Exclude:
     - spec/entities/client_spec.rb
+    - spec/client_spec.rb
 
 Layout/LineLength:
   Max: 200
+
+Metrics/ModuleLength:
+  Exclude:
+    - lib/crunchbase/utilities/veriables.rb

data/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.2] - 2020-06-07
+
+### Added
+- Implemented searches APIs to get the recent updates entities on Search
+  - organzations
+  - people
+  - funding rounds
+- Implemented autocomplete API to allow user filter entities by keyword
+  - organzations
+  - people
+  - funding rounds
+
+## [0.1.1] - 2020-06-06
+
+### Added
+- Implemented APIs to get acquisition and investment of Entity
+- Implemented APIs to search organzations and funding rounds of Search
+
+### Changed
+- Refactor the API client to support search API
+
+## [0.1.0] - 2020-06-04
+
+### Added
+
+- Implemented APIs to get organzation and funding round of Entity
+
+## [0.0.0] - 2020-06-01
+
+- Learning the Crunchbase V4 document and ready to create the new Gem

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    crunchbase4 (0.1.0)
+    crunchbase4 (0.1.2)
       faraday
       faraday_curl
       faraday_middleware

data/README.md

@@ -186,6 +186,25 @@ pry(main)> response = client.investment('1368da0c-07b0-46ef-9a86-b518367e60d6')
 }
 ```
 
+#### Get the latest updated entities
+
+Allow user using the method `recent_updates(args)` to get recent updates for each endpoint on searches
+
+# Example to get recent updated organizations
+
+```
+args = {
+  scope_name: 'organization',             # must
+  date: '2020-05-05',                     # must
+  field_ids: %w[name website permalink],  # default %[uuid created_at updated_at]
+  sort: 'desc'                            # default `desc`
+  before_id: 'uuid'                       # optional
+  after_id: 'uuid'                        # optional
+}
+
+response = client.recent_updates(args)
+```
+
 #### Search organizations by query conditions and order
 
 * Step1: Needs to build the query conditions
@@ -279,24 +298,213 @@ pry(main)> response = client.search_organizations(query_data)
 - Get total count:      `response.total_count`
 - Get entities count:   `response.count`
 
+#### Search people by query conditions and order
+
+* Step1: Needs to build the query conditions
+
+```
+query_data = {
+  'field_ids' => %w[
+    first_name
+    last_name
+    uuid
+    permalink
+    name
+  ],
+  'order' => [
+    {
+      'field_id' => 'last_name',
+      'sort' => 'asc',
+      'nulls' => 'last'
+    }
+  ],
+  'query' => [
+    {
+      'type' => 'predicate',
+      'field_id' => 'first_name',
+      'operator_id' => 'contains',
+      'values' => [
+        'Maxime'
+      ]
+    },
+    {
+      'type' => 'predicate',
+      'field_id' => 'last_name',
+      'operator_id' => 'contains',
+      'values' => [
+        'Guilbot'
+      ]
+    }
+  ],
+  'limit' => 5
+}
+```
+
+* Use `client` to send a request and parse response
+
+```
+pry(main)> response = client.search_people(query_data)
+=> #<Crunchbase::Searches::Client:0x00007f9acca12d18
+ @conditions=
+  {"field_ids"=>["first_name", "last_name", "uuid", "permalink", "name"],
+   "order"=>[{"field_id"=>"last_name", "sort"=>"asc", "nulls"=>"last"}],
+   "query"=>
+    [{"type"=>"predicate", "field_id"=>"first_name", "operator_id"=>"contains", "values"=>["Maxime"]}, {"type"=>"predicate", "field_id"=>"last_name", "operator_id"=>"contains", "values"=>["Guilbot"]}],
+   "limit"=>5},
+ @count=1,
+ @entities=[#<Crunchbase::Models::Person:0x00007f9acca43418 @first_name="Maxime", @last_name="Guilbot", @name="Maxime Guilbot", @permalink="maxime-guilbot", @uuid="90f4c92e-3479-1f6e-6470-b2ae78805839">],
+ @entity_type="person",
+ @kclass_name=Crunchbase::Models::Person,
+ @total_count=1>
+pry(main)> response.entities
+=> [#<Crunchbase::Models::Person:0x00007f9acca43418 @first_name="Maxime", @last_name="Guilbot", @name="Maxime Guilbot", @permalink="maxime-guilbot", @uuid="90f4c92e-3479-1f6e-6470-b2ae78805839">]
+pry(main)> response.total_count
+=> 1
+```
+
+## Autocompletes
+
+### Allow users to filter by keyword from these endpoints
+
+Search by keyword has been supported in "Organization", "People" and "Fund Round"
+
+1. Example: Search in an organization by keyword
+
+```
+pry(main)> response = client.autocomplete_organizations('ekohe')
+=> #<Crunchbase::Autocompletes::Client:0x00007fecb34ce1e8
+ @conditions={:query=>"ekohe", :collection_ids=>"organizations"},
+ @count=25,
+ @entities=
+  [#<Crunchbase::Models::AutocompleteEntity:0x00007fecb3976cb8
+    @facet_ids=["siftery", "apptopia", "company", "rank", "builtwith", "bombora", "similarweb"],
+    @identifier=["9fe491b2-b6a1-5c87-0f4d-226dd0cc97a9", "Ekohe", "ekohe"],
+    @permalink="ekohe",
+    @short_description="Creating cutting-edge, useful technical solutions to move you forward -- we deliver on the promise of AI.",
+    @uuid="9fe491b2-b6a1-5c87-0f4d-226dd0cc97a9">,
+   #<Crunchbase::Models::AutocompleteEntity:0x00007fecb3975980
+    @facet_ids=["rank", "builtwith", "company", "siftery"],
+    @identifier=["4994381c-3f6a-07bc-6ccf-a180cfbfbf60", "Ekohealth", "ekohealth"],
+    @permalink="ekohealth",
+    @short_description="Ekohealth is an online platform, entitling the patients having Ekohealth card to avail up to 50% discount on medical expense.",
+    @uuid="4994381c-3f6a-07bc-6ccf-a180cfbfbf60">,
+   #<Crunchbase::Models::AutocompleteEntity:0x00007fecb3974cb0
+    @facet_ids=["siftery", "apptopia", "company", "rank", "builtwith", "bombora", "similarweb"],
+    @identifier=["d21d2598-6f76-d6b4-458e-579bc9c3a36d", "EcoHealth Alliance", "ecohealth-alliance"],
+    @permalink="ecohealth-alliance",
+    @short_description="EcoHealth Alliance is a solutions that promote conservation and prevents pandemics.",
+    @uuid="d21d2598-6f76-d6b4-458e-579bc9c3a36d">,
+    ...]
+pry(main)> response.entities
+pry(main)> response.count
+pry(main)> response.total_count
+```
+
+2. Example: Search in an people by keyword
+
+```
+pry(main)> response = client.autocomplete_people('maxime')
+=> #<Crunchbase::Autocompletes::Client:0x00007fecb474f9c0
+ @conditions={:query=>"maxime", :collection_ids=>"people"},
+ @count=25,
+ @entities=
+  [#<Crunchbase::Models::AutocompleteEntity:0x00007fecb477db40
+    @facet_ids=["rank"],
+    @identifier=["e270e799-052d-60ba-86d4-9c0535556851", "Maxime Leufroy-Murat", "maxime-leufroy-murat"],
+    @permalink="maxime-leufroy-murat",
+    @short_description="Maxime Leufroy-Murat - CEO @ FG Properties",
+    @uuid="e270e799-052d-60ba-86d4-9c0535556851">,
+   #<Crunchbase::Models::AutocompleteEntity:0x00007fecb477ce70
+    @facet_ids=["rank"],
+    @identifier=["0b71cab9-43dc-4f03-9267-4dcbc191ec30", "Maxime Schwab", "maxime-schwab"],
+    @permalink="maxime-schwab",
+    @short_description="Co-Founder",
+    @uuid="0b71cab9-43dc-4f03-9267-4dcbc191ec30">,
+   #<Crunchbase::Models::AutocompleteEntity:0x00007fecb477c1f0
+    @facet_ids=["rank"],
+    @identifier=["527a4a8e-46e4-d808-c7df-b540bd8fedab", "Maxime Lombardini", "maxime-lombardini"],
+    @permalink="maxime-lombardini",
+    @short_description="Maxime Lombardini is Chief Executive Officer and Member of the board of Iliad since 2007. \r\n\r\nBefore joining Iliad, Maxime Lombardini use to...",
+    @uuid="527a4a8e-46e4-d808-c7df-b540bd8fedab">,
+    ...]
+pry(main)> response.entities
+pry(main)> response.count
+pry(main)> response.total_count
+```
+2. Example: Search in an funding rounds by keyword
+
+```
+pry(main)> pry(main)> response = client.autocomplete_funding_rounds('facebook')
+=> #<Crunchbase::Autocompletes::Client:0x00007fecb4dd66b8
+ @conditions={:query=>"facebook", :collection_ids=>"funding_rounds"},
+ @count=25,
+ @entities=
+  [#<Crunchbase::Models::AutocompleteEntity:0x00007fecb4e04950
+    @facet_ids=["rank"],
+    @identifier=["6fae3958-a001-27c0-fb7e-666266aedd78", "Series B - Facebook", "facebook-series-b--6fae3958"],
+    @permalink="facebook-series-b--6fae3958",
+    @short_description="Facebook raised $27500000 on 2006-04-01 in Series B",
+    @uuid="6fae3958-a001-27c0-fb7e-666266aedd78">,
+   #<Crunchbase::Models::AutocompleteEntity:0x00007fecb4e17c30
+    @facet_ids=["rank"],
+    @identifier=["d950d7a5-79ff-fb93-ca87-13386b0e2feb", "Series A - Facebook", "facebook-series-a--d950d7a5"],
+    @permalink="facebook-series-a--d950d7a5",
+    @short_description="Facebook raised $12700000 on 2005-05-01 in Series A",
+    @uuid="d950d7a5-79ff-fb93-ca87-13386b0e2feb">,
+   #<Crunchbase::Models::AutocompleteEntity:0x00007fecb4e16f60
+    @facet_ids=["rank"],
+    @identifier=["59971bc0-0935-be60-e279-a9db5e787169", "Secondary Market - Facebook", "facebook-secondary-market--59971bc0"],
+    @permalink="facebook-secondary-market--59971bc0",
+    @short_description="Facebook raised $120000000 on 2010-06-28 in Secondary Market",
+    @uuid="59971bc0-0935-be60-e279-a9db5e787169">,
+    ...]
+pry(main)> response.entities
+pry(main)> response.count
+pry(main)> response.total_count
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
-### Examples of API requests
+### Examples of API requests for each endpoint
 
 ```
 Crunchbase.config.user_key = 'user_key'
 client = Crunchbase::Client.new
+
+<!-- Entity -->
 response = client.organization('ekohe')
 response = client.person('mark-zuckerberg')
 response = client.funding_round('371c20af8aa94bcba8da0694d138f247')
 response = client.acquisition('7638eae9-07b7-4fc6-ad20-5d99de3ff928')
+
+<!-- Search -->
+client.search_organizations(query_data)
+client.search_people(query_data)
+client.search_funding_rounds(query_data)
+client.recent_updates({
+                        scope_name: 'organization',
+                        field_ids: %w[name website permalink],
+                        date: '2020-05-05',
+                        limit: 100
+                      })
+
+<!-- Autocompletes -->
+response = client.autocomplete_organizations('ekohe')
+response = client.autocomplete_people('encore')
+response = client.autocomplete_funding_rounds('facebook')
 ```
 
+## Changelog
+
+If you want to know what update, please check the [Changelog](https://github.com/ekohe/crunchbase4/blob/master/CHANGELOG.md).
+
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/ekohe/crunchbase4. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/ekohe/crunchbase4/blob/master/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/ekohe/crunchbase4. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected.
+
+To see all contributors from https://github.com/ekohe/crunchbase4/graphs/contributors
 
 ## License
 

data/lib/crunchbase.rb

@@ -4,11 +4,40 @@ require 'crunchbase/version'
 
 require 'crunchbase/config'
 require 'crunchbase/client'
+require 'crunchbase/models'
 require 'crunchbase/entities'
 require 'crunchbase/searches'
-require 'crunchbase/models'
+require 'crunchbase/utilities/veriables'
 
+# CB v4
 module Crunchbase
   API_VERSION   = 'v4'
   BASE_URI      = "https://api.crunchbase.com/api/#{API_VERSION}/"
+
+  # Defined Veriables for the data Category or Types
+  #
+  # Crunchbase::Utils.constants => [
+  #   :OPERATING_STATUS,
+  #  :PROGRAM_TYPES,
+  #  :REVENUE_RANGES,
+  #  :COMPANY_TYPES,
+  #  :FACET_IDS,
+  #  :SCHOOL_METHODS,
+  #  :IPO_STATUS,
+  #  :FUNDING_STAGES,
+  #  :CURRENCY_ENUM,
+  #  :DATE_PRECISIONS,
+  #  :LAYOUT_IDS,
+  #  :NUM_EMPLOYEES_ENUM,
+  #  :FUNDING_TYPES,
+  #  :SCHOOL_TYPES,
+  #  :QUERY_OPERATORS,
+  #  :STATUS,
+  #  :STOCK_EXCHANGE_SYMBOLS
+  # ]
+  #
+  #  Crunchbase::Utils::NUM_EMPLOYEES_ENUM
+  class Utils
+    include Utilities::Veriables
+  end
 end

data/lib/crunchbase/autocompletes/client.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require_relative '../utilities/request'
+require_relative '../utilities/cb_model'
+
+module Crunchbase
+  # autocompletes endpoints
+  module Autocompletes
+    # Send request for autocompletes endpoint
+    #
+    # API doc:
+    #   https://app.swaggerhub.com/apis-docs/Crunchbase/crunchbase-enterprise_api/1.0.1#/Autocomplete/get_autocompletes
+    class Client
+      include ::Crunchbase::Utilities::Request
+      include ::Crunchbase::Utilities::CbModel
+
+      attr_accessor :total_count, :count, :entities, :conditions, :entity_type
+
+      ROOT_LIST = 'autocompletes'
+      LIMIT = 25
+
+      def initialize(raw_data)
+        @conditions = raw_data
+        @entity_type = 'autocomplete_entity'
+      end
+
+      # Will include all attribute from API document
+      def autocompletes
+        wrapping!(
+          get(
+            ROOT_LIST,
+            autocompletes_parameters
+          )
+        )
+      end
+
+      private
+
+      def wrapping!(response)
+        query_results = search_results(response.dig('entities'))
+
+        self.total_count  = response['count']
+        self.entities     = query_results
+        self.count        = query_results.size
+        self
+      end
+
+      # One item of organization
+      #
+      #  {
+      #   "facet_ids"=>
+      #     ["siftery", "apptopia", "company", "rank", "builtwith", "bombora", "similarweb"],
+      #   "identifier"=>
+      #     {
+      #       "uuid"=>"9fe491b2-b6a1-5c87-0f4d-226dd0cc97a9",
+      #       "value"=>"Ekohe",
+      #       "image_id"=>"v1500646625/zhionn8nlgbkz4lj7ilz.png",
+      #       "permalink"=>"ekohe",
+      #       "entity_def_id"=>"organization"
+      #      },
+      #   "short_description"=>
+      #     "Creating cutting-edge, useful technical solutions to move you forward -- we deliver on the promise of AI."
+      #   }
+      def search_results(entities)
+        entities.each_with_object([]) do |entity, objects|
+          objects << cbobject.parse_response(entity)
+        end
+      end
+
+      def autocompletes_parameters
+        @conditions.merge(limit: @conditions[:limit] || LIMIT)
+      end
+    end
+  end
+end

data/lib/crunchbase/client.rb

@@ -2,11 +2,15 @@
 
 require_relative 'utilities/entity_endpoints'
 require_relative 'utilities/search_endpoints'
+require_relative 'utilities/autocomplete'
+require_relative 'utilities/deleted_entities'
 
 module Crunchbase
   # API Request
   class Client
     include Utilities::EntityEndpoints
     include Utilities::SearchEndpoints
+    include Utilities::Autocomplete
+    include Utilities::DeletedEntities
   end
 end

data/lib/crunchbase/models.rb

@@ -4,6 +4,7 @@ module Crunchbase
   # Models
   module Models
     autoload :Entity,                       'crunchbase/models/entity'
+    autoload :AutocompleteEntity,           'crunchbase/models/autocomplete_entity'
     autoload :Organization,                 'crunchbase/models/organization'
     autoload :Person,                       'crunchbase/models/person'
     autoload :FundingRound,                 'crunchbase/models/funding_round'
@@ -12,5 +13,6 @@ module Crunchbase
     autoload :PressReference,               'crunchbase/models/press_reference'
     autoload :CategoryGroup,                'crunchbase/models/category_group'
     autoload :Category,                     'crunchbase/models/category'
+    autoload :Ipo,                          'crunchbase/models/ipo'
   end
 end

data/lib/crunchbase/models/autocomplete_entity.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Crunchbase
+  # Get the Entities data from API
+  module Models
+    # For AutocompleteEntity
+    class AutocompleteEntity < Entity
+      def field_ids
+        basis_fields
+      end
+
+      def basis_fields
+        %w[
+          identifier
+          facet_ids
+          short_description
+        ]
+      end
+
+      def parse_response(response)
+        dynamic_attributes(self, field_ids, response)
+      end
+    end
+  end
+end

data/lib/crunchbase/models/ipo.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Crunchbase
+  # Get the Entities data from API
+  module Models
+    # Get the person data from API
+    class Ipo < Entity
+      RESOURCE_LIST = 'ipos'
+
+      def field_ids
+        %w[
+          created_at
+          entity_def_id
+          image_id
+          rank
+          rank_ipo
+          shares_outstanding
+          shares_sold
+          stock_exchange_symbol
+          stock_full_symbol
+          updated_at
+        ] + basis_fields
+      end
+
+      def basis_fields
+        %w[
+          uuid
+          permalink
+          identifier
+          amount_raised
+          share_price
+          stock_symbol
+          valuation
+          delisted_on
+          went_public_on
+          short_description
+        ]
+      end
+
+      def full_cards
+        %w[
+          organization
+          press_references
+        ]
+      end
+    end
+  end
+end

data/lib/crunchbase/utilities/autocomplete.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require_relative '../autocompletes/client'
+
+module Crunchbase
+  # Utilities
+  module Utilities
+    # Autocomplete on Searches
+    module Autocomplete
+      # endpoint: /autocompletes
+      #
+      #  Suggests matching Identifier entities based on the query and entity_def_ids provided.
+      #
+      #  query * string
+      #     Value to perform the autocomplete search with.
+      #  collection_ids string
+      #     A comma separated list of collection ids to search against.
+      #     Leaving this blank means it will search across all identifiers.
+      #     Entity defs can be constrained to specific facets by providing them as facet collections.
+      #     Relationship collections will resolve to their underlying entity def.
+      #
+      #     Collection ids are:
+      #       organizations, people, funding_rounds, acquisitions, investments, events,
+      #       press_references, funds, event_appearances, ipos, ownerships, categories,
+      #       category_groups, locations, jobs
+      #  limit integer
+      #     Number of results to retrieve; default = 10, max = 25
+      #
+      #
+      #  Example for organizations
+      #
+      #  raw_data = {
+      #     query: keyword,
+      #     collection_ids: 'organizations'
+      #  }
+      def autocomplete_organizations(keyword)
+        autocompletes(wrapper_query_data(keyword, 'organizations'))
+      end
+
+      def autocomplete_people(keyword)
+        autocompletes(wrapper_query_data(keyword, 'people'))
+      end
+
+      def autocomplete_funding_rounds(keyword)
+        autocompletes(wrapper_query_data(keyword, 'funding_rounds'))
+      end
+
+      def autocomplete_press_references(keyword)
+        autocompletes(wrapper_query_data(keyword, 'press_references'))
+      end
+
+      private
+
+      def autocompletes(raw_data)
+        Crunchbase::Autocompletes::Client.new(raw_data).autocompletes
+      end
+
+      def wrapper_query_data(keyword, collection_ids)
+        {
+          query: keyword,
+          collection_ids: collection_ids
+        }
+      end
+    end
+  end
+end

data/lib/crunchbase/utilities/deleted_entities.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Crunchbase
+  # Utilities
+  module Utilities
+    # Autocomplete on Searches
+    module DeletedEntities
+      # endpoint: /deleted_entities
+      #
+      #   Retrieve deleted entities
+      #   Retrieve deleted entities for a collection id
+      def deleted_entities(collection_id: nil); end
+    end
+  end
+end

data/lib/crunchbase/utilities/entity_endpoints.rb

@@ -74,6 +74,16 @@ module Crunchbase
         entities('press_reference', entity_id).fetch_cards
       end
 
+      # Lookup an Ipo or Single card
+      def ipo(entity_id, card_id: nil)
+        lookup_for('ipo', entity_id, card_id)
+      end
+
+      # Lookup Ipo's all card
+      def ipo_cards(entity_id)
+        entities('ipo', entity_id).fetch_cards
+      end
+
       private
 
       def entities(entity_type, entity_id)

data/lib/crunchbase/utilities/request.rb

@@ -13,19 +13,16 @@ module Crunchbase
     module Request
       module_function
 
+      # Autocompletes endpoint
+      def get(uri, *args)
+        fetch_request(uri, *args)
+      end
+
       # Entity endpoints
       #
       #   https://app.swaggerhub.com/apis-docs/Crunchbase/crunchbase-enterprise_api/1.0.1#/Entity/get_entities_organizations__entity_id_
       def entity(uri, *args)
-        response = Faraday.new(url: BASE_URI, headers: headers) do |faraday|
-          faraday.adapter Faraday.default_adapter
-          faraday.response :json
-          faraday.response :logger, ::Logger.new(STDOUT), bodies: true if debug_mode?
-        end.get(uri, *args)
-
-        return response.body if response.status == 200
-
-        raise Error, response.reason_phrase
+        fetch_request(uri, *args)
       end
 
       # Search endpoints
@@ -41,11 +38,23 @@ module Crunchbase
 
         return response.body if response.status == 200
 
-        raise Error, response.reason_phrase
+        raise Error, response.body[0]['message']
       end
 
       private
 
+      def fetch_request(uri, *args)
+        response = Faraday.new(url: BASE_URI, headers: headers) do |faraday|
+          faraday.adapter Faraday.default_adapter
+          faraday.response :json
+          faraday.response :logger, ::Logger.new(STDOUT), bodies: true if debug_mode?
+        end.get(uri, *args)
+
+        return response.body if response.status == 200
+
+        raise Error, response.body['error']
+      end
+
       def debug_mode?
         Crunchbase.config.debug || false
       end

data/lib/crunchbase/utilities/response.rb

@@ -17,7 +17,7 @@ module Crunchbase
           attribute_names.delete(attribute_name)
           hash_datas = response&.dig(attribute_name)
 
-          values = hash_datas&.map { |k, v| v if %w[uuid permalink].include?(k) }&.compact || []
+          values = hash_datas&.map { |k, v| v if %w[uuid permalink value].include?(k) }&.compact || []
           dynamic_define_method(object, attribute_name, values)
           hash_datas&.keys&.each do |key|
             next unless %w[uuid permalink].include?(key)

data/lib/crunchbase/utilities/search_endpoints.rb

@@ -1,10 +1,28 @@
 # frozen_string_literal: true
 
+require_relative './search_query_parameters'
+
 module Crunchbase
   # Utilities
   module Utilities
     # All Searches API endpoint
     module SearchEndpoints
+      include SearchQueryParameters
+
+      # Example to searching organizations
+      #
+      # {
+      #   scope_name: 'organization',
+      #   date: '2020-05-05',
+      #   field_ids: %w[name website permalink],
+      #   sort: 'desc'
+      #   before_id: 'uuid'
+      #   after_id: 'uuid'
+      # }
+      def recent_updates(args)
+        searches(query_parameters(args), args[:scope_name]).searches
+      end
+
       # For Searches
       def search_organizations(raw_data)
         searches(raw_data, 'organization').searches
@@ -14,6 +32,10 @@ module Crunchbase
         searches(raw_data, 'funding_round').searches
       end
 
+      def search_people(raw_data)
+        searches(raw_data, 'person').searches
+      end
+
       private
 
       def searches(raw_data, scope_name)

data/lib/crunchbase/utilities/search_query_parameters.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Crunchbase
+  # Utilities
+  module Utilities
+    # All Searches Query Parameters
+    module SearchQueryParameters
+      module_function
+
+      # https://app.swaggerhub.com/apis-docs/Crunchbase/crunchbase-enterprise_api/1.0.1#/Search/post_searches_people
+      #
+      # Search Query Parameters
+      #
+      #   field_ids: array of field_id strings
+      #     Fields to include as columns in the search result entities
+      #   query: Search query to perform on the designated entity
+      #   order: (field_id, sort, nulls)
+      #     Order in which the search results should be returned
+      #   limit: integer
+      #     Number of rows to return. Default is 100, min is 1, max is 1000.
+      #   before_id: string($uuid)
+      #     Used to paginate search results to the previous page.
+      #     before_id should be the uuid of the first item in the current page. May not be provided simultaneously with after_id.
+      #   after_id: string($uuid)
+      #     Used to paginate search results to the next page.
+      #     after_id should be the uuid of the last item in the current page. May not be provided simultaneously with before_id.
+      def query_parameters(args)
+        params = {
+          'field_ids' => %w[
+            uuid
+            created_at
+            updated_at
+          ] + (args[:field_ids] || []).uniq,
+          'order' => [
+            {
+              'field_id' => 'updated_at',
+              'sort' => (args[:sort] || 'desc'),
+              'nulls' => 'last'
+            }
+          ],
+          'limit' => args[:limit] || 1000
+        }
+
+        unless args[:date].nil?
+          params.merge!(
+            'query' => [
+              {
+                'type' => 'predicate',
+                'field_id' => 'updated_at',
+                'operator_id' => 'gte',
+                'values' => [
+                  args[:date]
+                ]
+              }
+            ]
+          )
+        end
+        params.merge!('before_id' => args[:before_id]) unless args[:before_id].nil?
+        params.merge!('after_id' => args[:after_id]) unless args[:after_id].nil?
+        params
+      end
+    end
+  end
+end

data/lib/crunchbase/utilities/veriables.rb

@@ -0,0 +1,335 @@
+# frozen_string_literal: true
+
+module Crunchbase
+  # Utilities
+  module Utilities
+    # Veriables
+    module Veriables
+      # Description of operators
+      QUERY_OPERATORS = {
+        'blank' => 'Blank',
+        'eq' => 'Equal',
+        'not_eq' => 'Not equal',
+        'gt' => 'Greater than',
+        'gte' => 'Greater than or equal',
+        'lt' => 'Less than',
+        'lte' => 'Less than or equal',
+        'starts' => 'Starts',
+        'contains' => 'Contains',
+        'between' => 'Between',
+        'includes' => 'Includes',
+        'not_includes' => 'Does not include',
+        'includes_all' => 'Includes all',
+        'not_includes_all' => 'Does not include all'
+      }.freeze
+
+      COMPANY_TYPES = {
+        'for_profit' => 'For Profit',
+        'non_profit' => 'Non-profit'
+      }.freeze
+
+      FACET_IDS = {
+        'company' => 'Company',
+        'investor' => 'Investor',
+        'school' => 'School'
+      }.freeze
+
+      IPO_STATUS = {
+        'delisted' => 'Delisted',
+        'private' => 'Private',
+        'public' => 'Public'
+      }.freeze
+
+      FUNDING_STAGES = {
+        'early_stage_venture' => 'Early Stage Venture',
+        'ipo' => 'IPO',
+        'late_stage_venture' => 'Late Stage Venture',
+        'm_and_a' => 'M&A',
+        'private_equity' => 'Private Equity',
+        'seed' => 'Seed'
+      }.freeze
+
+      FUNDING_TYPES = {
+        'angel' => 'Angel',
+        'convertible_note' => 'Convertible Note',
+        'corporate_round' => 'Corporate Round',
+        'debt_financing' => 'Debt Financing',
+        'equity_crowdfunding' => 'Equity Crowdfunding',
+        'grant' => 'Grant',
+        'initial_coin_offering' => 'Initial Coin Offering',
+        'non_equity_assistance' => 'Non-equity Assistance',
+        'post_ipo_debt' => 'Post-IPO Debt',
+        'post_ipo_equity' => 'Post-IPO Equity',
+        'post_ipo_secondary' => 'Post-IPO Secondary',
+        'pre_seed' => 'Pre-Seed',
+        'private_equity' => 'Private Equity',
+        'product_crowdfunding' => 'Product Crowdfunding',
+        'secondary_market' => 'Secondary Market',
+        'seed' => 'Seed',
+        'series_a' => 'Series A',
+        'series_b' => 'Series B',
+        'series_c' => 'Series C',
+        'series_d' => 'Series D',
+        'series_e' => 'Series E',
+        'series_f' => 'Series F',
+        'series_g' => 'Series G',
+        'series_h' => 'Series H',
+        'series_i' => 'Series I',
+        'series_j' => 'Series J',
+        'series_unknown' => 'Venture - Series Unknown',
+        'undisclosed' => 'Undisclosed'
+      }.freeze
+
+      CURRENCY_ENUM = %w[
+        AED AFN ALL AMD ANG AOA ARS AUD AWG AZN BAM BBD BDT BGN BHD
+        BIF BMD BND BOB BRL BSD BTN BWP BYN BYR BZD CAD CDF CHF CLF
+        CLP CNY COP CRC CUC CUP CVE CZK DJF DKK DOP DZD EGP ERN ETB
+        EUR FJD FKP GBP GEL GHS GIP GMD GNF GTQ GYD HKD HNL HRK HTG
+        HUF IDR ILS INR IQD IRR ISK JMD JOD JPY KES KGS KHR KMF KPW
+        KRW KWD KYD KZT LAK LBP LKR LRD LSL LTL LVL LYD MAD MDL MGA
+        MKD MMK MNT MOP MRO MUR MVR MWK MXN MYR MZN NAD NGN NIO NOK
+        NPR NZD OMR PAB PEN PGK PHP PKR PLN PYG QAR RON RSD RUB RWF
+        SAR SBD SCR SDG SEK SGD SHP SKK SLL SOS SRD SSP STD SVC SYP
+        SZL THB TJS TMT TND TOP TRY TTD TWD TZS UAH UGX USD UYU UZS
+        VEF VND VUV WST XAF XAG XAU XBA XBB XBC XBD XCD XDR XOF XPD
+        XPF XPT YER ZAR ZMK ZMW xts
+      ].freeze
+
+      DATE_PRECISIONS = %w[none year month day].freeze
+
+      LAYOUT_IDS = {
+        'default' => 'Default Layout',
+        'investor' => 'Investor Layout',
+        'school' => 'School Layout'
+      }.freeze
+
+      NUM_EMPLOYEES_ENUM = {
+        'c_00001_00010' => '1-10',
+        'c_00011_00050' => '11-50',
+        'c_00051_00100' => '51-100',
+        'c_00101_00250' => '101-250',
+        'c_00251_00500' => '251-500',
+        'c_00501_01000' => '501-1000',
+        'c_01001_05000' => '1001-5000',
+        'c_05001_10000' => '5001-10000',
+        'c_10001_max' => '10001+'
+      }.freeze
+
+      OPERATING_STATUS = {
+        'active' => 'Active',
+        'closed' => 'Closed'
+      }.freeze
+
+      PROGRAM_TYPES = {
+        'on_site' => 'On-Site',
+        'online' => 'Online'
+      }.freeze
+
+      REVENUE_RANGES = {
+        'r_00000000' => 'Less than $1M',
+        'r_00001000' => '$1M to $10M',
+        'r_00010000' => '$10M to $50M',
+        'r_00050000' => '$50M to $100M',
+        'r_00100000' => '$100M to $500M',
+        'r_00500000' => '$500M to $1B',
+        'r_01000000' => '$1B to $10B',
+        'r_10000000' => '$10B+'
+      }.freeze
+
+      SCHOOL_METHODS = {
+        'on_compus' => 'On Campus',
+        'online' => 'Online',
+        'online_and_on_campus' => 'Online and On Campus'
+      }.freeze
+
+      SCHOOL_METHODS = {
+        'bootcamp' => 'Bootcamp',
+        'community_college' => 'Community College',
+        'four_year_university' => 'Four Year University',
+        'graduate_university' => 'Graduate University',
+        'high_school' => 'High School',
+        'trade_school' => 'Trade School',
+        'two_year_university' => 'Two Year University'
+      }.freeze
+
+      SCHOOL_TYPES = {
+        'for_profit_private' => 'Private',
+        'non_profit_private' => 'Private (Non-Profit)',
+        'public' => 'Public'
+      }.freeze
+
+      STATUS = {
+        'closed' => 'Closed',
+        'ipo' => 'IPO',
+        'operating' => 'Operating',
+        'was_acquired' => 'Was Acquired'
+      }.freeze
+
+      STOCK_EXCHANGE_SYMBOLS = {
+        'adx' => 'ADX - Abu Dhabi Securities Exchange',
+        'afx' => 'AFX - Afghanistan Stock Exchange',
+        'altx' => 'ALTX - ALTX East Africa Exchange',
+        'amex' => 'AMEX - American Stock Exchange',
+        'ams' => 'AMS - Euronext Amsterdam',
+        'amx' => 'AMX - Armenia Securities Exchange',
+        'asce' => 'ASCE - Abuja Securities and Commodities Exchange',
+        'asx' => 'ASX - Australian Securities Exchange',
+        'ath' => 'ATH - Athens Stock Exchange',
+        'bcba' => 'BCBA - Buenos Aires Stock Exchange',
+        'bdp' => 'BDP - Budapest Stock Exchange',
+        'belex' => 'BELEX - Belgrade Stock Exchange',
+        'ber' => 'BER - Berliner Börse',
+        'bfb' => 'BFB - Baku Stock Exchange',
+        'bit' => 'BIT - Italian Stock Exchange',
+        'bkk' => 'BKK - Thailand Stock Exchange',
+        'blse' => 'BLSE - Banja Luka Stock Exchange',
+        'bme' => 'BME - Madrid Stock Exchange',
+        'bmv' => 'BMV - Mexican Stock Exchange',
+        'bom' => 'BOM - Bombay Stock Exchange',
+        'brvm' => 'BRVM - Regional Securities Exchange SA',
+        'bse' => 'BSE - Bulgarian Stock Exchange',
+        'bse_lb' => 'BSE - Beirut Stock Exchange',
+        'bsse' => 'BSSE - Bratislava Stock Exchange',
+        'bsx' => 'BSX - Bermuda Stock Exchange',
+        'bvb' => 'BVB - Bucharest Stock Exchange',
+        'bvc' => 'BVC - Colombian Stock Exchange',
+        'bvfb' => 'BVFB - Belarusian Currency and Stock Exchange',
+        'bvm' => 'BVM - Montevideo Stock Exchange',
+        'bvmf' => 'B3 - Brazil Stock Exchange and OTC Market',
+        'bvmt' => 'BVMT - Tunis Stock Exchange',
+        'bx' => 'BX - Berne Stock Exchange',
+        'cas' => 'CAS - Casablanca Stock Exchange',
+        'cise' => 'CISE - Channel Islands Stock Exchange',
+        'cnsx' => 'CNSX - Canadian National Stock Exchange',
+        'col' => 'COL - Colombo Stock Exchange',
+        'cph' => 'CPH - Copenhagen Stock Exchange',
+        'cse' => 'CSE - Canadian Securities Exchange',
+        'cse_cy' => 'CSE - Cyprus Stock Exchange',
+        'csx' => 'CSX - Cambodia Securities Exchange',
+        'cve' => 'TSX-V - Toronto TSX Venture Exchange',
+        'dfm' => 'DFM - Dubai Financial Market',
+        'dse' => 'DSE - Dhaka Stock Exchange',
+        'dsx' => 'DSX - Douala Stock Exchange',
+        'dus' => 'DUS - Börse Düsseldorf',
+        'ebr' => 'EBR - Euronext Brussels',
+        'egx' => 'EGX - Egypt Stock Exchange',
+        'eli' => 'ELI - Euronext Lisbon',
+        'epa' => 'EPA - Euronext Paris',
+        'etr' => 'ETR - Deutsche Börse XETRA',
+        'eurex' => 'EUREX - Eurex Exchange',
+        'fra' => 'FRA - Frankfurt Stock Exchange',
+        'fwb' => 'FWB - Börse Frankfurt Stock Exchange',
+        'gha' => 'GHA - Ghana Stock Exchange',
+        'gsx' => 'GSX - Georgian Stock Exchange',
+        'gsx_gi' => 'GSX - Gibraltar Stock Exchange',
+        'hel' => 'HEL - Helsinki Stock Exchange',
+        'hkg' => 'HKG - Hong Kong Stock Exchange',
+        'hnx' => 'HNX - Hanoi Stock Exchange',
+        'hose' => 'HOSE - Ho Chi Minh Stock Exchange',
+        'ice' => 'ICE - Iceland Stock Exchange',
+        'idx' => 'IDX - Indonesia Stock Exchange',
+        'iex' => 'IEX - Investors Exchange',
+        'ifb' => 'IFB - Iran Fara Bourse',
+        'ime' => 'IME - Iran Mercantile Exchange',
+        'irenex' => 'IRENEX - Iran Energy Exchange',
+        'ise' => 'ISE - Irish Stock Exchange',
+        'ist' => 'IST - Istanbul Stock Exchange',
+        'isx' => 'ISX - Iraq Stock Exchange',
+        'jp' => 'JP - Japan Exchange',
+        'jsc' => 'JSC - Belarusian Currency and Stock Exchange',
+        'jse' => 'JSE - Johannesburg Stock Exchange',
+        'jse_jam' => 'JSE - Jamaica Stock Exchange',
+        'kase' => 'KASE - Kazakhstan Stock Exchange',
+        'klse' => 'KLSE - Malaysia Stock Exchange',
+        'kosdaq' => 'KOSDAQ - Korean Securities Dealers Automated Quotations',
+        'krx' => 'KRX - Korea Stock Exchange',
+        'kse' => 'KSE - Kuwait Stock Exchange',
+        'lje' => 'LJE - Ljubljana Stock Exchange',
+        'lse' => 'LSE - London Stock Exchange',
+        'lsm' => 'LSM - Libyan Stock Market',
+        'lsx' => 'LSX - Lao Securities Exchange',
+        'luse' => 'LuSE - Lusaka Securities Exchange',
+        'luxse' => 'LuxSE - Luxembourg Stock Exchange',
+        'mal' => 'MAL - Malta Stock Exchange',
+        'mcx' => 'MCX - Multi Commodity Exchange of India',
+        'meff' => 'MEFF - Mercado Spanish Financial Futures Market',
+        'mnse' => 'MNSE - Montenegro Stock Exchange',
+        'moex' => 'MOEX - Moscow Exchange',
+        'mse' => 'MSE - Metropolitan Stock Exchange',
+        'mse_md' => 'MSE - Moldova Stock Exchange',
+        'mse_mk' => 'MSE - Macedonian Stock Exchange',
+        'msei' => 'MSEI - Metropolitan Stock Exchange of India',
+        'msm' => 'MSM - Muscat Securities Market',
+        'mun' => 'MUN - Börse München',
+        'nasdaq' => 'NASDAQ',
+        'nbo' => 'NSE - Nairobi Securities Exchange',
+        'neeq' => 'NEEQ - National Equities Exchange and Quotations',
+        'nepse' => 'NEPSE - Nepal Stock Exchange',
+        'nex' => 'NEX - NEX Exchange',
+        'ngm' => 'NGM - Nordic Growth Market Exchange',
+        'nig' => 'NIG - Nigerian Stock Exchange',
+        'notc' => 'NOTC - Norwegian OTC',
+        'npex' => 'NPEX - NPEX Stock Exchange',
+        'nse' => 'NSE - National Stock Exchange of India',
+        'nsx' => 'NSX - National Stock Exchange of Australia',
+        'nyse' => 'NYSE - New York Stock Exchange',
+        'nysearca' => 'NYSEARCA - NYSE Arca',
+        'nysemkt' => 'NYSEAMERICAN - NYSE American',
+        'nze' => 'NZE - New Zealand Stock Exchange',
+        'ose' => 'OSE - Oslo Stock Exchange',
+        'otcbb' => 'OTCBB - FINRA OTC Bulletin Board',
+        'otcpink' => 'OTC Pink',
+        'otcqb' => 'OTCQB',
+        'otcqx' => 'OTCQX',
+        'pdex' => 'PDEx - Philippine Dealing Exchange',
+        'pex' => 'PEX - Palestine Exchange',
+        'pfts' => 'PFTS - PFTS Ukraine Stock Exchange',
+        'pomsox' => 'POMSoX - Port Moresby Stock Exchange',
+        'prg' => 'PRA - Prague Stock Exchange',
+        'pse' => 'PSE - Philippine Stock Exchange',
+        'psx' => 'PSX - Pakistan Stock Exchange',
+        'qse' => 'QSE - Qatar Stock Exchange',
+        'rfb' => 'RFB - Riga Stock Exchange',
+        'rse' => 'RSE - Rwanda Stock Exchange',
+        'rsebl' => 'RSEBL - Royal Securities Exchange of Bhutan',
+        'sase' => 'SASE - Sarajevo Stock Exchange',
+        'sbx' => 'SBX - BX Swiss',
+        'sehk' => 'SEHK - The Stock Exchange of Hong Kong',
+        'sem' => 'SEM - Stock Exchange of Mauritius',
+        'sgbv' => 'SGBV - Algiers Stock Exchange',
+        'sgx' => 'SGX - Singapore Stock Exchange',
+        'six' => 'SIX - SIX Swiss Exchange',
+        'spbex' => 'SPBEX - Saint Petersburg Stock Exchange',
+        'spse' => 'SPSE - South Pacific Stock Exchange',
+        'sse' => 'SSE - Shanghai Stock Exchange',
+        'ssx' => 'SSX - Sydney Stock Exchange',
+        'sto' => 'STO - Stockholm Stock Exchange',
+        'stu' => 'STU - Börse Stuttgart',
+        'swx' => 'SWX - SIX Swiss Exchange',
+        'szse' => 'SZSE - Shenzhen Stock Exchange',
+        'tadawul' => 'Tadawul - Saudi Stock Exchange',
+        'tal' => 'TSE - Tallinn Stock Exchange',
+        'tfex' => 'TFEX - Thailand Futures Exchange',
+        'tise' => 'TISE - The International Stock Exchange',
+        'tlv' => 'TLV - Tel Aviv Stock Exchange',
+        'tpe' => 'TWSE - Taiwan Stock Exchange',
+        'tse_al' => 'TSE - Tirana Stock Exchange',
+        'tse_ir' => 'TSE - Tehran Stock Exchange',
+        'tsec' => 'TWO - Taiwan OTC Exchange',
+        'tsx' => 'TSX - Toronto Stock Exchange',
+        'ttse' => 'TTSE - Trinidad and Tobago Stock Exchange',
+        'tyo' => 'TYO - Tokyo Stock Exchange',
+        'use' => 'USE - Uganda Securities Exchange',
+        'ux' => 'UX - Ukrainian Exchange',
+        'vie' => 'VIE - Vienna Stock Exchange',
+        'vmf' => 'VMF - Faroese Securities Market',
+        'vse' => 'VSE - Vancouver Stock Exchange',
+        'wse' => 'WSE - Warsaw Stock Exchange',
+        'ysx' => 'YSX - Yangon Stock Exchange',
+        'zamace' => 'ZAMACE - Zambian Commodity Exchange',
+        'zse' => 'ZSE - Zimbabwe Stock Exchange',
+        'zse_hr' => 'ZSE - Zagreb Stock Exchange'
+      }.freeze
+    end
+  end
+end

data/lib/crunchbase/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Crunchbase
-  VERSION = '0.1.1'
+  VERSION = '0.1.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: crunchbase4
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Encore Shao
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-06 00:00:00.000000000 Z
+date: 2020-06-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -132,6 +132,7 @@ files:
 - bin/setup
 - crunchbase4.gemspec
 - lib/crunchbase.rb
+- lib/crunchbase/autocompletes/client.rb
 - lib/crunchbase/client.rb
 - lib/crunchbase/config.rb
 - lib/crunchbase/entities.rb
@@ -139,22 +140,28 @@ files:
 - lib/crunchbase/errors.rb
 - lib/crunchbase/models.rb
 - lib/crunchbase/models/acquisition.rb
+- lib/crunchbase/models/autocomplete_entity.rb
 - lib/crunchbase/models/category.rb
 - lib/crunchbase/models/category_group.rb
 - lib/crunchbase/models/entity.rb
 - lib/crunchbase/models/funding_round.rb
 - lib/crunchbase/models/investment.rb
+- lib/crunchbase/models/ipo.rb
 - lib/crunchbase/models/organization.rb
 - lib/crunchbase/models/person.rb
 - lib/crunchbase/models/press_reference.rb
 - lib/crunchbase/searches.rb
 - lib/crunchbase/searches/client.rb
 - lib/crunchbase/utilities.rb
+- lib/crunchbase/utilities/autocomplete.rb
 - lib/crunchbase/utilities/cb_model.rb
+- lib/crunchbase/utilities/deleted_entities.rb
 - lib/crunchbase/utilities/entity_endpoints.rb
 - lib/crunchbase/utilities/request.rb
 - lib/crunchbase/utilities/response.rb
 - lib/crunchbase/utilities/search_endpoints.rb
+- lib/crunchbase/utilities/search_query_parameters.rb
+- lib/crunchbase/utilities/veriables.rb
 - lib/crunchbase/version.rb
 homepage: https://github.com/ekohe/crunchbase4
 licenses: