hydrafetch 0.3.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d895f580349c33641dc5f853c8d4c0ee46fa54bf55cf7edcb50093e47997bdf5
-  data.tar.gz: 10d8ea933dbd6c8091a616780711e248881c7ba6a83cff3eda0de11d1b122cfd
+  metadata.gz: f5a61cb3f085942a425d49d332d90facc8f698128393e6857fe9f9b50a200f35
+  data.tar.gz: 1332a661781e5859b3a2783c64b7fced6154e64222a189073d5f28be7601ccbc
 SHA512:
-  metadata.gz: b30cee276a93de1f569d53daa0fb039d6fc68d1804b680e31f7f29a76dc7b16ab206527aa10d68eda922c5eb48e526d825d6f6931986d1195bdadece5e46fc70
-  data.tar.gz: bac4bf2d4499fc4773bccfe2d59f7441f3f1f38cce49af9bfa971f806638b3d55db97297097a9081b7699f3f3c430f3f839f88a25a88d208ec9bc88f672ae656
+  metadata.gz: 24a54e965440320001b8c4cdc9708a8a913b00ed59b3cc0de04a008920ad1a659910601d720788ce0e9bd67019b205c28ecdeb172f9fb7b35b15ec5410a48f77
+  data.tar.gz: e18d9fb8acfcffc52f24c16f69be82c1293fb2e704c0342a442560e5955d40e788433beb6efaeb4ca103db357c5958e1ed919388c30444a9a3bc3f5a4ca8a6a3

data/README.md

@@ -120,6 +120,24 @@ res["results"].each do |r|
 end
 ```
 
+## Jobs
+
+Search open jobs collected from company career sites and hiring platforms, by the words in the job title:
+
+```ruby
+jobs = hf.search_jobs("data engineer", location: "Berlin", postedWithinDays: 14, limit: 20)
+jobs.each { |job| puts "#{job["title"]} #{job["domain"]} #{job["url"]}" }
+```
+
+See what changed in a company's hiring since a date: what is open now, what opened and what closed, by department, seniority and location, with the jobs themselves:
+
+```ruby
+acme = hf.hiring_changes("acme.com", "2026-10-01").first
+puts acme["totals"] # {"open"=>42, "opened"=>6, "closed"=>3}
+```
+
+A search costs 1 credit per 10 jobs returned, and an empty one is free. Hiring changes cost 1 credit per company we have jobs for; companies we do not track yet come back empty and are free.
+
 ## Brand data
 
 ```ruby
@@ -195,6 +213,8 @@ hf = Hydrafetch::Client.new("hf_...",
 | `markdown(url, **options)` | `String` | 1 |
 | `map(url, **options)` | links hash | 1 |
 | `search(query, **options)` | results hash | 1 + 1 per scraped result |
+| `search_jobs(query, **options)` | array of jobs | 1 per 10 jobs |
+| `hiring_changes(domains, since, **options)` | array of companies | 1 per company with jobs |
 | `extract(urls, **options)` | hash with `"results"` | 5 per URL |
 | `brand(domain)` | brand hash | 5 |
 | `logo(domain, **options)` | logo hash | 1 |

data/lib/hydrafetch/client.rb

@@ -1,5 +1,6 @@
 require "json"
 require "net/http"
+require "time"
 require "uri"
 
 require_relative "errors"
@@ -54,6 +55,16 @@ module Hydrafetch
       post("/v1/web/search", { query: query }.merge(compact(options)))
     end
 
+    def search_jobs(query, **options)
+      post("/v1/web/index/jobs/search", { query: query }.merge(compact(options)))
+    end
+
+    def hiring_changes(domains, since, **options)
+      list = domains.is_a?(String) ? [domains] : domains.to_a
+      at = since.respond_to?(:iso8601) ? since.iso8601 : since
+      post("/v1/web/index/jobs/changes", { domains: list, since: at }.merge(compact(options)))
+    end
+
     def extract(urls, **options)
       list = urls.is_a?(String) ? [urls] : urls.to_a
       post("/v1/web/extract", { urls: list }.merge(compact(options)))

data/lib/hydrafetch/version.rb

@@ -1,3 +1,3 @@
 module Hydrafetch
-  VERSION = "0.3.0".freeze
+  VERSION = "0.4.1".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hydrafetch
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Hydrafetch
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-21 00:00:00.000000000 Z
+date: 2026-11-04 00:00:00.000000000 Z
 dependencies: []
 description: Turn any URL into clean Markdown and structured data. Scrape, map, search,
   extract, brand and bulk crawl through one API.