docs: clarify v2 JSON extraction format and add real-world event example

features/llm-extract.mdx

@@ -14,7 +14,14 @@ import ExtractNoSchemaPython from "/snippets/v2/scrape/json/no-schema/python.mdx
 import ExtractNoSchemaNode from "/snippets/v2/scrape/json/no-schema/js.mdx";
 import ExtractNoSchemaCURL from "/snippets/v2/scrape/json/no-schema/curl.mdx";
 import ExtractNoSchemaOutput from "/snippets/v2/scrape/json/no-schema/output.mdx";
+import EventExampleCURL from "/snippets/v2/scrape/json/events-example/curl.mdx";
+import EventExamplePython from "/snippets/v2/scrape/json/events-example/python.mdx";
+import EventExampleNode from "/snippets/v2/scrape/json/events-example/js.mdx";
+import EventExampleOutput from "/snippets/v2/scrape/json/events-example/output.mdx";
 
+<Note>
+**v2 API Change:** JSON schema extraction is fully supported in v2, but the API format has changed. In v2, the schema is embedded directly inside the format object as `formats: [{type: "json", schema: {...}}]`. The v1 `jsonOptions` parameter no longer exists in v2.
+</Note>
 
 ## Scrape and extract structured data with Firecrawl
 
@@ -66,13 +73,31 @@ Output:
 
 <ExtractNoSchemaOutput />
 
+### Real-world example: Extracting company information
+
+Here's a comprehensive example extracting structured company information from a website:
+
+<CodeGroup>
+
+<EventExamplePython />
+<EventExampleNode />
+<EventExampleCURL />
+
+</CodeGroup>
+
+Output:
+
+<EventExampleOutput />
+
 ### JSON format options
 
-When using JSON mode, include an object in `formats`, for example:
+When using JSON mode in v2, include an object in `formats` with the schema embedded directly:
 
 `formats: [{ type: 'json', schema: { ... }, prompt: '...' }]`
 
 Parameters:
 
-- `schema`: JSON Schema describing the structured output you want.
+- `schema`: JSON Schema describing the structured output you want (required for schema-based extraction).
 - `prompt`: Optional prompt to guide extraction (also used for no-schema extraction).
+
+**Important:** Unlike v1, there is no separate `jsonOptions` parameter in v2. The schema must be included directly inside the format object in the `formats` array.

snippets/v2/scrape/json/base/curl.mdx

@@ -3,7 +3,7 @@ curl -X POST https://api.firecrawl.dev/v2/scrape \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer YOUR_API_KEY' \
     -d '{
-      "url": "https://docs.firecrawl.dev/",
+      "url": "https://firecrawl.dev",
       "formats": [ {
         "type": "json",
         "schema": {
@@ -31,4 +31,4 @@ curl -X POST https://api.firecrawl.dev/v2/scrape \
         }
       } ]
     }'
-```
+```

snippets/v2/scrape/json/base/js.mdx

@@ -14,7 +14,7 @@ const schema = z.object({
   is_in_yc: z.boolean()
 });
 
-const result = await app.scrape("https://docs.firecrawl.dev/", {
+const result = await app.scrape("https://firecrawl.dev", {
   formats: [{
     type: "json",
     schema: schema

snippets/v2/scrape/json/base/python.mdx

@@ -1,9 +1,10 @@
 ```python Python
 from firecrawl import Firecrawl
 from pydantic import BaseModel
+
 app = Firecrawl(api_key="fc-YOUR-API-KEY")
 
-class JsonSchema(BaseModel):
+class CompanyInfo(BaseModel):
     company_mission: str
     supports_sso: bool
     is_open_source: bool
@@ -13,11 +14,11 @@ result = app.scrape(
     'https://firecrawl.dev',
     formats=[{
       "type": "json",
-      "schema": JsonSchema
+      "schema": CompanyInfo.model_json_schema()
     }],
     only_main_content=False,
     timeout=120000
 )
 
 print(result)
-```
+```

snippets/v2/scrape/json/events-example/curl.mdx

@@ -0,0 +1,34 @@
+```bash cURL
+curl -X POST https://api.firecrawl.dev/v2/scrape \
+    -H 'Content-Type: application/json' \
+    -H 'Authorization: Bearer YOUR_API_KEY' \
+    -d '{
+      "url": "https://firecrawl.dev/",
+      "formats": [{
+        "type": "json",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "company_mission": {
+              "type": "string"
+            },
+            "supports_sso": {
+              "type": "boolean"
+            },
+            "is_open_source": {
+              "type": "boolean"
+            },
+            "is_in_yc": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "company_mission",
+            "supports_sso",
+            "is_open_source",
+            "is_in_yc"
+          ]
+        }
+      }]
+    }'
+```

snippets/v2/scrape/json/events-example/js.mdx

@@ -0,0 +1,24 @@
+```js Node
+import FirecrawlApp from "@mendable/firecrawl-js";
+import { z } from "zod";
+
+const app = new FirecrawlApp({
+  apiKey: "fc-YOUR_API_KEY"
+});
+
+const companyInfoSchema = z.object({
+  company_mission: z.string(),
+  supports_sso: z.boolean(),
+  is_open_source: z.boolean(),
+  is_in_yc: z.boolean()
+});
+
+const result = await app.scrape("https://firecrawl.dev/", {
+  formats: [{
+    type: "json",
+    schema: companyInfoSchema
+  }]
+});
+
+console.log(result);
+```

snippets/v2/scrape/json/events-example/output.mdx

@@ -0,0 +1,13 @@
+```json Output
+{
+  "success": true,
+  "data": {
+    "json": {
+      "company_mission": "Turn websites into LLM-ready data",
+      "supports_sso": true,
+      "is_open_source": true,
+      "is_in_yc": true
+    }
+  }
+}
+```

snippets/v2/scrape/json/events-example/python.mdx

@@ -0,0 +1,22 @@
+```python Python
+from firecrawl import Firecrawl
+from pydantic import BaseModel
+
+app = Firecrawl(api_key="fc-YOUR-API-KEY")
+
+class CompanyInfo(BaseModel):
+    company_mission: str
+    supports_sso: bool
+    is_open_source: bool
+    is_in_yc: bool
+
+result = app.scrape(
+    'https://firecrawl.dev/',
+    formats=[{
+        "type": "json",
+        "schema": CompanyInfo.model_json_schema()
+    }]
+)
+
+print(result)
+```

snippets/v2/scrape/json/no-schema/curl.mdx

@@ -3,10 +3,10 @@ curl -X POST https://api.firecrawl.dev/v2/scrape \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer YOUR_API_KEY' \
     -d '{
-      "url": "https://docs.firecrawl.dev/",
+      "url": "https://firecrawl.dev",
       "formats": [{
         "type": "json",
         "prompt": "Extract the company mission from the page."
       }]
     }'
-```
+```

snippets/v2/scrape/json/no-schema/js.mdx

@@ -5,7 +5,7 @@ const app = new FirecrawlApp({
   apiKey: "fc-YOUR_API_KEY"
 });
 
-const result = await app.scrape("https://docs.firecrawl.dev/", {
+const result = await app.scrape("https://firecrawl.dev", {
   formats: [{
     type: "json",
     prompt: "Extract the company mission from the page."