@hydrafetch/node-sdk 0.5.0 → 0.7.0

package/README.md

@@ -166,6 +166,43 @@ const { results } = await hf.search('post-quantum TLS adoption', {
 results.forEach((r) => console.log(r.title, r.url, r.data?.markdown));
 ```
 
+## News
+
+Find recent news articles about anything, newest first, each with its outlet and publish time:
+
+```ts
+const { results } = await hf.news('acme raises funding', { timeRange: 'week', limit: 10 });
+
+results.forEach((a) => console.log(a.publishedAt, a.source, a.title, a.url));
+```
+
+A news search costs 1 credit, and one that finds nothing is free. Set `scrapeResults: true` to also read each article as clean data, at 1 extra credit per article.
+
+## Jobs
+
+Search open jobs collected from company career sites and hiring platforms, by the words in the job title:
+
+```ts
+const jobs = await hf.searchJobs('data engineer', {
+  location: 'Berlin',
+  postedWithinDays: 14,
+  limit: 20,
+});
+
+jobs.forEach((j) => console.log(j.title, j.company, j.location, j.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:
+
+```ts
+const [acme] = await hf.hiringChanges('acme.com', '2026-10-01');
+
+console.log(acme.totals); // { open: 42, opened: 6, closed: 3 }
+acme.opened.forEach((j) => console.log(j.title, j.seniority, j.firstSeenAt));
+```
+
+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
 
 ```ts
@@ -251,6 +288,9 @@ const hf = new Hydrafetch({
 | `markdown(url, options?)` | `string` | 1 |
 | `map(url, options?)` | `MapResult` | 1 |
 | `search(query, options?)` | `SearchResult` | 1 + 1 per scraped result |
+| `news(query, options?)` | `NewsResult` | 1 + 1 per article read; free when empty |
+| `searchJobs(query, options?)` | `OpenJob[]` | 1 per 10 jobs |
+| `hiringChanges(domains, since, options?)` | `CompanyHiringChanges[]` | 1 per company with jobs |
 | `extract(urls, options?)` | `ExtractResult<T>` | 5 per URL |
 | `brand(domain)` | `BrandResult` | 5 |
 | `logo(domain, options?)` | `LogoResult` | 1 |

package/dist/index.cjs

@@ -235,6 +235,19 @@ var Hydrafetch = class {
   search(query, options = {}) {
     return this.request("POST", "/v1/web/search", { query, ...options });
   }
+  news(query, options = {}) {
+    return this.request("POST", "/v1/web/news", { query, ...options });
+  }
+  searchJobs(query, options = {}) {
+    return this.request("POST", "/v1/web/index/jobs/search", { query, ...options });
+  }
+  hiringChanges(domains, since, options = {}) {
+    return this.request("POST", "/v1/web/index/jobs/changes", {
+      domains: Array.isArray(domains) ? domains : [domains],
+      since: since instanceof Date ? since.toISOString() : since,
+      ...options
+    });
+  }
   async extract(urls, options = {}) {
     const { schema, ...rest } = options;
     return this.request("POST", "/v1/web/extract", {

package/dist/index.d.cts

@@ -252,6 +252,112 @@ interface RateResultResponse {
     requestId: string;
     rating: ResultRating;
 }
+interface SearchJobsOptions {
+    /** A city, region or country to match, like "Berlin". */
+    location?: string;
+    /** Only jobs marked remote. */
+    remoteOnly?: boolean;
+    /** Only jobs posted in the last N days (1 to 365). */
+    postedWithinDays?: number;
+    /** Max jobs to return, 1 to 100 (default 10). Each 10 jobs returned cost 1 credit. */
+    limit?: number;
+    /** Include each job's description text when we hold it. */
+    includeDescriptions?: boolean;
+}
+interface JobPay {
+    min: number | null;
+    max: number | null;
+    currency: string | null;
+    interval: string | null;
+}
+interface OpenJob {
+    title: string;
+    company: string | null;
+    /** The company's website. */
+    domain: string;
+    /** The hiring platform the job is posted on. */
+    board: string;
+    department: string | null;
+    location: string | null;
+    remote: boolean | null;
+    employmentType: string | null;
+    postedAt: string | null;
+    /** When the job was first seen open. */
+    firstSeenAt: string;
+    url: string | null;
+    applyUrl: string | null;
+    pay: JobPay | null;
+    description?: string | null;
+}
+interface HiringChangesOptions {
+    /** Include each opened and closed job's description text when we hold it. */
+    includeDescriptions?: boolean;
+}
+interface HiringCounts {
+    open: number;
+    opened: number;
+    closed: number;
+}
+interface HiringChangePosting {
+    title: string;
+    department: string | null;
+    location: string | null;
+    seniority: string;
+    board: string;
+    url: string | null;
+    postedAt: string | null;
+    firstSeenAt: string;
+    closedAt: string | null;
+    description?: string | null;
+}
+interface CompanyHiringChanges {
+    domain: string;
+    company: string | null;
+    lastReadAt: string | null;
+    since: string;
+    totals: HiringCounts;
+    byDepartment: Record<string, HiringCounts>;
+    bySeniority: Record<string, HiringCounts>;
+    byLocation: Record<string, HiringCounts>;
+    opened: HiringChangePosting[];
+    closed: HiringChangePosting[];
+    truncated: boolean;
+}
+type NewsTimeRange = 'hour' | 'day' | 'week' | 'month';
+interface NewsOptions {
+    /** Max articles to return, 1 to 50 (default 10). */
+    limit?: number;
+    /** Only articles published within this window before now (default "week"). */
+    timeRange?: NewsTimeRange;
+    /** ISO 3166 alpha-2 country code to lean results toward, like "us". */
+    country?: string;
+    /** Only articles from these sites, up to 15. */
+    includeDomains?: string[];
+    /** Drop articles from these sites, up to 15. */
+    excludeDomains?: string[];
+    /** Also read each article as clean data, 1 extra credit per article read. */
+    scrapeResults?: boolean;
+    scrapeOptions?: ScrapeOptions;
+}
+interface NewsArticle {
+    title: string;
+    /** The article's address on the publisher's own site. */
+    url: string;
+    /** The outlet that published it. */
+    source: string | null;
+    /** When it was published, ISO 8601. */
+    publishedAt: string;
+    snippet: string | null;
+    imageUrl: string | null;
+    /** The article read as clean data when scrapeResults is on, otherwise null. */
+    data: ScrapeResult | null;
+}
+interface NewsResult {
+    query: string;
+    status: 'ok' | 'no_results';
+    /** Newest first. */
+    results: NewsArticle[];
+}
 
 interface HydrafetchOptions {
     apiKey?: string;
@@ -275,6 +381,9 @@ declare class Hydrafetch {
     rateResult(input: RateResultInput): Promise<RateResultResponse>;
     map(url: string, options?: MapOptions): Promise<MapResult>;
     search(query: string, options?: SearchOptions): Promise<SearchResult>;
+    news(query: string, options?: NewsOptions): Promise<NewsResult>;
+    searchJobs(query: string, options?: SearchJobsOptions): Promise<OpenJob[]>;
+    hiringChanges(domains: string | string[], since: string | Date, options?: HiringChangesOptions): Promise<CompanyHiringChanges[]>;
     extract<T = unknown>(urls: string | string[], options?: ExtractOptions): Promise<ExtractResult<T>>;
     brand(domain: string): Promise<BrandResult>;
     logo(domain: string, options?: BrandOptions): Promise<LogoResult>;
@@ -314,4 +423,4 @@ declare class HydrafetchTimeoutError extends HydrafetchError {
     constructor(message: string);
 }
 
-export { type BatchOptions, type BrandOptions, type BrandResult, type CrawlOptions, type ExtractItem, type ExtractOptions, type ExtractResult, type ExtractSchema, type Format, Hydrafetch, HydrafetchError, type HydrafetchOptions, HydrafetchTimeoutError, type ImagesResult, type JobPage, type JobResult, type JobStatus, type Location, type LogoResult, type MapOptions, type MapResult, type PageImage, type PageMetadata, type RateResultInput, type RateResultResponse, type ResultFeedbackReason, type ResultRating, type ScrapeBase, type ScrapeContent, type ScrapeOptions, type ScrapeResult, type ScreenshotOptions, type ScreenshotResult, type SearchOptions, type SearchResult, type SearchResultItem, type StyleguideOptions, type StyleguideResult, type Usage, type WaitOptions, type ZodLike };
+export { type BatchOptions, type BrandOptions, type BrandResult, type CompanyHiringChanges, type CrawlOptions, type ExtractItem, type ExtractOptions, type ExtractResult, type ExtractSchema, type Format, type HiringChangePosting, type HiringChangesOptions, type HiringCounts, Hydrafetch, HydrafetchError, type HydrafetchOptions, HydrafetchTimeoutError, type ImagesResult, type JobPage, type JobPay, type JobResult, type JobStatus, type Location, type LogoResult, type MapOptions, type MapResult, type NewsArticle, type NewsOptions, type NewsResult, type NewsTimeRange, type OpenJob, type PageImage, type PageMetadata, type RateResultInput, type RateResultResponse, type ResultFeedbackReason, type ResultRating, type ScrapeBase, type ScrapeContent, type ScrapeOptions, type ScrapeResult, type ScreenshotOptions, type ScreenshotResult, type SearchJobsOptions, type SearchOptions, type SearchResult, type SearchResultItem, type StyleguideOptions, type StyleguideResult, type Usage, type WaitOptions, type ZodLike };

package/dist/index.d.ts

@@ -252,6 +252,112 @@ interface RateResultResponse {
     requestId: string;
     rating: ResultRating;
 }
+interface SearchJobsOptions {
+    /** A city, region or country to match, like "Berlin". */
+    location?: string;
+    /** Only jobs marked remote. */
+    remoteOnly?: boolean;
+    /** Only jobs posted in the last N days (1 to 365). */
+    postedWithinDays?: number;
+    /** Max jobs to return, 1 to 100 (default 10). Each 10 jobs returned cost 1 credit. */
+    limit?: number;
+    /** Include each job's description text when we hold it. */
+    includeDescriptions?: boolean;
+}
+interface JobPay {
+    min: number | null;
+    max: number | null;
+    currency: string | null;
+    interval: string | null;
+}
+interface OpenJob {
+    title: string;
+    company: string | null;
+    /** The company's website. */
+    domain: string;
+    /** The hiring platform the job is posted on. */
+    board: string;
+    department: string | null;
+    location: string | null;
+    remote: boolean | null;
+    employmentType: string | null;
+    postedAt: string | null;
+    /** When the job was first seen open. */
+    firstSeenAt: string;
+    url: string | null;
+    applyUrl: string | null;
+    pay: JobPay | null;
+    description?: string | null;
+}
+interface HiringChangesOptions {
+    /** Include each opened and closed job's description text when we hold it. */
+    includeDescriptions?: boolean;
+}
+interface HiringCounts {
+    open: number;
+    opened: number;
+    closed: number;
+}
+interface HiringChangePosting {
+    title: string;
+    department: string | null;
+    location: string | null;
+    seniority: string;
+    board: string;
+    url: string | null;
+    postedAt: string | null;
+    firstSeenAt: string;
+    closedAt: string | null;
+    description?: string | null;
+}
+interface CompanyHiringChanges {
+    domain: string;
+    company: string | null;
+    lastReadAt: string | null;
+    since: string;
+    totals: HiringCounts;
+    byDepartment: Record<string, HiringCounts>;
+    bySeniority: Record<string, HiringCounts>;
+    byLocation: Record<string, HiringCounts>;
+    opened: HiringChangePosting[];
+    closed: HiringChangePosting[];
+    truncated: boolean;
+}
+type NewsTimeRange = 'hour' | 'day' | 'week' | 'month';
+interface NewsOptions {
+    /** Max articles to return, 1 to 50 (default 10). */
+    limit?: number;
+    /** Only articles published within this window before now (default "week"). */
+    timeRange?: NewsTimeRange;
+    /** ISO 3166 alpha-2 country code to lean results toward, like "us". */
+    country?: string;
+    /** Only articles from these sites, up to 15. */
+    includeDomains?: string[];
+    /** Drop articles from these sites, up to 15. */
+    excludeDomains?: string[];
+    /** Also read each article as clean data, 1 extra credit per article read. */
+    scrapeResults?: boolean;
+    scrapeOptions?: ScrapeOptions;
+}
+interface NewsArticle {
+    title: string;
+    /** The article's address on the publisher's own site. */
+    url: string;
+    /** The outlet that published it. */
+    source: string | null;
+    /** When it was published, ISO 8601. */
+    publishedAt: string;
+    snippet: string | null;
+    imageUrl: string | null;
+    /** The article read as clean data when scrapeResults is on, otherwise null. */
+    data: ScrapeResult | null;
+}
+interface NewsResult {
+    query: string;
+    status: 'ok' | 'no_results';
+    /** Newest first. */
+    results: NewsArticle[];
+}
 
 interface HydrafetchOptions {
     apiKey?: string;
@@ -275,6 +381,9 @@ declare class Hydrafetch {
     rateResult(input: RateResultInput): Promise<RateResultResponse>;
     map(url: string, options?: MapOptions): Promise<MapResult>;
     search(query: string, options?: SearchOptions): Promise<SearchResult>;
+    news(query: string, options?: NewsOptions): Promise<NewsResult>;
+    searchJobs(query: string, options?: SearchJobsOptions): Promise<OpenJob[]>;
+    hiringChanges(domains: string | string[], since: string | Date, options?: HiringChangesOptions): Promise<CompanyHiringChanges[]>;
     extract<T = unknown>(urls: string | string[], options?: ExtractOptions): Promise<ExtractResult<T>>;
     brand(domain: string): Promise<BrandResult>;
     logo(domain: string, options?: BrandOptions): Promise<LogoResult>;
@@ -314,4 +423,4 @@ declare class HydrafetchTimeoutError extends HydrafetchError {
     constructor(message: string);
 }
 
-export { type BatchOptions, type BrandOptions, type BrandResult, type CrawlOptions, type ExtractItem, type ExtractOptions, type ExtractResult, type ExtractSchema, type Format, Hydrafetch, HydrafetchError, type HydrafetchOptions, HydrafetchTimeoutError, type ImagesResult, type JobPage, type JobResult, type JobStatus, type Location, type LogoResult, type MapOptions, type MapResult, type PageImage, type PageMetadata, type RateResultInput, type RateResultResponse, type ResultFeedbackReason, type ResultRating, type ScrapeBase, type ScrapeContent, type ScrapeOptions, type ScrapeResult, type ScreenshotOptions, type ScreenshotResult, type SearchOptions, type SearchResult, type SearchResultItem, type StyleguideOptions, type StyleguideResult, type Usage, type WaitOptions, type ZodLike };
+export { type BatchOptions, type BrandOptions, type BrandResult, type CompanyHiringChanges, type CrawlOptions, type ExtractItem, type ExtractOptions, type ExtractResult, type ExtractSchema, type Format, type HiringChangePosting, type HiringChangesOptions, type HiringCounts, Hydrafetch, HydrafetchError, type HydrafetchOptions, HydrafetchTimeoutError, type ImagesResult, type JobPage, type JobPay, type JobResult, type JobStatus, type Location, type LogoResult, type MapOptions, type MapResult, type NewsArticle, type NewsOptions, type NewsResult, type NewsTimeRange, type OpenJob, type PageImage, type PageMetadata, type RateResultInput, type RateResultResponse, type ResultFeedbackReason, type ResultRating, type ScrapeBase, type ScrapeContent, type ScrapeOptions, type ScrapeResult, type ScreenshotOptions, type ScreenshotResult, type SearchJobsOptions, type SearchOptions, type SearchResult, type SearchResultItem, type StyleguideOptions, type StyleguideResult, type Usage, type WaitOptions, type ZodLike };

package/dist/index.js

@@ -207,6 +207,19 @@ var Hydrafetch = class {
   search(query, options = {}) {
     return this.request("POST", "/v1/web/search", { query, ...options });
   }
+  news(query, options = {}) {
+    return this.request("POST", "/v1/web/news", { query, ...options });
+  }
+  searchJobs(query, options = {}) {
+    return this.request("POST", "/v1/web/index/jobs/search", { query, ...options });
+  }
+  hiringChanges(domains, since, options = {}) {
+    return this.request("POST", "/v1/web/index/jobs/changes", {
+      domains: Array.isArray(domains) ? domains : [domains],
+      since: since instanceof Date ? since.toISOString() : since,
+      ...options
+    });
+  }
   async extract(urls, options = {}) {
     const { schema, ...rest } = options;
     return this.request("POST", "/v1/web/extract", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hydrafetch/node-sdk",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Official Node/TypeScript client for the Hydrafetch web data API. Turn any URL into clean Markdown and structured data.",
   "keywords": [
     "hydrafetch",