firecrawl 4.34.1 → 4.35.0

package/README.md

@@ -183,7 +183,8 @@ const scraped = await app.search('firecrawl changelog', {
 });
 ```
 
-Results are grouped by source: `.web`, `.news`, `.images` and `.developer`.
+Results are grouped by source: `.web`, `.news` and `.images`. Developer
+category results are served inside `.web`.
 
 Use `categories` to narrow web search to a kind of site:
 
@@ -198,6 +199,36 @@ const results = await app.search('nanopore basecalling accuracy', {
 > pubmed.ncbi.nlm.nih.gov, nature.com, biorxiv.org, ...) and returns web page
 > results. To search papers themselves, use `research.searchPapers` below.
 
+### Developer search
+
+Use `developerSearch` for the dedicated developer index and its complete filter
+and response contract. Generic `search(..., { categories: ['developer'] })`
+returns developer results inside `.web` in the ordinary web-result shape
+(first passage as the description) and does not accept these filters.
+
+```js
+const evidence = await app.developerSearch('configure retry backoff', {
+  repos: ['firecrawl/firecrawl'],
+  types: ['issue', 'pull_request', 'readme'],
+  passages: 3,
+  language: 'TypeScript',
+  license: 'MIT',
+});
+
+for (const result of evidence.results) {
+  // Result kind is the id prefix; the API intentionally omits a type field.
+  console.log(result.id, result.license);
+  for (const passage of result.passages) {
+    console.log(passage.text, passage.citation_url);
+  }
+}
+console.log(evidence.repos); // indexed-status echoes for requested repos
+```
+
+`developerSearch` also supports `sources`, `topic`, `minStars`, `maxStars`,
+`archived`, `fork`, and `skills: 'only'`. Supplying both `repos` and `sources`
+OR-combines GitHub-backed and documentation results.
+
 ### Research / paper search
 
 Use `app.research` to search Firecrawl's research paper index: ~43M paper

package/dist/{chunk-DWBMD5N5.js → chunk-666CR5HH.js}

@@ -12,7 +12,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.34.1",
+      version: "4.35.0",
       description: "JavaScript SDK for the Firecrawl API: web scraping, crawling, web search, and scientific literature search over a research paper index of PubMed, bioRxiv, medRxiv and arXiv abstracts",
       main: "dist/index.js",
       types: "dist/index.d.ts",

package/dist/index.cjs

@@ -39,7 +39,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.34.1",
+      version: "4.35.0",
       description: "JavaScript SDK for the Firecrawl API: web scraping, crawling, web search, and scientific literature search over a research paper index of PubMed, bioRxiv, medRxiv and arXiv abstracts",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -760,16 +760,13 @@ async function search(http, request) {
     if (data.news) out.news = transformArray(data.news);
     if (data.images)
       out.images = transformArray(data.images);
-    if (data.developer)
-      out.developer = transformArray(data.developer);
     Object.defineProperty(out, "data", {
       get() {
         const parts = [];
         if (out.web?.length) parts.push(`.web (${out.web.length} results)`);
         if (out.news?.length) parts.push(`.news (${out.news.length} results)`);
-        if (out.images?.length) parts.push(`.images (${out.images.length} results)`);
-        if (out.developer?.length)
-          parts.push(`.developer (${out.developer.length} results)`);
+        if (out.images?.length)
+          parts.push(`.images (${out.images.length} results)`);
         const available = parts.length ? parts.join(", ") : ".web, .news, or .images";
         throw new Error(
           `SearchData has no '.data'. Results are grouped by source: ${available}`
@@ -785,6 +782,39 @@ async function search(http, request) {
   }
 }
 
+// src/v2/methods/developer.ts
+var ENDPOINT = "/v2/search/developer";
+async function developerSearch(http, query, options = {}) {
+  if (!query || !query.trim()) throw new Error("query cannot be empty");
+  try {
+    const response = await http.post(ENDPOINT, {
+      query,
+      ...options.k !== void 0 ? { k: options.k } : {},
+      ...options.passages !== void 0 ? { passages: options.passages } : {},
+      ...options.types !== void 0 ? { types: options.types } : {},
+      ...options.repos !== void 0 ? { repos: options.repos } : {},
+      ...options.sources !== void 0 ? { sources: options.sources } : {},
+      ...options.language !== void 0 ? { language: options.language } : {},
+      ...options.topic !== void 0 ? { topic: options.topic } : {},
+      ...options.license !== void 0 ? { license: options.license } : {},
+      ...options.minStars !== void 0 ? { min_stars: options.minStars } : {},
+      ...options.maxStars !== void 0 ? { max_stars: options.maxStars } : {},
+      ...options.archived !== void 0 ? { archived: options.archived } : {},
+      ...options.fork !== void 0 ? { fork: options.fork } : {},
+      ...options.skills !== void 0 ? { skills: options.skills } : {}
+    });
+    if (response.status !== 200 || !response.data?.success) {
+      throwForBadResponse(response, "search developer sources");
+    }
+    return response.data;
+  } catch (error) {
+    if (error?.isAxiosError) {
+      return normalizeAxiosError(error, "search developer sources");
+    }
+    throw error;
+  }
+}
+
 // src/v2/methods/map.ts
 function prepareMapPayload(url, options) {
   if (!url || !url.trim()) throw new Error("URL cannot be empty");
@@ -2077,6 +2107,15 @@ var FirecrawlClient = class {
   async search(query, req = {}) {
     return search(this.http, { query, ...req });
   }
+  /**
+   * Search the dedicated developer index with repository, documentation,
+   * artifact, language, topic, license, star, archive, and fork filters.
+   * Unlike `search(query, { categories: ["developer"] })`, this returns all
+   * requested passages, citations, license disclosures, and indexing echoes.
+   */
+  async developerSearch(query, options = {}) {
+    return developerSearch(this.http, query, options);
+  }
   /**
    * Submit feedback for a v2 job.
    * @param request Feedback payload with endpoint, job id, rating, and supporting signals.

package/dist/index.d.cts

@@ -129,6 +129,14 @@ type PDFParser = {
     pageMarkdown?: boolean;
     /** Include per-page typed layout blocks (bounding boxes, block types, reading order). */
     blocks?: boolean;
+    /**
+     * Join PDF pages in `document.markdown` with `\n\n---\n\n<!-- page N -->\n\n`,
+     * where N is the 1-based physical page of the content that follows. Markers
+     * appear between pages only (no leading marker for page 1), and numbering may
+     * skip pages merged by cross-page stitching — use `pages: true` when every
+     * physical page is needed. No new response field.
+     */
+    pageMarkers?: boolean;
 };
 interface PdfPage {
     pageNumber: number;
@@ -551,6 +559,71 @@ interface PaginationConfig {
     /** Maximum time to spend fetching additional pages (in seconds). */
     maxWaitTime?: number;
 }
+type DeveloperSearchType = "doc" | "issue" | "pull_request" | "readme";
+interface DeveloperSearchOptions {
+    /** Total ranked results, 1–100 (default 10). */
+    k?: number;
+    /** Passages per result, 1–5 (default 1). */
+    passages?: number;
+    /** Result kinds to search (default all). */
+    types?: DeveloperSearchType[];
+    /** GitHub owner/name filters, at most 20. */
+    repos?: string[];
+    /** Developer documentation source IDs, at most 20. */
+    sources?: string[];
+    /** One case-insensitive GitHub Linguist primary language. */
+    language?: string;
+    /** Repository topics that must all match, at most 8. */
+    topic?: string[];
+    /** One case-insensitive SPDX repository license identifier. */
+    license?: string;
+    /** Minimum repository stars. */
+    minStars?: number;
+    /** Maximum repository stars. */
+    maxStars?: number;
+    /** Filter by repository archived status. */
+    archived?: boolean;
+    /** Filter by repository fork status. */
+    fork?: boolean;
+    /** Return packaged agent-skill evidence only. */
+    skills?: "only";
+}
+interface DeveloperSearchLicenseDisclosure {
+    state: "licensed" | "known_absent" | "unknown";
+    spdx_id: string | null;
+}
+interface DeveloperSearchPassage {
+    text: string;
+    citation_url?: string;
+}
+interface DeveloperSearchResult {
+    id: string;
+    url: string;
+    title?: string;
+    passages: DeveloperSearchPassage[];
+    license?: DeveloperSearchLicenseDisclosure | string;
+}
+interface DeveloperSearchRepoStatus {
+    repo: string;
+    indexed: boolean;
+    types: {
+        issue: boolean;
+        pullRequest: boolean;
+        readme: boolean;
+    };
+}
+interface DeveloperSearchSourceStatus {
+    source: string;
+    indexed: boolean;
+}
+interface DeveloperSearchResponse {
+    success: boolean;
+    results: DeveloperSearchResult[];
+    /** Present only when repos were requested. */
+    repos?: DeveloperSearchRepoStatus[];
+    /** Present only when sources were requested. */
+    sources?: DeveloperSearchSourceStatus[];
+}
 interface SearchResultWeb {
     url: string;
     title?: string;
@@ -579,7 +652,6 @@ interface SearchData {
     web?: Array<SearchResultWeb | Document>;
     news?: Array<SearchResultNews | Document>;
     images?: Array<SearchResultImages | Document>;
-    developer?: Array<SearchResultWeb | Document>;
 }
 /**
  * Narrows ordinary **web search**. A category does not switch `search()` to a
@@ -591,8 +663,8 @@ interface SearchData {
  *   ieee.org, sciencedirect.com, biorxiv.org, medrxiv.org, ...). It returns
  *   ordinary web page results from those domains, **not** paper records.
  * - `pdf` — restrict results to PDFs (adds `filetype:pdf`).
- * - `developer` — add developer results (issues, pull requests, READMEs and
- *   documentation) under `.developer`.
+ * - `developer` — developer-index results (issues, pull requests, READMEs and
+ *   documentation) served in `web`; cannot be combined with other categories.
  *
  * ⚠️ `categories: ["research"]` is **not** Firecrawl's research paper index.
  * To search papers themselves — ~43M abstracts, roughly 90% biomedical
@@ -1609,6 +1681,13 @@ declare class FirecrawlClient {
      * @returns Structured search results.
      */
     search(query: string, req?: Omit<SearchRequest, "query">): Promise<SearchData>;
+    /**
+     * Search the dedicated developer index with repository, documentation,
+     * artifact, language, topic, license, star, archive, and fork filters.
+     * Unlike `search(query, { categories: ["developer"] })`, this returns all
+     * requested passages, citations, license disclosures, and indexing echoes.
+     */
+    developerSearch(query: string, options?: DeveloperSearchOptions): Promise<DeveloperSearchResponse>;
     /**
      * Submit feedback for a v2 job.
      * @param request Feedback payload with endpoint, job id, rating, and supporting signals.
@@ -2806,4 +2885,4 @@ declare class Firecrawl extends FirecrawlClient {
     get v1(): FirecrawlApp;
 }
 
-export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AgentOptions$1 as AgentOptions, type AgentResponse, type AgentStatusResponse, type AgentWebhookConfig, type AgentWebhookEvent, type AttributesFormat, type AuditMetadata$1 as AuditMetadata, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type BrandingProfile, type BrowserCreateResponse, type BrowserDeleteResponse, type BrowserExecuteResponse, type BrowserListResponse, type BrowserSession, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreateMonitorRequest, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type Document, type DocumentMetadata, type EndpointFeedbackEndpoint, type EndpointFeedbackRequest, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, type FeedbackMissingContent, type FeedbackRating, type FeedbackResponse, type FeedbackValuableSource, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientInput, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, type GetMonitorCheckOptions, type GetPaperOptions, type GitHubScoreBreakdown, type GitHubSearchItem, type GitHubSearchResponse, type HighlightsFormat, type IdMap, JobTimeoutError, type JsonFormat, type ListMonitorChecksOptions, type ListMonitorsOptions, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type MenuAvailability, type MenuImage, type MenuItem, type MenuItemIdentifiers, type MenuMerchant, type MenuPrice, type MenuProfile, type MenuSection, type Monitor, type MonitorCheck, type MonitorCheckDetail, type MonitorCheckPage, type MonitorCrawlTarget, type MonitorCrawlTargetResult, type MonitorEmailNotification, type MonitorEmailRecipientSubscription, type MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorScrapeTargetResult, type MonitorSearchTarget, type MonitorSearchTargetResult, type MonitorSummary, type MonitorTarget, type MonitorTargetResult, type MonitorWebhookConfig, type PDFAction, type PDFParser, type PaginationConfig, type PaperMetadata, type PaperMetadataResponse, type PaperResult, type PaperSignals, type ParseFile, type ParseFileData, type ParseFormat, type ParseFormatOption, type ParseFormatString, type ParseOptions, type Passage, type PdfBlockConfidence, type PdfBlockItem, type PdfPage, type PdfPageBlocks, type PressAction, type ProductAvailability, type ProductImage, type ProductPrice, type ProductProfile, type ProductSale, type ProductVariant, type QueryFormat, type QuestionFormat, type QueueStatusResponse$1 as QueueStatusResponse, type ReadPaperResponse, type RedactPIIEntity, type RedactPIIOptions, ResearchClient, type ScrapeAction, type ScrapeBrowserDeleteResponse, type ScrapeExecuteRequest, type ScrapeExecuteResponse, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchFeedbackRequest, type SearchGithubOptions, type SearchPapersOptions, type SearchPapersResponse, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type SimilarPapersOptions, type SimilarPapersResponse, type ThreatProtectionOptions, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type UpdateMonitorRequest, type Viewport, type WaitAction, Watcher, type WatcherOptions, type WebhookConfig, type WriteAction, Firecrawl as default };
+export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AgentOptions$1 as AgentOptions, type AgentResponse, type AgentStatusResponse, type AgentWebhookConfig, type AgentWebhookEvent, type AttributesFormat, type AuditMetadata$1 as AuditMetadata, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type BrandingProfile, type BrowserCreateResponse, type BrowserDeleteResponse, type BrowserExecuteResponse, type BrowserListResponse, type BrowserSession, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreateMonitorRequest, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type DeveloperSearchLicenseDisclosure, type DeveloperSearchOptions, type DeveloperSearchPassage, type DeveloperSearchRepoStatus, type DeveloperSearchResponse, type DeveloperSearchResult, type DeveloperSearchSourceStatus, type DeveloperSearchType, type Document, type DocumentMetadata, type EndpointFeedbackEndpoint, type EndpointFeedbackRequest, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, type FeedbackMissingContent, type FeedbackRating, type FeedbackResponse, type FeedbackValuableSource, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientInput, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, type GetMonitorCheckOptions, type GetPaperOptions, type GitHubScoreBreakdown, type GitHubSearchItem, type GitHubSearchResponse, type HighlightsFormat, type IdMap, JobTimeoutError, type JsonFormat, type ListMonitorChecksOptions, type ListMonitorsOptions, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type MenuAvailability, type MenuImage, type MenuItem, type MenuItemIdentifiers, type MenuMerchant, type MenuPrice, type MenuProfile, type MenuSection, type Monitor, type MonitorCheck, type MonitorCheckDetail, type MonitorCheckPage, type MonitorCrawlTarget, type MonitorCrawlTargetResult, type MonitorEmailNotification, type MonitorEmailRecipientSubscription, type MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorScrapeTargetResult, type MonitorSearchTarget, type MonitorSearchTargetResult, type MonitorSummary, type MonitorTarget, type MonitorTargetResult, type MonitorWebhookConfig, type PDFAction, type PDFParser, type PaginationConfig, type PaperMetadata, type PaperMetadataResponse, type PaperResult, type PaperSignals, type ParseFile, type ParseFileData, type ParseFormat, type ParseFormatOption, type ParseFormatString, type ParseOptions, type Passage, type PdfBlockConfidence, type PdfBlockItem, type PdfPage, type PdfPageBlocks, type PressAction, type ProductAvailability, type ProductImage, type ProductPrice, type ProductProfile, type ProductSale, type ProductVariant, type QueryFormat, type QuestionFormat, type QueueStatusResponse$1 as QueueStatusResponse, type ReadPaperResponse, type RedactPIIEntity, type RedactPIIOptions, ResearchClient, type ScrapeAction, type ScrapeBrowserDeleteResponse, type ScrapeExecuteRequest, type ScrapeExecuteResponse, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchFeedbackRequest, type SearchGithubOptions, type SearchPapersOptions, type SearchPapersResponse, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type SimilarPapersOptions, type SimilarPapersResponse, type ThreatProtectionOptions, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type UpdateMonitorRequest, type Viewport, type WaitAction, Watcher, type WatcherOptions, type WebhookConfig, type WriteAction, Firecrawl as default };

package/dist/index.d.ts

@@ -129,6 +129,14 @@ type PDFParser = {
     pageMarkdown?: boolean;
     /** Include per-page typed layout blocks (bounding boxes, block types, reading order). */
     blocks?: boolean;
+    /**
+     * Join PDF pages in `document.markdown` with `\n\n---\n\n<!-- page N -->\n\n`,
+     * where N is the 1-based physical page of the content that follows. Markers
+     * appear between pages only (no leading marker for page 1), and numbering may
+     * skip pages merged by cross-page stitching — use `pages: true` when every
+     * physical page is needed. No new response field.
+     */
+    pageMarkers?: boolean;
 };
 interface PdfPage {
     pageNumber: number;
@@ -551,6 +559,71 @@ interface PaginationConfig {
     /** Maximum time to spend fetching additional pages (in seconds). */
     maxWaitTime?: number;
 }
+type DeveloperSearchType = "doc" | "issue" | "pull_request" | "readme";
+interface DeveloperSearchOptions {
+    /** Total ranked results, 1–100 (default 10). */
+    k?: number;
+    /** Passages per result, 1–5 (default 1). */
+    passages?: number;
+    /** Result kinds to search (default all). */
+    types?: DeveloperSearchType[];
+    /** GitHub owner/name filters, at most 20. */
+    repos?: string[];
+    /** Developer documentation source IDs, at most 20. */
+    sources?: string[];
+    /** One case-insensitive GitHub Linguist primary language. */
+    language?: string;
+    /** Repository topics that must all match, at most 8. */
+    topic?: string[];
+    /** One case-insensitive SPDX repository license identifier. */
+    license?: string;
+    /** Minimum repository stars. */
+    minStars?: number;
+    /** Maximum repository stars. */
+    maxStars?: number;
+    /** Filter by repository archived status. */
+    archived?: boolean;
+    /** Filter by repository fork status. */
+    fork?: boolean;
+    /** Return packaged agent-skill evidence only. */
+    skills?: "only";
+}
+interface DeveloperSearchLicenseDisclosure {
+    state: "licensed" | "known_absent" | "unknown";
+    spdx_id: string | null;
+}
+interface DeveloperSearchPassage {
+    text: string;
+    citation_url?: string;
+}
+interface DeveloperSearchResult {
+    id: string;
+    url: string;
+    title?: string;
+    passages: DeveloperSearchPassage[];
+    license?: DeveloperSearchLicenseDisclosure | string;
+}
+interface DeveloperSearchRepoStatus {
+    repo: string;
+    indexed: boolean;
+    types: {
+        issue: boolean;
+        pullRequest: boolean;
+        readme: boolean;
+    };
+}
+interface DeveloperSearchSourceStatus {
+    source: string;
+    indexed: boolean;
+}
+interface DeveloperSearchResponse {
+    success: boolean;
+    results: DeveloperSearchResult[];
+    /** Present only when repos were requested. */
+    repos?: DeveloperSearchRepoStatus[];
+    /** Present only when sources were requested. */
+    sources?: DeveloperSearchSourceStatus[];
+}
 interface SearchResultWeb {
     url: string;
     title?: string;
@@ -579,7 +652,6 @@ interface SearchData {
     web?: Array<SearchResultWeb | Document>;
     news?: Array<SearchResultNews | Document>;
     images?: Array<SearchResultImages | Document>;
-    developer?: Array<SearchResultWeb | Document>;
 }
 /**
  * Narrows ordinary **web search**. A category does not switch `search()` to a
@@ -591,8 +663,8 @@ interface SearchData {
  *   ieee.org, sciencedirect.com, biorxiv.org, medrxiv.org, ...). It returns
  *   ordinary web page results from those domains, **not** paper records.
  * - `pdf` — restrict results to PDFs (adds `filetype:pdf`).
- * - `developer` — add developer results (issues, pull requests, READMEs and
- *   documentation) under `.developer`.
+ * - `developer` — developer-index results (issues, pull requests, READMEs and
+ *   documentation) served in `web`; cannot be combined with other categories.
  *
  * ⚠️ `categories: ["research"]` is **not** Firecrawl's research paper index.
  * To search papers themselves — ~43M abstracts, roughly 90% biomedical
@@ -1609,6 +1681,13 @@ declare class FirecrawlClient {
      * @returns Structured search results.
      */
     search(query: string, req?: Omit<SearchRequest, "query">): Promise<SearchData>;
+    /**
+     * Search the dedicated developer index with repository, documentation,
+     * artifact, language, topic, license, star, archive, and fork filters.
+     * Unlike `search(query, { categories: ["developer"] })`, this returns all
+     * requested passages, citations, license disclosures, and indexing echoes.
+     */
+    developerSearch(query: string, options?: DeveloperSearchOptions): Promise<DeveloperSearchResponse>;
     /**
      * Submit feedback for a v2 job.
      * @param request Feedback payload with endpoint, job id, rating, and supporting signals.
@@ -2806,4 +2885,4 @@ declare class Firecrawl extends FirecrawlClient {
     get v1(): FirecrawlApp;
 }
 
-export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AgentOptions$1 as AgentOptions, type AgentResponse, type AgentStatusResponse, type AgentWebhookConfig, type AgentWebhookEvent, type AttributesFormat, type AuditMetadata$1 as AuditMetadata, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type BrandingProfile, type BrowserCreateResponse, type BrowserDeleteResponse, type BrowserExecuteResponse, type BrowserListResponse, type BrowserSession, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreateMonitorRequest, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type Document, type DocumentMetadata, type EndpointFeedbackEndpoint, type EndpointFeedbackRequest, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, type FeedbackMissingContent, type FeedbackRating, type FeedbackResponse, type FeedbackValuableSource, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientInput, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, type GetMonitorCheckOptions, type GetPaperOptions, type GitHubScoreBreakdown, type GitHubSearchItem, type GitHubSearchResponse, type HighlightsFormat, type IdMap, JobTimeoutError, type JsonFormat, type ListMonitorChecksOptions, type ListMonitorsOptions, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type MenuAvailability, type MenuImage, type MenuItem, type MenuItemIdentifiers, type MenuMerchant, type MenuPrice, type MenuProfile, type MenuSection, type Monitor, type MonitorCheck, type MonitorCheckDetail, type MonitorCheckPage, type MonitorCrawlTarget, type MonitorCrawlTargetResult, type MonitorEmailNotification, type MonitorEmailRecipientSubscription, type MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorScrapeTargetResult, type MonitorSearchTarget, type MonitorSearchTargetResult, type MonitorSummary, type MonitorTarget, type MonitorTargetResult, type MonitorWebhookConfig, type PDFAction, type PDFParser, type PaginationConfig, type PaperMetadata, type PaperMetadataResponse, type PaperResult, type PaperSignals, type ParseFile, type ParseFileData, type ParseFormat, type ParseFormatOption, type ParseFormatString, type ParseOptions, type Passage, type PdfBlockConfidence, type PdfBlockItem, type PdfPage, type PdfPageBlocks, type PressAction, type ProductAvailability, type ProductImage, type ProductPrice, type ProductProfile, type ProductSale, type ProductVariant, type QueryFormat, type QuestionFormat, type QueueStatusResponse$1 as QueueStatusResponse, type ReadPaperResponse, type RedactPIIEntity, type RedactPIIOptions, ResearchClient, type ScrapeAction, type ScrapeBrowserDeleteResponse, type ScrapeExecuteRequest, type ScrapeExecuteResponse, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchFeedbackRequest, type SearchGithubOptions, type SearchPapersOptions, type SearchPapersResponse, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type SimilarPapersOptions, type SimilarPapersResponse, type ThreatProtectionOptions, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type UpdateMonitorRequest, type Viewport, type WaitAction, Watcher, type WatcherOptions, type WebhookConfig, type WriteAction, Firecrawl as default };
+export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AgentOptions$1 as AgentOptions, type AgentResponse, type AgentStatusResponse, type AgentWebhookConfig, type AgentWebhookEvent, type AttributesFormat, type AuditMetadata$1 as AuditMetadata, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type BrandingProfile, type BrowserCreateResponse, type BrowserDeleteResponse, type BrowserExecuteResponse, type BrowserListResponse, type BrowserSession, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreateMonitorRequest, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type DeveloperSearchLicenseDisclosure, type DeveloperSearchOptions, type DeveloperSearchPassage, type DeveloperSearchRepoStatus, type DeveloperSearchResponse, type DeveloperSearchResult, type DeveloperSearchSourceStatus, type DeveloperSearchType, type Document, type DocumentMetadata, type EndpointFeedbackEndpoint, type EndpointFeedbackRequest, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, type FeedbackMissingContent, type FeedbackRating, type FeedbackResponse, type FeedbackValuableSource, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientInput, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, type GetMonitorCheckOptions, type GetPaperOptions, type GitHubScoreBreakdown, type GitHubSearchItem, type GitHubSearchResponse, type HighlightsFormat, type IdMap, JobTimeoutError, type JsonFormat, type ListMonitorChecksOptions, type ListMonitorsOptions, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type MenuAvailability, type MenuImage, type MenuItem, type MenuItemIdentifiers, type MenuMerchant, type MenuPrice, type MenuProfile, type MenuSection, type Monitor, type MonitorCheck, type MonitorCheckDetail, type MonitorCheckPage, type MonitorCrawlTarget, type MonitorCrawlTargetResult, type MonitorEmailNotification, type MonitorEmailRecipientSubscription, type MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorScrapeTargetResult, type MonitorSearchTarget, type MonitorSearchTargetResult, type MonitorSummary, type MonitorTarget, type MonitorTargetResult, type MonitorWebhookConfig, type PDFAction, type PDFParser, type PaginationConfig, type PaperMetadata, type PaperMetadataResponse, type PaperResult, type PaperSignals, type ParseFile, type ParseFileData, type ParseFormat, type ParseFormatOption, type ParseFormatString, type ParseOptions, type Passage, type PdfBlockConfidence, type PdfBlockItem, type PdfPage, type PdfPageBlocks, type PressAction, type ProductAvailability, type ProductImage, type ProductPrice, type ProductProfile, type ProductSale, type ProductVariant, type QueryFormat, type QuestionFormat, type QueueStatusResponse$1 as QueueStatusResponse, type ReadPaperResponse, type RedactPIIEntity, type RedactPIIOptions, ResearchClient, type ScrapeAction, type ScrapeBrowserDeleteResponse, type ScrapeExecuteRequest, type ScrapeExecuteResponse, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchFeedbackRequest, type SearchGithubOptions, type SearchPapersOptions, type SearchPapersResponse, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type SimilarPapersOptions, type SimilarPapersResponse, type ThreatProtectionOptions, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type UpdateMonitorRequest, type Viewport, type WaitAction, Watcher, type WatcherOptions, type WebhookConfig, type WriteAction, Firecrawl as default };

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   require_package
-} from "./chunk-DWBMD5N5.js";
+} from "./chunk-666CR5HH.js";
 
 // src/v2/utils/httpClient.ts
 import axios from "axios";
@@ -629,16 +629,13 @@ async function search(http, request) {
     if (data.news) out.news = transformArray(data.news);
     if (data.images)
       out.images = transformArray(data.images);
-    if (data.developer)
-      out.developer = transformArray(data.developer);
     Object.defineProperty(out, "data", {
       get() {
         const parts = [];
         if (out.web?.length) parts.push(`.web (${out.web.length} results)`);
         if (out.news?.length) parts.push(`.news (${out.news.length} results)`);
-        if (out.images?.length) parts.push(`.images (${out.images.length} results)`);
-        if (out.developer?.length)
-          parts.push(`.developer (${out.developer.length} results)`);
+        if (out.images?.length)
+          parts.push(`.images (${out.images.length} results)`);
         const available = parts.length ? parts.join(", ") : ".web, .news, or .images";
         throw new Error(
           `SearchData has no '.data'. Results are grouped by source: ${available}`
@@ -654,6 +651,39 @@ async function search(http, request) {
   }
 }
 
+// src/v2/methods/developer.ts
+var ENDPOINT = "/v2/search/developer";
+async function developerSearch(http, query, options = {}) {
+  if (!query || !query.trim()) throw new Error("query cannot be empty");
+  try {
+    const response = await http.post(ENDPOINT, {
+      query,
+      ...options.k !== void 0 ? { k: options.k } : {},
+      ...options.passages !== void 0 ? { passages: options.passages } : {},
+      ...options.types !== void 0 ? { types: options.types } : {},
+      ...options.repos !== void 0 ? { repos: options.repos } : {},
+      ...options.sources !== void 0 ? { sources: options.sources } : {},
+      ...options.language !== void 0 ? { language: options.language } : {},
+      ...options.topic !== void 0 ? { topic: options.topic } : {},
+      ...options.license !== void 0 ? { license: options.license } : {},
+      ...options.minStars !== void 0 ? { min_stars: options.minStars } : {},
+      ...options.maxStars !== void 0 ? { max_stars: options.maxStars } : {},
+      ...options.archived !== void 0 ? { archived: options.archived } : {},
+      ...options.fork !== void 0 ? { fork: options.fork } : {},
+      ...options.skills !== void 0 ? { skills: options.skills } : {}
+    });
+    if (response.status !== 200 || !response.data?.success) {
+      throwForBadResponse(response, "search developer sources");
+    }
+    return response.data;
+  } catch (error) {
+    if (error?.isAxiosError) {
+      return normalizeAxiosError(error, "search developer sources");
+    }
+    throw error;
+  }
+}
+
 // src/v2/methods/map.ts
 function prepareMapPayload(url, options) {
   if (!url || !url.trim()) throw new Error("URL cannot be empty");
@@ -1946,6 +1976,15 @@ var FirecrawlClient = class {
   async search(query, req = {}) {
     return search(this.http, { query, ...req });
   }
+  /**
+   * Search the dedicated developer index with repository, documentation,
+   * artifact, language, topic, license, star, archive, and fork filters.
+   * Unlike `search(query, { categories: ["developer"] })`, this returns all
+   * requested passages, citations, license disclosures, and indexing echoes.
+   */
+  async developerSearch(query, options = {}) {
+    return developerSearch(this.http, query, options);
+  }
   /**
    * Submit feedback for a v2 job.
    * @param request Feedback payload with endpoint, job id, rating, and supporting signals.
@@ -2342,7 +2381,7 @@ var FirecrawlApp = class {
       if (typeof process !== "undefined" && process.env && process.env.npm_package_version) {
         return process.env.npm_package_version;
       }
-      const packageJson = await import("./package-XAWX5C5Y.js");
+      const packageJson = await import("./package-ZOVFJE7Z.js");
       return packageJson.default.version;
     } catch (error) {
       const isTest = typeof process !== "undefined" && (process.env.JEST_WORKER_ID != null || false);

package/dist/{package-XAWX5C5Y.js → package-ZOVFJE7Z.js}

@@ -1,4 +1,4 @@
 import {
   require_package
-} from "./chunk-DWBMD5N5.js";
+} from "./chunk-666CR5HH.js";
 export default require_package();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firecrawl",
-  "version": "4.34.1",
+  "version": "4.35.0",
   "description": "JavaScript SDK for the Firecrawl API: web scraping, crawling, web search, and scientific literature search over a research paper index of PubMed, bioRxiv, medRxiv and arXiv abstracts",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/__tests__/unit/v2/developer.test.ts

@@ -0,0 +1,118 @@
+import { describe, expect, jest, test } from "@jest/globals";
+import { FirecrawlClient } from "../../../v2/client";
+import { SdkError } from "../../../v2/types";
+
+const response = {
+  success: true,
+  results: [
+    {
+      id: "issue:firecrawl/firecrawl#1",
+      url: "https://github.com/firecrawl/firecrawl/issues/1",
+      passages: [
+        {
+          text: "evidence",
+          citation_url:
+            "https://github.com/firecrawl/firecrawl/issues/1#issuecomment-1",
+        },
+      ],
+      license: { state: "licensed" as const, spdx_id: "MIT" },
+    },
+  ],
+  repos: [
+    {
+      repo: "firecrawl/firecrawl",
+      indexed: true,
+      types: { issue: true, pullRequest: true, readme: true },
+    },
+  ],
+  sources: [{ source: "firecrawl", indexed: false }],
+};
+
+describe("developerSearch", () => {
+  test("forwards every dedicated developer filter", async () => {
+    const http = {
+      post: jest.fn(async () => ({ status: 200, data: response })),
+    } as any;
+
+    const client = new FirecrawlClient({
+      apiKey: "test",
+      apiUrl: "http://localhost",
+    });
+    (client as any).http = http;
+
+    const result = await client.developerSearch("retry configuration", {
+      k: 20,
+      passages: 5,
+      types: ["doc", "issue", "pull_request", "readme"],
+      repos: ["firecrawl/firecrawl"],
+      sources: ["firecrawl"],
+      language: "TypeScript",
+      topic: ["web-scraping"],
+      license: "MIT",
+      minStars: 100,
+      maxStars: 50000,
+      archived: false,
+      fork: true,
+      skills: "only",
+    });
+
+    expect(http.post).toHaveBeenCalledWith("/v2/search/developer", {
+      query: "retry configuration",
+      k: 20,
+      passages: 5,
+      types: ["doc", "issue", "pull_request", "readme"],
+      repos: ["firecrawl/firecrawl"],
+      sources: ["firecrawl"],
+      language: "TypeScript",
+      topic: ["web-scraping"],
+      license: "MIT",
+      min_stars: 100,
+      max_stars: 50000,
+      archived: false,
+      fork: true,
+      skills: "only",
+    });
+    expect(result).toEqual(response);
+  });
+
+  test("normalizes transport errors to SdkError", async () => {
+    const http = {
+      post: jest.fn(async () => {
+        throw {
+          isAxiosError: true,
+          code: "ECONNABORTED",
+          message: "request timed out",
+        };
+      }),
+    } as any;
+    const client = new FirecrawlClient({
+      apiKey: "test",
+      apiUrl: "http://localhost",
+    });
+    (client as any).http = http;
+
+    await expect(
+      client.developerSearch("network failure"),
+    ).rejects.toBeInstanceOf(SdkError);
+  });
+
+  test("accepts the flattened SPDX license response shape", async () => {
+    const flattened = {
+      ...response,
+      results: [{ ...response.results[0], license: "MIT" }],
+    };
+    const http = {
+      post: jest.fn(async () => ({ status: 200, data: flattened })),
+    } as any;
+
+    const client = new FirecrawlClient({
+      apiKey: "test",
+      apiUrl: "http://localhost",
+    });
+    (client as any).http = http;
+
+    await expect(client.developerSearch("license shape")).resolves.toEqual(
+      flattened,
+    );
+  });
+});

package/src/__tests__/unit/v2/search-developer.unit.test.ts

@@ -1,8 +1,10 @@
 import { describe, expect, jest, test } from "@jest/globals";
 import { search } from "../../../v2/methods/search";
+import type { SearchResultWeb } from "../../../v2/types";
 
-const developerResult = {
-  title: "https://github.com/firecrawl/firecrawl/issues/1",
+// Developer results arrive in the exact web schema.
+const developerResult: SearchResultWeb = {
+  title: "Retry requests",
   url: "https://github.com/firecrawl/firecrawl/issues/1",
   description: "passage",
   position: 1,
@@ -28,38 +30,26 @@ describe("v2 search developer category", () => {
     );
   });
 
-  test("returns developer results", async () => {
-    const http = httpWith({
-      web: [{ title: "W", url: "http://a.com" }],
-      developer: [developerResult],
-    });
+  test("returns developer results inside web", async () => {
+    const http = httpWith({ web: [developerResult] });
 
     const result = await search(http, {
       query: "firecrawl",
       categories: [{ type: "developer" }],
     });
 
-    expect(result.web).toHaveLength(1);
-    expect(result.developer).toHaveLength(1);
-    expect(result.developer?.[0]).toEqual(developerResult);
-  });
-
-  test("omits developer when the response has none", async () => {
-    const http = httpWith({ web: [] });
-
-    const result = await search(http, { query: "firecrawl" });
-
-    expect(result.developer).toBeUndefined();
+    expect(result.web).toEqual([developerResult]);
+    expect(result).not.toHaveProperty("developer");
   });
 
-  test("lists developer in the .data error", async () => {
-    const http = httpWith({ developer: [developerResult] });
+  test("lists developer results as web results in the .data error", async () => {
+    const http = httpWith({ web: [developerResult] });
 
     const result = await search(http, {
       query: "firecrawl",
       categories: ["developer"],
     });
 
-    expect(() => (result as any).data).toThrow(/\.developer \(1 results\)/);
+    expect(() => (result as any).data).toThrow(/\.web \(1 results\)/);
   });
 });

package/src/__tests__/unit/v2/validation.test.ts

@@ -89,9 +89,9 @@ describe("v2 utils: validation", () => {
     expect(options.parsers).toEqual(before);
   });
 
-  test("ensureValidScrapeOptions: leaves PDF parser pages and blocks options untouched", () => {
+  test("ensureValidScrapeOptions: leaves PDF parser pages, blocks, and pageMarkers options untouched", () => {
     const options = {
-      parsers: [{ type: "pdf", mode: "auto", blocks: true, pages: true }],
+      parsers: [{ type: "pdf", mode: "auto", blocks: true, pages: true, pageMarkers: true }],
     } as any;
     expect(() => ensureValidScrapeOptions(options)).not.toThrow();
     expect(options.parsers[0]).toEqual({
@@ -99,6 +99,7 @@ describe("v2 utils: validation", () => {
       mode: "auto",
       blocks: true,
       pages: true,
+      pageMarkers: true,
     });
   });
 

package/src/v2/client.ts

@@ -6,6 +6,7 @@ import {
 } from "./methods/scrape";
 import { parse as parseMethod } from "./methods/parse";
 import { search } from "./methods/search";
+import { developerSearch as developerSearchMethod } from "./methods/developer";
 import { map as mapMethod } from "./methods/map";
 import { feedback as feedbackMethod, searchFeedback as searchFeedbackMethod } from "./methods/feedback";
 import {
@@ -51,6 +52,8 @@ import type {
   ScrapeOptions,
   SearchData,
   SearchRequest,
+  DeveloperSearchOptions,
+  DeveloperSearchResponse,
   EndpointFeedbackRequest,
   FeedbackResponse,
   SearchFeedbackRequest,
@@ -240,6 +243,19 @@ export class FirecrawlClient {
     return search(this.http, { query, ...req });
   }
 
+  /**
+   * Search the dedicated developer index with repository, documentation,
+   * artifact, language, topic, license, star, archive, and fork filters.
+   * Unlike `search(query, { categories: ["developer"] })`, this returns all
+   * requested passages, citations, license disclosures, and indexing echoes.
+   */
+  async developerSearch(
+    query: string,
+    options: DeveloperSearchOptions = {},
+  ): Promise<DeveloperSearchResponse> {
+    return developerSearchMethod(this.http, query, options);
+  }
+
   /**
    * Submit feedback for a v2 job.
    * @param request Feedback payload with endpoint, job id, rating, and supporting signals.

package/src/v2/methods/developer.ts

@@ -0,0 +1,50 @@
+import type { DeveloperSearchOptions, DeveloperSearchResponse } from "../types";
+import { HttpClient } from "../utils/httpClient";
+import {
+  normalizeAxiosError,
+  throwForBadResponse,
+} from "../utils/errorHandler";
+
+const ENDPOINT = "/v2/search/developer";
+
+/** Search the dedicated developer index with its complete filter surface. */
+export async function developerSearch(
+  http: HttpClient,
+  query: string,
+  options: DeveloperSearchOptions = {},
+): Promise<DeveloperSearchResponse> {
+  if (!query || !query.trim()) throw new Error("query cannot be empty");
+
+  try {
+    const response = await http.post<DeveloperSearchResponse>(ENDPOINT, {
+      query,
+      ...(options.k !== undefined ? { k: options.k } : {}),
+      ...(options.passages !== undefined ? { passages: options.passages } : {}),
+      ...(options.types !== undefined ? { types: options.types } : {}),
+      ...(options.repos !== undefined ? { repos: options.repos } : {}),
+      ...(options.sources !== undefined ? { sources: options.sources } : {}),
+      ...(options.language !== undefined ? { language: options.language } : {}),
+      ...(options.topic !== undefined ? { topic: options.topic } : {}),
+      ...(options.license !== undefined ? { license: options.license } : {}),
+      ...(options.minStars !== undefined
+        ? { min_stars: options.minStars }
+        : {}),
+      ...(options.maxStars !== undefined
+        ? { max_stars: options.maxStars }
+        : {}),
+      ...(options.archived !== undefined ? { archived: options.archived } : {}),
+      ...(options.fork !== undefined ? { fork: options.fork } : {}),
+      ...(options.skills !== undefined ? { skills: options.skills } : {}),
+    });
+
+    if (response.status !== 200 || !response.data?.success) {
+      throwForBadResponse(response, "search developer sources");
+    }
+    return response.data;
+  } catch (error: any) {
+    if (error?.isAxiosError) {
+      return normalizeAxiosError(error, "search developer sources");
+    }
+    throw error;
+  }
+}

package/src/v2/methods/search.ts

@@ -102,17 +102,16 @@ export async function search(
     if (data.news) out.news = transformArray<SearchResultNews>(data.news);
     if (data.images)
       out.images = transformArray<SearchResultImages>(data.images);
-    if (data.developer)
-      out.developer = transformArray<SearchResultWeb>(data.developer);
     Object.defineProperty(out, "data", {
       get() {
         const parts: string[] = [];
         if (out.web?.length) parts.push(`.web (${out.web.length} results)`);
         if (out.news?.length) parts.push(`.news (${out.news.length} results)`);
-        if (out.images?.length) parts.push(`.images (${out.images.length} results)`);
-        if (out.developer?.length)
-          parts.push(`.developer (${out.developer.length} results)`);
-        const available = parts.length ? parts.join(", ") : ".web, .news, or .images";
+        if (out.images?.length)
+          parts.push(`.images (${out.images.length} results)`);
+        const available = parts.length
+          ? parts.join(", ")
+          : ".web, .news, or .images";
         throw new Error(
           `SearchData has no '.data'. Results are grouped by source: ${available}`,
         );

package/src/v2/types.ts

@@ -199,6 +199,14 @@ export type PDFParser = {
   pageMarkdown?: boolean;
   /** Include per-page typed layout blocks (bounding boxes, block types, reading order). */
   blocks?: boolean;
+  /**
+   * Join PDF pages in `document.markdown` with `\n\n---\n\n<!-- page N -->\n\n`,
+   * where N is the 1-based physical page of the content that follows. Markers
+   * appear between pages only (no leading marker for page 1), and numbering may
+   * skip pages merged by cross-page stitching — use `pages: true` when every
+   * physical page is needed. No new response field.
+   */
+  pageMarkers?: boolean;
 };
 
 export interface PdfPage {
@@ -707,6 +715,76 @@ export interface PaginationConfig {
   maxWaitTime?: number;
 }
 
+export type DeveloperSearchType = "doc" | "issue" | "pull_request" | "readme";
+
+export interface DeveloperSearchOptions {
+  /** Total ranked results, 1–100 (default 10). */
+  k?: number;
+  /** Passages per result, 1–5 (default 1). */
+  passages?: number;
+  /** Result kinds to search (default all). */
+  types?: DeveloperSearchType[];
+  /** GitHub owner/name filters, at most 20. */
+  repos?: string[];
+  /** Developer documentation source IDs, at most 20. */
+  sources?: string[];
+  /** One case-insensitive GitHub Linguist primary language. */
+  language?: string;
+  /** Repository topics that must all match, at most 8. */
+  topic?: string[];
+  /** One case-insensitive SPDX repository license identifier. */
+  license?: string;
+  /** Minimum repository stars. */
+  minStars?: number;
+  /** Maximum repository stars. */
+  maxStars?: number;
+  /** Filter by repository archived status. */
+  archived?: boolean;
+  /** Filter by repository fork status. */
+  fork?: boolean;
+  /** Return packaged agent-skill evidence only. */
+  skills?: "only";
+}
+
+export interface DeveloperSearchLicenseDisclosure {
+  state: "licensed" | "known_absent" | "unknown";
+  spdx_id: string | null;
+}
+
+export interface DeveloperSearchPassage {
+  text: string;
+  citation_url?: string;
+}
+
+export interface DeveloperSearchResult {
+  id: string;
+  url: string;
+  title?: string;
+  passages: DeveloperSearchPassage[];
+  // Accept both shapes while the API flattens license objects to SPDX strings.
+  license?: DeveloperSearchLicenseDisclosure | string;
+}
+
+export interface DeveloperSearchRepoStatus {
+  repo: string;
+  indexed: boolean;
+  types: { issue: boolean; pullRequest: boolean; readme: boolean };
+}
+
+export interface DeveloperSearchSourceStatus {
+  source: string;
+  indexed: boolean;
+}
+
+export interface DeveloperSearchResponse {
+  success: boolean;
+  results: DeveloperSearchResult[];
+  /** Present only when repos were requested. */
+  repos?: DeveloperSearchRepoStatus[];
+  /** Present only when sources were requested. */
+  sources?: DeveloperSearchSourceStatus[];
+}
+
 export interface SearchResultWeb {
   url: string;
   title?: string;
@@ -738,7 +816,6 @@ export interface SearchData {
   web?: Array<SearchResultWeb | Document>;
   news?: Array<SearchResultNews | Document>;
   images?: Array<SearchResultImages | Document>;
-  developer?: Array<SearchResultWeb | Document>;
 }
 
 /**
@@ -751,8 +828,8 @@ export interface SearchData {
  *   ieee.org, sciencedirect.com, biorxiv.org, medrxiv.org, ...). It returns
  *   ordinary web page results from those domains, **not** paper records.
  * - `pdf` — restrict results to PDFs (adds `filetype:pdf`).
- * - `developer` — add developer results (issues, pull requests, READMEs and
- *   documentation) under `.developer`.
+ * - `developer` — developer-index results (issues, pull requests, READMEs and
+ *   documentation) served in `web`; cannot be combined with other categories.
  *
  * ⚠️ `categories: ["research"]` is **not** Firecrawl's research paper index.
  * To search papers themselves — ~43M abstracts, roughly 90% biomedical