Skip to content

Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. πŸ”₯

docs(sdks): mark the GitHub search method removed (#5536)

Kris Oeic06695408255
diff --git a/apps/dot-net-sdk/Firecrawl/Firecrawl.csproj b/apps/dot-net-sdk/Firecrawl/Firecrawl.csproj
index c1c1ad2f2..a72366b1e 100644
--- a/apps/dot-net-sdk/Firecrawl/Firecrawl.csproj
+++ b/apps/dot-net-sdk/Firecrawl/Firecrawl.csproj
@@ -8,7 +8,7 @@
<!-- NuGet package metadata -->
<PackageId>firecrawl-sdk</PackageId>
- <Version>1.15.1</Version>
+ <Version>1.15.2</Version>
<Authors>Firecrawl</Authors>
<Company>Firecrawl</Company>
<Description>.NET SDK for Firecrawl, the context API for AI agents: search, scrape, parse, crawl, and map the web, and run Monitor jobs.</Description>
diff --git a/apps/dot-net-sdk/Firecrawl/FirecrawlClient.cs b/apps/dot-net-sdk/Firecrawl/FirecrawlClient.cs
index 9215e3080..b4cb4865c 100644
--- a/apps/dot-net-sdk/Firecrawl/FirecrawlClient.cs
+++ b/apps/dot-net-sdk/Firecrawl/FirecrawlClient.cs
@@ -626,7 +626,7 @@ public class FirecrawlClient
/// <summary>
/// Searches GitHub research content.
/// </summary>
- [Obsolete("Stops responding after 2026-11-03. Use DeveloperSearchAsync, which does not carry over the score breakdown or the web fallback results.")]
+ [Obsolete("The research index GitHub search endpoint was removed after 2026-11-03. Use DeveloperSearchAsync instead.")]
public async Task<GitHubSearchResponse> SearchGitHubAsync(
string query,
SearchGitHubOptions? options = null,
@@ -921,7 +921,7 @@ public class FirecrawlClient
// INTERNAL UTILITIES
// ================================================================
- private const string SdkOrigin = "[email protected]";
+ private const string SdkOrigin = "[email protected]";
private static Dictionary<string, object> BuildBody(object? options)
{
diff --git a/apps/dot-net-sdk/README.md b/apps/dot-net-sdk/README.md
index 25f34bd1a..2a97309a0 100644
--- a/apps/dot-net-sdk/README.md
+++ b/apps/dot-net-sdk/README.md
@@ -307,7 +307,7 @@ var results = await client.SearchAsync("firecrawl web scraping",
### Developer Search
-Search public repositories, GitHub issues, merged pull requests, READMEs and code documentation. `DeveloperSearchAsync` replaces the deprecated `SearchGitHubAsync`.
+Search public repositories, GitHub issues, merged pull requests, READMEs and code documentation. It replaces the research index GitHub search, which was removed after 2026-11-03.
```csharp
var response = await client.DeveloperSearchAsync("retry an http request with exponential backoff",
diff --git a/apps/elixir-sdk/README.md b/apps/elixir-sdk/README.md
index 88fe380e5..809b9708b 100644
--- a/apps/elixir-sdk/README.md
+++ b/apps/elixir-sdk/README.md
@@ -80,7 +80,8 @@ All params are passed as keyword lists with snake_case keys. Invalid keys, missi
{:ok, response} = Firecrawl.search_and_scrape(query: "firecrawl web scraping")
# Search the developer index: public repositories, GitHub issues, merged pull
-# requests, READMEs and code documentation. Replaces the deprecated search_github.
+# requests, READMEs and code documentation. It replaces the research index GitHub
+# search, which was removed after 2026-11-03.
{:ok, %Firecrawl.DeveloperSearch{results: results}} = Firecrawl.search_developer(
query: "retry an http request with exponential backoff",
repos: ["square/okhttp"],
diff --git a/apps/elixir-sdk/lib/firecrawl.ex b/apps/elixir-sdk/lib/firecrawl.ex
index 3b481f3e3..477cebafd 100644
--- a/apps/elixir-sdk/lib/firecrawl.ex
+++ b/apps/elixir-sdk/lib/firecrawl.ex
@@ -378,10 +378,10 @@ defmodule Firecrawl do
`GET /search/research/github`
- Deprecated: stops responding after 2026-11-03. Use `search_developer/2`, which
- does not carry over the score breakdown or the web fallback results.
+ Deprecated: the research index GitHub search endpoint was removed after
+ 2026-11-03. Use `search_developer/2` instead.
"""
- @deprecated "Use search_developer/2; the endpoint stops responding after 2026-11-03"
+ @deprecated "The research index GitHub search endpoint was removed after 2026-11-03. Use search_developer/2 instead."
@spec search_github(keyword(), keyword()) :: response()
def search_github(params \\ [], opts \\ []) do
with {:ok, params} <- NimbleOptions.validate(params, @research_search_github_schema) do
@@ -392,9 +392,10 @@ defmodule Firecrawl do
@doc """
Bang variant of `search_github`. Raises on error.
- Deprecated: use `search_developer!/2`.
+ Deprecated: the research index GitHub search endpoint was removed after
+ 2026-11-03. Use `search_developer!/2` instead.
"""
- @deprecated "Use search_developer!/2; the endpoint stops responding after 2026-11-03"
+ @deprecated "The research index GitHub search endpoint was removed after 2026-11-03. Use search_developer!/2 instead."
@spec search_github!(keyword(), keyword()) :: Req.Response.t()
def search_github!(params \\ [], opts \\ []) do
params = NimbleOptions.validate!(params, @research_search_github_schema)
@@ -422,7 +423,8 @@ defmodule Firecrawl do
@doc """
Search the developer index: public repositories, GitHub issues, merged pull
- requests, READMEs and code documentation. Replaces the deprecated `search_github/2`.
+ requests, READMEs and code documentation. Replaces `search_github/2`, whose
+ endpoint was removed after 2026-11-03.
`POST /search/developer`
diff --git a/apps/elixir-sdk/mix.exs b/apps/elixir-sdk/mix.exs
index ccbe5c12a..437ae1116 100644
--- a/apps/elixir-sdk/mix.exs
+++ b/apps/elixir-sdk/mix.exs
@@ -1,7 +1,7 @@
defmodule Firecrawl.MixProject do
use Mix.Project
- @version "1.12.6"
+ @version "1.12.7"
@source_url "https://github.com/firecrawl/firecrawl/tree/main/apps/elixir-sdk"
def project do
diff --git a/apps/go-sdk/README.md b/apps/go-sdk/README.md
index 6a63669a3..055c4c097 100644
--- a/apps/go-sdk/README.md
+++ b/apps/go-sdk/README.md
@@ -290,7 +290,7 @@ results, err := client.Search(ctx, "firecrawl web scraping", &firecrawl.SearchOp
### Developer Search
-Search public repositories, GitHub issues, merged pull requests, READMEs and code documentation. `DeveloperSearch` replaces the deprecated `SearchGitHub`.
+Search public repositories, GitHub issues, merged pull requests, READMEs and code documentation. It replaces the research index GitHub search, which was removed after 2026-11-03.
```go
resp, err := client.DeveloperSearch(ctx, "retry an http request with exponential backoff", &firecrawl.DeveloperSearchOptions{
diff --git a/apps/go-sdk/firecrawl.go b/apps/go-sdk/firecrawl.go
index 894b5d765..f998b96be 100644
--- a/apps/go-sdk/firecrawl.go
+++ b/apps/go-sdk/firecrawl.go
@@ -767,8 +767,8 @@ func (c *Client) RelatedPapers(ctx context.Context, paperID, intent string, opts
// SearchGitHub searches GitHub research content.
//
-// Deprecated: stops responding after 2026-11-03. Use DeveloperSearch, which
-// does not carry over the score breakdown or the web fallback results.
+// Deprecated: the research index GitHub search endpoint was removed after
+// 2026-11-03. Use DeveloperSearch instead.
func (c *Client) SearchGitHub(ctx context.Context, query string, opts *SearchGitHubOptions) (*GitHubSearchResponse, error) {
if query == "" {
return nil, &FirecrawlError{Message: "query is required"}
diff --git a/apps/go-sdk/version.go b/apps/go-sdk/version.go
index d69cf6db1..3ee5d3ab3 100644
--- a/apps/go-sdk/version.go
+++ b/apps/go-sdk/version.go
@@ -9,4 +9,4 @@ package firecrawl
// Bump this when preparing a new release. The publish-go-sdk GitHub workflow
// reads this value and creates the corresponding monorepo-prefixed tag on
// merge to main.
-const Version = "1.16.9"
+const Version = "1.16.10"
diff --git a/apps/java-sdk/README.md b/apps/java-sdk/README.md
index 66d5e2597..c0fa033ee 100644
--- a/apps/java-sdk/README.md
+++ b/apps/java-sdk/README.md
@@ -82,13 +82,13 @@ Before using the Java SDK, ensure you have the following installed:
### Gradle (Kotlin DSL)
```kotlin
-implementation("com.firecrawl:firecrawl-java:1.18.7")
+implementation("com.firecrawl:firecrawl-java:1.18.8")
```
### Gradle (Groovy)
```groovy
-implementation 'com.firecrawl:firecrawl-java:1.18.7'
+implementation 'com.firecrawl:firecrawl-java:1.18.8'
```
### Maven
@@ -97,7 +97,7 @@ implementation 'com.firecrawl:firecrawl-java:1.18.7'
<dependency>
<groupId>com.firecrawl</groupId>
<artifactId>firecrawl-java</artifactId>
- <version>1.18.7</version>
+ <version>1.18.8</version>
</dependency>
```
@@ -352,7 +352,7 @@ if (results.getWeb() != null) {
### Developer Search
-Search public repositories, GitHub issues, merged pull requests, READMEs and code documentation. `developerSearch` replaces the deprecated `searchGitHub`.
+Search public repositories, GitHub issues, merged pull requests, READMEs and code documentation. It replaces the research index GitHub search, which was removed after 2026-11-03.
```java
import com.firecrawl.models.ResearchModels;
@@ -478,14 +478,14 @@ gradle build
```bash
gradle jar
-# Output: build/libs/firecrawl-java-1.18.7.jar
+# Output: build/libs/firecrawl-java-1.18.8.jar
```
### Install Locally
```bash
gradle publishToMavenLocal
-# Now available as: com.firecrawl:firecrawl-java:1.18.7 in local Maven repository
+# Now available as: com.firecrawl:firecrawl-java:1.18.8 in local Maven repository
```
## Running Tests
diff --git a/apps/java-sdk/build.gradle.kts b/apps/java-sdk/build.gradle.kts
index 2b46f856a..e798d3a35 100644
--- a/apps/java-sdk/build.gradle.kts
+++ b/apps/java-sdk/build.gradle.kts
@@ -4,7 +4,7 @@ plugins {
}
group = "com.firecrawl"
-version = "1.18.7"
+version = "1.18.8"
java {
sourceCompatibility = JavaVersion.VERSION_11
diff --git a/apps/java-sdk/src/main/java/com/firecrawl/client/FirecrawlClient.java b/apps/java-sdk/src/main/java/com/firecrawl/client/FirecrawlClient.java
index bf591ec89..49c324652 100644
--- a/apps/java-sdk/src/main/java/com/firecrawl/client/FirecrawlClient.java
+++ b/apps/java-sdk/src/main/java/com/firecrawl/client/FirecrawlClient.java
@@ -37,7 +37,7 @@ import java.util.concurrent.ForkJoinPool;
public class FirecrawlClient {
private static final String DEFAULT_API_URL = "https://api.firecrawl.dev";
- private static final String SDK_ORIGIN = "[email protected]";
+ private static final String SDK_ORIGIN = "[email protected]";
private static final long DEFAULT_TIMEOUT_MS = 300_000; // 5 minutes
private static final int DEFAULT_MAX_RETRIES = 3;
private static final double DEFAULT_BACKOFF_FACTOR = 0.5;
@@ -648,9 +648,8 @@ public class FirecrawlClient {
}
/**
- * @deprecated Stops responding after 2026-11-03. Use {@link #developerSearch},
- * which does not carry over the score breakdown or the web
- * fallback results.
+ * @deprecated The research index GitHub search endpoint was removed after
+ * 2026-11-03. Use {@link #developerSearch} instead.
*/
@Deprecated
public ResearchModels.GitHubSearchResponse searchGitHub(String query) {
@@ -658,9 +657,8 @@ public class FirecrawlClient {
}
/**
- * @deprecated Stops responding after 2026-11-03. Use {@link #developerSearch},
- * which does not carry over the score breakdown or the web
- * fallback results.
+ * @deprecated The research index GitHub search endpoint was removed after
+ * 2026-11-03. Use {@link #developerSearch} instead.
*/
@Deprecated
public ResearchModels.GitHubSearchResponse searchGitHub(String query, ResearchModels.SearchGitHubOptions options) {
@@ -1170,9 +1168,8 @@ public class FirecrawlClient {
}
/**
- * @deprecated Stops responding after 2026-11-03. Use {@link #developerSearch},
- * which does not carry over the score breakdown or the web
- * fallback results.
+ * @deprecated The research index GitHub search endpoint was removed after
+ * 2026-11-03. Use {@link #developerSearchAsync} instead.
*/
@Deprecated
public CompletableFuture<ResearchModels.GitHubSearchResponse> searchGitHubAsync(String query, ResearchModels.SearchGitHubOptions options) {
diff --git a/apps/java-sdk/src/main/java/com/firecrawl/models/SearchOptions.java b/apps/java-sdk/src/main/java/com/firecrawl/models/SearchOptions.java
index 585203b8b..d91e4b805 100644
--- a/apps/java-sdk/src/main/java/com/firecrawl/models/SearchOptions.java
+++ b/apps/java-sdk/src/main/java/com/firecrawl/models/SearchOptions.java
@@ -60,7 +60,7 @@ public class SearchOptions {
/** Source types: "web", "news", "images" as strings or {type: "web"} maps. */
public Builder sources(List<Object> sources) { this.sources = sources; return this; }
- /** Categories: "github", "research", "pdf". */
+ /** Categories: "research", "pdf", "developer", "gov". The "github" category was removed; use "developer" instead. */
public Builder categories(List<Object> categories) { this.categories = categories; return this; }
/** Domains to include in search results. */
public Builder includeDomains(List<String> includeDomains) { this.includeDomains = includeDomains; return this; }
diff --git a/apps/js-sdk/firecrawl/README.md b/apps/js-sdk/firecrawl/README.md
index 625aa8b75..581fc4747 100644
--- a/apps/js-sdk/firecrawl/README.md
+++ b/apps/js-sdk/firecrawl/README.md
@@ -218,6 +218,10 @@ const results = await app.search('nanopore basecalling accuracy', {
### Developer search
+Search public repositories, GitHub issues, merged pull requests, READMEs and
+code documentation. It replaces the research index GitHub search, which was
+removed after 2026-11-03.
+
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
@@ -313,14 +317,6 @@ const related = await app.research.similarPapers('pmid:<id>', {
});
```
-> **`app.research.searchGithub` is deprecated.** The research index GitHub
-> endpoint stops responding after 2026-11-03. Use `app.developerSearch`
-> instead: it searches GitHub issues, pull requests and readmes plus curated
-> documentation sources, returns matched passages, and adds filters for repo,
-> language, license and stars. It does not carry over the `scores` breakdown
-> or the `resultType: "web"` fallback results. See
-> [the developer index docs](https://docs.firecrawl.dev/features/developer).
-
### Scrape-bound interactive browsing (v2)
Use a scrape job ID to keep interacting with the replayed browser context:
diff --git a/apps/js-sdk/firecrawl/package.json b/apps/js-sdk/firecrawl/package.json
index 2d1be2b02..d1102ced6 100644
--- a/apps/js-sdk/firecrawl/package.json
+++ b/apps/js-sdk/firecrawl/package.json
@@ -1,6 +1,6 @@
{
"name": "@mendable/firecrawl-js",
- "version": "4.51.0",
+ "version": "4.51.1",
"description": "JavaScript SDK for Firecrawl, the context API for AI agents: search, scrape, parse, crawl, map, and interact with the web, run Agent and Monitor jobs, and search scientific papers (PubMed, bioRxiv, medRxiv, arXiv)",
"main": "dist/index.js",
"types": "dist/index.d.ts",
diff --git a/apps/js-sdk/firecrawl/src/v2/client.ts b/apps/js-sdk/firecrawl/src/v2/client.ts
index 0038d5eb4..af9f19003 100644
--- a/apps/js-sdk/firecrawl/src/v2/client.ts
+++ b/apps/js-sdk/firecrawl/src/v2/client.ts
@@ -353,10 +353,10 @@ export class FirecrawlClient {
// Research
/**
* Access the v2 research endpoints β€” Firecrawl's **research paper index**
- * (~43M paper abstracts) plus GitHub history/readmes.
+ * (~43M paper abstracts).
*
- * `research.searchGithub()` is deprecated and stops responding after
- * 2026-11-03. Use `developerSearch()` instead.
+ * The research index GitHub search behind `research.searchGithub()` was
+ * removed after 2026-11-03. Use `developerSearch()` instead.
*
* The paper corpus is roughly 90% biomedical and life sciences β€” PubMed,
* bioRxiv and medRxiv β€” with arXiv covering physics, mathematics and
diff --git a/apps/js-sdk/firecrawl/src/v2/methods/research.ts b/apps/js-sdk/firecrawl/src/v2/methods/research.ts
index 270336bb2..7284b9d7e 100644
--- a/apps/js-sdk/firecrawl/src/v2/methods/research.ts
+++ b/apps/js-sdk/firecrawl/src/v2/methods/research.ts
@@ -67,7 +67,7 @@ function normalizeResearchError(err: any, action: string): never {
/**
* Client for the v2 research endpoints β€” Firecrawl's **research paper index**
- * (~43M paper abstracts) plus GitHub history/readmes.
+ * (~43M paper abstracts).
*
* The paper corpus is roughly 90% biomedical and life sciences β€” PubMed,
* bioRxiv and medRxiv β€” with arXiv covering physics, mathematics and computer
@@ -217,12 +217,8 @@ export class ResearchClient {
* Search the research index GitHub slice: issue/PR history and repository
* readmes.
*
- * @deprecated Use `developerSearch()` on the client instead. This
- * endpoint stops responding after 2026-11-03. The developer index searches
- * GitHub issues, pull requests and readmes plus curated documentation
- * sources, returns matched passages, and adds filters for repo, language,
- * license and stars. It does not carry over the `scores` breakdown or the
- * `resultType: "web"` fallback results. See
+ * @deprecated The research index GitHub search endpoint was removed after
+ * 2026-11-03. Use `developerSearch()` on the client instead. See
* https://docs.firecrawl.dev/features/developer.
* @param query Search query.
* @param options Optional `k`.
diff --git a/apps/js-sdk/firecrawl/src/v2/types.ts b/apps/js-sdk/firecrawl/src/v2/types.ts
index 4c4675284..ef9f3f09d 100644
--- a/apps/js-sdk/firecrawl/src/v2/types.ts
+++ b/apps/js-sdk/firecrawl/src/v2/types.ts
@@ -1023,7 +1023,8 @@ export interface AlexandriaOptions {
* Narrows ordinary **web search**. A category does not switch `search()` to a
* different index.
*
- * - `github` β€” restrict web results to github.com (a `site:` filter).
+ * - `github` β€” removed. Use `developer` for GitHub issues, pull requests and
+ * READMEs.
* - `research` β€” restrict web results to a fixed list of ~14 academic
* *websites* (arxiv.org, pubmed.ncbi.nlm.nih.gov, nature.com, science.org,
* ieee.org, sciencedirect.com, biorxiv.org, medrxiv.org, ...). It returns
@@ -2327,11 +2328,10 @@ export interface SimilarPapersResponse {
}
/**
- * Component scores; each field is present only when that signal contributed.
+ * Component scores.
*
- * @deprecated Use the developer index instead. The research index GitHub
- * search stops responding after 2026-11-03. The developer index does not
- * expose a score breakdown. See
+ * @deprecated The research index GitHub search endpoint was removed after
+ * 2026-11-03. Use `developerSearch()` instead. See
* https://docs.firecrawl.dev/features/developer.
*/
export interface GitHubScoreBreakdown {
@@ -2343,8 +2343,8 @@ export interface GitHubScoreBreakdown {
}
/**
- * @deprecated Use the developer index instead. The research index GitHub
- * search stops responding after 2026-11-03. See
+ * @deprecated The research index GitHub search endpoint was removed after
+ * 2026-11-03. Use `developerSearch()` instead. See
* https://docs.firecrawl.dev/features/developer.
*/
export interface GitHubSearchItem {
@@ -2370,8 +2370,8 @@ export interface GitHubSearchItem {
}
/**
- * @deprecated Use the developer index instead. The research index GitHub
- * search stops responding after 2026-11-03. See
+ * @deprecated The research index GitHub search endpoint was removed after
+ * 2026-11-03. Use `developerSearch()` instead. See
* https://docs.firecrawl.dev/features/developer.
*/
export interface GitHubSearchResponse {
@@ -2422,8 +2422,8 @@ export interface SimilarPapersOptions {
/**
* Options for `research.searchGithub`.
*
- * @deprecated Use the developer index instead. The research index GitHub
- * search stops responding after 2026-11-03. See
+ * @deprecated The research index GitHub search endpoint was removed after
+ * 2026-11-03. Use `developerSearch()` instead. See
* https://docs.firecrawl.dev/features/developer.
*/
export interface SearchGithubOptions {
diff --git a/apps/php-sdk/CHANGELOG.md b/apps/php-sdk/CHANGELOG.md
index f63bda829..ae934c8dd 100644
--- a/apps/php-sdk/CHANGELOG.md
+++ b/apps/php-sdk/CHANGELOG.md
@@ -5,6 +5,13 @@ All notable changes to the Firecrawl PHP SDK will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [1.16.7] - 2026-11-04
+
+### Changed
+- `searchGithub()`: the research index GitHub search endpoint it calls was
+ removed after 2026-11-03. Use `developerSearch()` instead. The method
+ remains in the SDK until the next major release.
+
## [1.16.6] - 2026-10-20
### Added
diff --git a/apps/php-sdk/README.md b/apps/php-sdk/README.md
index f8427edb5..1a92de80d 100644
--- a/apps/php-sdk/README.md
+++ b/apps/php-sdk/README.md
@@ -243,7 +243,7 @@ foreach ($result->getWeb() as $item) {
### Developer search
-Search public repositories, GitHub issues, merged pull requests, READMEs and code documentation. `developerSearch` replaces the deprecated `searchGithub`.
+Search public repositories, GitHub issues, merged pull requests, READMEs and code documentation. It replaces the research index GitHub search, which was removed after 2026-11-03.
```php
use Firecrawl\Models\DeveloperSearchOptions;
diff --git a/apps/php-sdk/src/Client/FirecrawlClient.php b/apps/php-sdk/src/Client/FirecrawlClient.php
index 8121cc72f..a511ab4de 100644
--- a/apps/php-sdk/src/Client/FirecrawlClient.php
+++ b/apps/php-sdk/src/Client/FirecrawlClient.php
@@ -184,9 +184,8 @@ final class FirecrawlClient
/**
* Search GitHub research content.
*
- * @deprecated Stops responding after 2026-11-03. Use {@see self::developerSearch()},
- * which does not carry over the score breakdown or the web fallback
- * results.
+ * @deprecated The research index GitHub search endpoint was removed after
+ * 2026-11-03. Use {@see self::developerSearch()} instead.
* @param array<string, mixed> $options
* @return array<string, mixed>
*/
diff --git a/apps/php-sdk/src/Version.php b/apps/php-sdk/src/Version.php
index 4179761c8..508303383 100644
--- a/apps/php-sdk/src/Version.php
+++ b/apps/php-sdk/src/Version.php
@@ -6,5 +6,5 @@ namespace Firecrawl;
final class Version
{
- public const SDK_VERSION = '1.16.6';
+ public const SDK_VERSION = '1.16.7';
}
diff --git a/apps/python-sdk/README.md b/apps/python-sdk/README.md
index fc9cb82ea..e7d4aeed2 100644
--- a/apps/python-sdk/README.md
+++ b/apps/python-sdk/README.md
@@ -243,6 +243,10 @@ results = firecrawl.search("nanopore basecalling accuracy", categories=["researc
### Developer search
+Search public repositories, GitHub issues, merged pull requests, READMEs and
+code documentation. It replaces the research index GitHub search, which was
+removed after 2026-11-03.
+
Use `developer_search` for the dedicated developer index and its complete
filter and response contract. Generic `search(categories=["developer"])`
returns only the first passage as a description and does not accept these
@@ -336,14 +340,6 @@ related = firecrawl.related_papers(
)
```
-> **`search_github` is deprecated.** The research index GitHub endpoint stops
-> responding after 2026-11-03. Use `developer_search` instead: it searches
-> GitHub issues, pull requests and readmes plus curated documentation sources,
-> returns matched passages, and adds filters for repo, language, license and
-> stars. It does not carry over the `scores` breakdown or the
-> `resultType: "web"` fallback results. See
-> [the developer index docs](https://docs.firecrawl.dev/features/developer).
-
> **Response keys are camelCase.** Unlike the rest of the SDK, the research
> methods return the raw JSON body as a `dict` β€” they are not parsed into typed
> models and not normalized to snake_case. Expect `paperId`, `primaryId`,
diff --git a/apps/python-sdk/firecrawl/__init__.py b/apps/python-sdk/firecrawl/__init__.py
index a0bb9a0be..dea7075f6 100644
--- a/apps/python-sdk/firecrawl/__init__.py
+++ b/apps/python-sdk/firecrawl/__init__.py
@@ -42,7 +42,7 @@ from .v1 import (
V1ChangeTrackingOptions,
)
-__version__ = "4.54.0"
+__version__ = "4.54.1"
# Define the logger for the Firecrawl project
logger: logging.Logger = logging.getLogger("firecrawl")
diff --git a/apps/python-sdk/firecrawl/v2/methods/research_docs.py b/apps/python-sdk/firecrawl/v2/methods/research_docs.py
index 5d0d1c5fd..ca2c65b3c 100644
--- a/apps/python-sdk/firecrawl/v2/methods/research_docs.py
+++ b/apps/python-sdk/firecrawl/v2/methods/research_docs.py
@@ -56,13 +56,8 @@ _ASYNC_CLIENT_ARG = "client: Async HTTP client."
# ---------------------------------------------------------------------------
GITHUB_SEARCH_DEPRECATION_MSG = (
- "search_github() is deprecated and the research index GitHub endpoint "
- "stops responding after 2026-11-03. Use developer_search() instead: it "
- "searches GitHub issues, pull requests and READMEs plus curated "
- "documentation sources, returns matched passages, and adds filters for "
- "repo, language, license and stars. Response changes: 'snippet' becomes "
- "'passages', results gain an 'id', and there is no score breakdown and no "
- "web fallback result type. See "
+ "The research index GitHub search endpoint behind search_github() was "
+ "removed after 2026-11-03. Use developer_search() instead. See "
"https://docs.firecrawl.dev/features/developer."
)
@@ -185,30 +180,17 @@ Search the **research index** GitHub slice: GitHub issue/PR history and
repository readmes.
.. deprecated::
- Use ``developer_search()`` instead. This endpoint stops responding after
- 2026-11-03. The developer index searches GitHub issues, pull requests and
- readmes plus curated documentation sources, returns matched passages, and
- adds filters for repo, language, license and stars. It does **not** carry
- over the ``scores`` breakdown or the ``resultType: "web"`` fallback
- results. See https://docs.firecrawl.dev/features/developer.
-
-This is the code-and-discussion companion to ``search_papers`` and is served
-by the same ``/v2/search/research`` surface. It is a separate index from the
-developer index, it does **not** search the paper corpus, and it is not the
-same as ``search(categories=["github"])`` (which is a ``site:github.com``
-filter on ordinary web search).
+ The research index GitHub search endpoint was removed after 2026-11-03.
+ Use ``developer_search()`` instead. See
+ https://docs.firecrawl.dev/features/developer.
Args:
|CLIENT_ARG|
query: Natural-language query, e.g. ``"pysam VCF parsing memory leak"``.
k: Maximum number of results to return.
-Returns:
- Raw API ``dict`` with ``success`` and ``results``. Keys are camelCase and
- are **not** normalized to snake_case β€” expect ``resultType``, ``repo``,
- ``url``, ``pageType``, ``number`` and a ``scores`` object. The response
- also carries a ``warnings`` list and a ``replacement`` field while the
- deprecation is live.
+Raises:
+ FirecrawlError: Always. The API answers 410 Gone with the removal message.
"""
SEARCH_PAPERS_DOC = _SEARCH_PAPERS_TEMPLATE.replace(_CLIENT_ARG, _SYNC_CLIENT_ARG)
@@ -314,26 +296,16 @@ Search the **research index** GitHub slice: issue/PR history and repo
readmes.
.. deprecated::
- Use ``developer_search()`` instead. This endpoint stops responding
- after 2026-11-03. The developer index searches GitHub issues, pull
- requests and readmes plus curated documentation sources, and returns
- matched passages. It does **not** carry over the ``scores`` breakdown
- or the ``resultType: "web"`` fallback results. See
+ The research index GitHub search endpoint was removed after
+ 2026-11-03. Use ``developer_search()`` instead. See
https://docs.firecrawl.dev/features/developer.
-The code-and-discussion companion to ``search_papers``, served by the
-same ``/v2/search/research`` surface. A separate index from the developer
-index. It does not search the paper corpus, and it is not
-``search(categories=["github"])`` (which is just a ``site:github.com``
-filter on ordinary web search).
-
Args:
query: Natural-language query, e.g. ``"pysam VCF parsing memory leak"``.
**kwargs: ``k``.
-Returns:
- Raw API ``dict`` with ``success`` and ``results``. Keys are
- camelCase, **not** snake_case-normalized.
+Raises:
+ FirecrawlError: Always. The API answers 410 Gone with the removal message.
"""
CLIENT_SEARCH_PAPERS_DOC = _CLIENT_SEARCH_PAPERS_TEMPLATE.replace(_AWAIT, "")
diff --git a/apps/python-sdk/firecrawl/v2/types.py b/apps/python-sdk/firecrawl/v2/types.py
index 111f35cd1..33cb7d1fd 100644
--- a/apps/python-sdk/firecrawl/v2/types.py
+++ b/apps/python-sdk/firecrawl/v2/types.py
@@ -626,7 +626,6 @@ class Category(BaseModel):
`search()` to their own index.
Supported categories:
- - "github": Restrict web results to github.com (a `site:` filter)
- "research": Restrict web results to a fixed list of ~14 academic
*websites* (arxiv.org, pubmed.ncbi.nlm.nih.gov, nature.com, science.org,
ieee.org, sciencedirect.com, biorxiv.org, medrxiv.org, ...). This is a
@@ -638,6 +637,9 @@ class Category(BaseModel):
- "gov": Government Index results served in `web`; cannot be combined
with other categories
+ The "github" category is removed. Use "developer" for GitHub issues, pull
+ requests and READMEs.
+
.. warning::
``categories=["research"]`` is **not** Firecrawl's research paper index.
To search papers themselves β€” ~43M abstracts, about 90% biomedical
diff --git a/apps/ruby-sdk/README.md b/apps/ruby-sdk/README.md
index 2fc581284..1b1a3278c 100644
--- a/apps/ruby-sdk/README.md
+++ b/apps/ruby-sdk/README.md
@@ -195,7 +195,7 @@ results = client.search("latest news",
### Developer Search
-Search public repositories, GitHub issues, merged pull requests, READMEs and code documentation. `developer_search` replaces the deprecated `search_github`.
+Search public repositories, GitHub issues, merged pull requests, READMEs and code documentation. It replaces the research index GitHub search, which was removed after 2026-11-03.
```ruby
response = client.developer_search(
diff --git a/apps/ruby-sdk/lib/firecrawl/client.rb b/apps/ruby-sdk/lib/firecrawl/client.rb
index 526c8da89..9ece8bbd6 100644
--- a/apps/ruby-sdk/lib/firecrawl/client.rb
+++ b/apps/ruby-sdk/lib/firecrawl/client.rb
@@ -133,9 +133,8 @@ module Firecrawl
# Search GitHub research content.
#
- # @deprecated Stops responding after 2026-11-03. Use {#developer_search},
- # which does not carry over the score breakdown or the web fallback
- # results.
+ # @deprecated The research index GitHub search endpoint was removed after
+ # 2026-11-03. Use {#developer_search} instead.
# @param query_text [String] GitHub query
# @param options [Hash] optional query parameters
# @return [Hash]
diff --git a/apps/ruby-sdk/lib/firecrawl/version.rb b/apps/ruby-sdk/lib/firecrawl/version.rb
index 3ed25000b..77a5322fa 100644
--- a/apps/ruby-sdk/lib/firecrawl/version.rb
+++ b/apps/ruby-sdk/lib/firecrawl/version.rb
@@ -1,5 +1,5 @@
# frozen_string_literal: true
module Firecrawl
- VERSION = "1.17.7"
+ VERSION = "1.17.8"
end
diff --git a/apps/rust-sdk/CHANGELOG.md b/apps/rust-sdk/CHANGELOG.md
index c58462521..33ebf681f 100644
--- a/apps/rust-sdk/CHANGELOG.md
+++ b/apps/rust-sdk/CHANGELOG.md
@@ -1,5 +1,15 @@
## CHANGELOG
+## [2.21.9] - 2026-11-04
+
+### Changed
+
+- `Client::search_github`: the research index GitHub search endpoint it calls
+ was removed after 2026-11-03. Use `Client::developer_search` instead. The
+ method remains in the SDK until the next major release.
+- `SearchCategory::Github` is documented as removed. Use
+ `Client::developer_search` for GitHub issues, pull requests and READMEs.
+
## [2.21.8] - 2026-10-20
### Added
diff --git a/apps/rust-sdk/Cargo.lock b/apps/rust-sdk/Cargo.lock
index 01645b53d..fd284ab34 100644
--- a/apps/rust-sdk/Cargo.lock
+++ b/apps/rust-sdk/Cargo.lock
@@ -258,7 +258,7 @@ checksum = "37909eebbb50d72f9059c3b6d82c0463f2ff062c9e95845c43a6c9c0355411be"
[[package]]
name = "firecrawl"
-version = "2.21.8"
+version = "2.21.9"
dependencies = [
"mockito",
"reqwest",
diff --git a/apps/rust-sdk/Cargo.toml b/apps/rust-sdk/Cargo.toml
index 51e9eb7fd..873491fb0 100644
--- a/apps/rust-sdk/Cargo.toml
+++ b/apps/rust-sdk/Cargo.toml
@@ -1,6 +1,6 @@
[package]
name = "firecrawl"
-version = "2.21.8"
+version = "2.21.9"
edition = "2021"
license = "MIT"
homepage = "https://www.firecrawl.dev/"
diff --git a/apps/rust-sdk/README.md b/apps/rust-sdk/README.md
index 333aaf0ec..ce02d1433 100644
--- a/apps/rust-sdk/README.md
+++ b/apps/rust-sdk/README.md
@@ -236,7 +236,7 @@ match map_result {
### Developer search
-Search public repositories, GitHub issues, merged pull requests, READMEs and code documentation. `developer_search` replaces the deprecated `search_github`.
+Search public repositories, GitHub issues, merged pull requests, READMEs and code documentation. It replaces the research index GitHub search, which was removed after 2026-11-03.
```rust
use firecrawl::{Client, DeveloperSearchOptions};
diff --git a/apps/rust-sdk/src/research.rs b/apps/rust-sdk/src/research.rs
index a989a87a9..f0cb6be0b 100644
--- a/apps/rust-sdk/src/research.rs
+++ b/apps/rust-sdk/src/research.rs
@@ -409,8 +409,11 @@ impl Client {
/// Search the research index GitHub slice.
///
- /// Stops responding after 2026-11-03. Use [`Client::developer_search`].
- #[deprecated(note = "Use Client::developer_search; sunset 2026-11-03")]
+ /// The research index GitHub search endpoint was removed after 2026-11-03.
+ /// Use [`Client::developer_search`] instead.
+ #[deprecated(
+ note = "The research index GitHub search endpoint was removed after 2026-11-03. Use Client::developer_search instead."
+ )]
pub async fn search_github(
&self,
query_text: impl AsRef<str>,
diff --git a/apps/rust-sdk/src/search.rs b/apps/rust-sdk/src/search.rs
index 829bd6f9e..8cad0396f 100644
--- a/apps/rust-sdk/src/search.rs
+++ b/apps/rust-sdk/src/search.rs
@@ -27,7 +27,8 @@ pub struct SearchOptions {
/// Discovery response detail; defaults to compact.
pub tool_detail: Option<crate::types::ToolDetail>,
- /// Categories to filter results (github, research, pdf).
+ /// Categories to filter results (research, pdf). `Github` was removed; use
+ /// `Client::developer_search` instead.
pub categories: Option<Vec<SearchCategory>>,
/// Domains to include in search results.
diff --git a/apps/rust-sdk/src/types.rs b/apps/rust-sdk/src/types.rs
index e6d1500bd..8595b71a3 100644
--- a/apps/rust-sdk/src/types.rs
+++ b/apps/rust-sdk/src/types.rs
@@ -1224,6 +1224,8 @@ pub enum SearchSource {
#[derive(Deserialize, Serialize, Clone, Copy, Debug, PartialEq, Eq)]
#[serde(rename_all = "lowercase")]
pub enum SearchCategory {
+ /// Removed. Use `Client::developer_search` for GitHub issues, pull requests
+ /// and READMEs.
Github,
Research,
Pdf,