# Java (/quickstarts/java)
Related: [Node.js](/quickstarts/nodejs.md), [Next.js](/quickstarts/nextjs.md), [Express](/quickstarts/express.md), [NestJS](/quickstarts/nestjs.md), [Fastify](/quickstarts/fastify.md), [Hono](/quickstarts/hono.md)
## Prerequisites [#prerequisites]
* Java 11+
* A Firecrawl API key — [get one free](https://www.firecrawl.dev/app/api-keys)
## Install the SDK [#install-the-sdk]
```kotlin
dependencies {
implementation("com.firecrawl:firecrawl-java:1.2.0")
}
```
```xml
com.firecrawl
firecrawl-java
1.2.0
```
## Search the web [#search-the-web]
```java
import com.firecrawl.client.FirecrawlClient;
import com.firecrawl.models.SearchData;
import com.firecrawl.models.SearchOptions;
public class Main {
public static void main(String[] args) {
FirecrawlClient client = FirecrawlClient.builder()
.apiKey("fc-YOUR-API-KEY")
.build();
SearchData results = client.search(
"firecrawl web scraping",
SearchOptions.builder().limit(5).build()
);
if (results.getWeb() != null) {
for (var result : results.getWeb()) {
System.out.println(result.get("title") + " - " + result.get("url"));
}
}
}
}
```
## Scrape a page [#scrape-a-page]
```java
import com.firecrawl.models.Document;
Document doc = client.scrape("https://example.com");
System.out.println(doc.getMarkdown());
```
```json
{
"markdown": "# Example Domain\n\nThis domain is for use in illustrative examples...",
"metadata": {
"title": "Example Domain",
"sourceURL": "https://example.com"
}
}
```
## Interact with a page [#interact-with-a-page]
Open a browser session, run Playwright code against it, and close it when done:
```java
import com.firecrawl.models.ScrapeOptions;
import com.firecrawl.models.BrowserExecuteResponse;
import java.util.List;
Document doc = client.scrape("https://www.amazon.com",
ScrapeOptions.builder().formats(List.of((Object) "markdown")).build());
String scrapeId = (String) doc.getMetadata().get("scrapeId");
BrowserExecuteResponse run = client.interact(scrapeId,
"const title = await page.title(); console.log(title);");
System.out.println(run.getStdout());
client.stopInteractiveBrowser(scrapeId);
```
## Environment variable [#environment-variable]
Instead of passing `apiKey` directly, set the `FIRECRAWL_API_KEY` environment variable:
```bash
export FIRECRAWL_API_KEY=fc-YOUR-API-KEY
```
```java
FirecrawlClient client = FirecrawlClient.fromEnv();
```
## Next steps [#next-steps]
Search the web and get full page content
All scrape options including formats, actions, and proxies
Click, fill forms, and extract dynamic content
Full SDK reference with crawl, map, batch scrape, and more