From 0811236d7376fcd805a5e3ea6246636b90c05fdf Mon Sep 17 00:00:00 2001 From: "firecrawl-spring[bot]" <254786068+firecrawl-spring[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 18:12:10 +0000 Subject: [PATCH 1/6] docs: add GET /v1/activity endpoint documentation Adds OpenAPI spec and docs pages for the new activity endpoint that lists recent API jobs with cursor-based pagination. Co-Authored-By: micahstairs --- api-reference/endpoint/activity.mdx | 18 ++++ api-reference/v1-endpoint/activity.mdx | 18 ++++ api-reference/v1-openapi.json | 134 +++++++++++++++++++++++++ api-reference/v2-openapi.json | 134 +++++++++++++++++++++++++ docs.json | 2 + 5 files changed, 306 insertions(+) create mode 100644 api-reference/endpoint/activity.mdx create mode 100644 api-reference/v1-endpoint/activity.mdx diff --git a/api-reference/endpoint/activity.mdx b/api-reference/endpoint/activity.mdx new file mode 100644 index 00000000..4216a793 --- /dev/null +++ b/api-reference/endpoint/activity.mdx @@ -0,0 +1,18 @@ +--- +title: 'Activity' +openapi: '/api-reference/v2-openapi.json GET /activity' +--- + +Lists your recent API activity from the last 24 hours. Use this to discover job IDs, then retrieve results with the corresponding GET endpoint. + +| Kind | Retrieval Endpoint | +|---|---| +| `scrape` | `GET /v1/scrape/{id}` | +| `crawl` | `GET /v1/crawl/{id}` | +| `batch_scrape` | `GET /v1/batch/scrape/{id}` | +| `search` | — | +| `map` | — | +| `extract` | `GET /v1/extract/{id}` | +| `llmstxt` | `GET /v1/llmstxt/{id}` | +| `deep_research` | `GET /v1/deep-research/{id}` | +| `agent` | `GET /v1/extract/{id}` | diff --git a/api-reference/v1-endpoint/activity.mdx b/api-reference/v1-endpoint/activity.mdx new file mode 100644 index 00000000..549d1df3 --- /dev/null +++ b/api-reference/v1-endpoint/activity.mdx @@ -0,0 +1,18 @@ +--- +title: 'Activity' +openapi: '/api-reference/v1-openapi.json GET /activity' +--- + +Lists your recent API activity from the last 24 hours. Use this to discover job IDs, then retrieve results with the corresponding GET endpoint. + +| Kind | Retrieval Endpoint | +|---|---| +| `scrape` | `GET /v1/scrape/{id}` | +| `crawl` | `GET /v1/crawl/{id}` | +| `batch_scrape` | `GET /v1/batch/scrape/{id}` | +| `search` | — | +| `map` | — | +| `extract` | `GET /v1/extract/{id}` | +| `llmstxt` | `GET /v1/llmstxt/{id}` | +| `deep_research` | `GET /v1/deep-research/{id}` | +| `agent` | `GET /v1/extract/{id}` | diff --git a/api-reference/v1-openapi.json b/api-reference/v1-openapi.json index 42cb947f..c1737745 100644 --- a/api-reference/v1-openapi.json +++ b/api-reference/v1-openapi.json @@ -2067,6 +2067,140 @@ } } }, + "/activity": { + "get": { + "summary": "List recent API activity", + "operationId": "getActivity", + "description": "Lists your team's recent API activity from the last 24 hours. Returns metadata about each job including the job ID, which can be used with the corresponding GET endpoint (e.g. GET /v1/crawl/{id}) to retrieve full results. Supports cursor-based pagination and filtering by job kind.", + "tags": ["Account"], + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "kind", + "in": "query", + "required": false, + "schema": { + "type": "string", + "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent"] + }, + "description": "Filter by job kind" + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 50, + "minimum": 1, + "maximum": 100 + }, + "description": "Maximum number of results per page" + }, + { + "name": "next_cursor", + "in": "query", + "required": false, + "schema": { + "type": "string" + }, + "description": "Cursor for pagination. Use the next_cursor value from the previous response." + } + ], + "responses": { + "200": { + "description": "Successful response", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "success": { + "type": "boolean", + "example": true + }, + "data": { + "type": "array", + "items": { + "type": "object", + "properties": { + "id": { + "type": "string", + "description": "The job ID. Use this with the corresponding GET endpoint to retrieve results." + }, + "kind": { + "type": "string", + "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent"], + "description": "The type of job" + }, + "api_version": { + "type": "string", + "description": "The API version used for this request", + "example": "v1" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "When the job was created" + }, + "target": { + "type": "string", + "nullable": true, + "description": "The URL or query that was submitted" + }, + "origin": { + "type": "string", + "nullable": true, + "description": "Where the request originated from (e.g. api, website)" + }, + "integration": { + "type": "string", + "nullable": true, + "description": "The integration used (e.g. langchain, llamaindex)" + } + } + } + }, + "next_cursor": { + "type": "string", + "nullable": true, + "description": "Cursor to use for the next page. Null if there are no more results." + }, + "has_more": { + "type": "boolean", + "description": "Whether there are more results available" + } + } + } + } + } + }, + "403": { + "description": "Zero data retention enabled", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "success": { + "type": "boolean", + "example": false + }, + "error": { + "type": "string" + } + } + } + } + } + } + } + } + }, "/search": { "post": { "summary": "Search and optionally scrape search results", diff --git a/api-reference/v2-openapi.json b/api-reference/v2-openapi.json index fde5f7ed..2327d0d9 100644 --- a/api-reference/v2-openapi.json +++ b/api-reference/v2-openapi.json @@ -2187,6 +2187,140 @@ } } }, + "/activity": { + "get": { + "summary": "List recent API activity", + "operationId": "getActivity", + "description": "Lists your team's recent API activity from the last 24 hours. Returns metadata about each job including the job ID, which can be used with the corresponding GET endpoint (e.g. GET /crawl/{id}) to retrieve full results. Supports cursor-based pagination and filtering by job kind.", + "tags": ["Account"], + "security": [ + { + "bearerAuth": [] + } + ], + "parameters": [ + { + "name": "kind", + "in": "query", + "required": false, + "schema": { + "type": "string", + "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent"] + }, + "description": "Filter by job kind" + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "default": 50, + "minimum": 1, + "maximum": 100 + }, + "description": "Maximum number of results per page" + }, + { + "name": "next_cursor", + "in": "query", + "required": false, + "schema": { + "type": "string" + }, + "description": "Cursor for pagination. Use the next_cursor value from the previous response." + } + ], + "responses": { + "200": { + "description": "Successful response", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "success": { + "type": "boolean", + "example": true + }, + "data": { + "type": "array", + "items": { + "type": "object", + "properties": { + "id": { + "type": "string", + "description": "The job ID. Use this with the corresponding GET endpoint to retrieve results." + }, + "kind": { + "type": "string", + "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent"], + "description": "The type of job" + }, + "api_version": { + "type": "string", + "description": "The API version used for this request", + "example": "v1" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "When the job was created" + }, + "target": { + "type": "string", + "nullable": true, + "description": "The URL or query that was submitted" + }, + "origin": { + "type": "string", + "nullable": true, + "description": "Where the request originated from (e.g. api, website)" + }, + "integration": { + "type": "string", + "nullable": true, + "description": "The integration used (e.g. langchain, llamaindex)" + } + } + } + }, + "next_cursor": { + "type": "string", + "nullable": true, + "description": "Cursor to use for the next page. Null if there are no more results." + }, + "has_more": { + "type": "boolean", + "description": "Whether there are more results available" + } + } + } + } + } + }, + "403": { + "description": "Zero data retention enabled", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "success": { + "type": "boolean", + "example": false + }, + "error": { + "type": "string" + } + } + } + } + } + } + } + } + }, "/search": { "post": { "summary": "Search and optionally scrape search results", diff --git a/docs.json b/docs.json index 5d2e89fd..705e383d 100755 --- a/docs.json +++ b/docs.json @@ -292,6 +292,7 @@ { "group": "Account Endpoints", "pages": [ + "api-reference/endpoint/activity", "api-reference/endpoint/credit-usage", "api-reference/endpoint/credit-usage-historical", "api-reference/endpoint/token-usage", @@ -493,6 +494,7 @@ { "group": "Account Endpoints", "pages": [ + "api-reference/v1-endpoint/activity", "api-reference/v1-endpoint/credit-usage", "api-reference/v1-endpoint/credit-usage-historical", "api-reference/v1-endpoint/token-usage", From 7180538bfa0b6cb2d971b6c27fe93d0c57712a44 Mon Sep 17 00:00:00 2001 From: "firecrawl-spring[bot]" <254786068+firecrawl-spring[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 18:41:31 +0000 Subject: [PATCH 2/6] fix: address activity endpoint review feedback - Rename query param from next_cursor to cursor - Remove 403 ZDR response from OpenAPI spec - Improve origin/integration field descriptions with real examples Co-Authored-By: micahstairs --- api-reference/v1-openapi.json | 25 +++---------------------- api-reference/v2-openapi.json | 25 +++---------------------- 2 files changed, 6 insertions(+), 44 deletions(-) diff --git a/api-reference/v1-openapi.json b/api-reference/v1-openapi.json index c1737745..82f4bf34 100644 --- a/api-reference/v1-openapi.json +++ b/api-reference/v1-openapi.json @@ -2102,7 +2102,7 @@ "description": "Maximum number of results per page" }, { - "name": "next_cursor", + "name": "cursor", "in": "query", "required": false, "schema": { @@ -2155,12 +2155,12 @@ "origin": { "type": "string", "nullable": true, - "description": "Where the request originated from (e.g. api, website)" + "description": "Where the request originated from (e.g. api, python-sdk@4.19.0, js-sdk@1.25.1, mcp-fastmcp)" }, "integration": { "type": "string", "nullable": true, - "description": "The integration used (e.g. langchain, llamaindex)" + "description": "The integration used (e.g. langchain, llamaindex, n8n, cli)" } } } @@ -2178,25 +2178,6 @@ } } } - }, - "403": { - "description": "Zero data retention enabled", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "success": { - "type": "boolean", - "example": false - }, - "error": { - "type": "string" - } - } - } - } - } } } } diff --git a/api-reference/v2-openapi.json b/api-reference/v2-openapi.json index 2327d0d9..ca483b37 100644 --- a/api-reference/v2-openapi.json +++ b/api-reference/v2-openapi.json @@ -2222,7 +2222,7 @@ "description": "Maximum number of results per page" }, { - "name": "next_cursor", + "name": "cursor", "in": "query", "required": false, "schema": { @@ -2275,12 +2275,12 @@ "origin": { "type": "string", "nullable": true, - "description": "Where the request originated from (e.g. api, website)" + "description": "Where the request originated from (e.g. api, python-sdk@4.19.0, js-sdk@1.25.1, mcp-fastmcp)" }, "integration": { "type": "string", "nullable": true, - "description": "The integration used (e.g. langchain, llamaindex)" + "description": "The integration used (e.g. langchain, llamaindex, n8n, cli)" } } } @@ -2298,25 +2298,6 @@ } } } - }, - "403": { - "description": "Zero data retention enabled", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "success": { - "type": "boolean", - "example": false - }, - "error": { - "type": "string" - } - } - } - } - } } } } From 722d508b7d08f5710fe5f777ea2048b2445dadce Mon Sep 17 00:00:00 2001 From: "firecrawl-spring[bot]" <254786068+firecrawl-spring[bot]@users.noreply.github.com> Date: Tue, 17 Mar 2026 15:33:01 +0000 Subject: [PATCH 3/6] docs: update activity endpoint - remove origin/integration, add browser kind - Remove origin and integration fields from OpenAPI response schema - Add browser to kind enum in both v1 and v2 OpenAPI specs - Add browser kind to retrieval table in docs pages Co-Authored-By: micahstairs --- api-reference/endpoint/activity.mdx | 1 + api-reference/v1-endpoint/activity.mdx | 1 + api-reference/v1-openapi.json | 14 ++------------ api-reference/v2-openapi.json | 14 ++------------ 4 files changed, 6 insertions(+), 24 deletions(-) diff --git a/api-reference/endpoint/activity.mdx b/api-reference/endpoint/activity.mdx index 4216a793..152b64bf 100644 --- a/api-reference/endpoint/activity.mdx +++ b/api-reference/endpoint/activity.mdx @@ -16,3 +16,4 @@ Lists your recent API activity from the last 24 hours. Use this to discover job | `llmstxt` | `GET /v1/llmstxt/{id}` | | `deep_research` | `GET /v1/deep-research/{id}` | | `agent` | `GET /v1/extract/{id}` | +| `browser` | — | diff --git a/api-reference/v1-endpoint/activity.mdx b/api-reference/v1-endpoint/activity.mdx index 549d1df3..22e5b435 100644 --- a/api-reference/v1-endpoint/activity.mdx +++ b/api-reference/v1-endpoint/activity.mdx @@ -16,3 +16,4 @@ Lists your recent API activity from the last 24 hours. Use this to discover job | `llmstxt` | `GET /v1/llmstxt/{id}` | | `deep_research` | `GET /v1/deep-research/{id}` | | `agent` | `GET /v1/extract/{id}` | +| `browser` | — | diff --git a/api-reference/v1-openapi.json b/api-reference/v1-openapi.json index 82f4bf34..3c5d7a73 100644 --- a/api-reference/v1-openapi.json +++ b/api-reference/v1-openapi.json @@ -2085,7 +2085,7 @@ "required": false, "schema": { "type": "string", - "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent"] + "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent", "browser"] }, "description": "Filter by job kind" }, @@ -2134,7 +2134,7 @@ }, "kind": { "type": "string", - "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent"], + "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent", "browser"], "description": "The type of job" }, "api_version": { @@ -2151,16 +2151,6 @@ "type": "string", "nullable": true, "description": "The URL or query that was submitted" - }, - "origin": { - "type": "string", - "nullable": true, - "description": "Where the request originated from (e.g. api, python-sdk@4.19.0, js-sdk@1.25.1, mcp-fastmcp)" - }, - "integration": { - "type": "string", - "nullable": true, - "description": "The integration used (e.g. langchain, llamaindex, n8n, cli)" } } } diff --git a/api-reference/v2-openapi.json b/api-reference/v2-openapi.json index ca483b37..02c08c41 100644 --- a/api-reference/v2-openapi.json +++ b/api-reference/v2-openapi.json @@ -2205,7 +2205,7 @@ "required": false, "schema": { "type": "string", - "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent"] + "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent", "browser"] }, "description": "Filter by job kind" }, @@ -2254,7 +2254,7 @@ }, "kind": { "type": "string", - "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent"], + "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent", "browser"], "description": "The type of job" }, "api_version": { @@ -2271,16 +2271,6 @@ "type": "string", "nullable": true, "description": "The URL or query that was submitted" - }, - "origin": { - "type": "string", - "nullable": true, - "description": "Where the request originated from (e.g. api, python-sdk@4.19.0, js-sdk@1.25.1, mcp-fastmcp)" - }, - "integration": { - "type": "string", - "nullable": true, - "description": "The integration used (e.g. langchain, llamaindex, n8n, cli)" } } } From 5366fb4f5a1faf35206a19912c63cb8ff0fa92ff Mon Sep 17 00:00:00 2001 From: "firecrawl-spring[bot]" <254786068+firecrawl-spring[bot]@users.noreply.github.com> Date: Wed, 18 Mar 2026 18:21:37 +0000 Subject: [PATCH 4/6] =?UTF-8?q?refactor(activity):=20rename=20kind?= =?UTF-8?q?=E2=86=92endpoint,=20fix=20cursor=20mismatch?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Rename `kind` query param and response field to `endpoint` - Rename `next_cursor` response field to `cursor` to match query param - Update descriptions accordingly Co-Authored-By: micahstairs --- api-reference/endpoint/activity.mdx | 2 +- api-reference/v1-endpoint/activity.mdx | 2 +- api-reference/v1-openapi.json | 14 +++++++------- api-reference/v2-openapi.json | 14 +++++++------- 4 files changed, 16 insertions(+), 16 deletions(-) diff --git a/api-reference/endpoint/activity.mdx b/api-reference/endpoint/activity.mdx index 152b64bf..ced02e56 100644 --- a/api-reference/endpoint/activity.mdx +++ b/api-reference/endpoint/activity.mdx @@ -5,7 +5,7 @@ openapi: '/api-reference/v2-openapi.json GET /activity' Lists your recent API activity from the last 24 hours. Use this to discover job IDs, then retrieve results with the corresponding GET endpoint. -| Kind | Retrieval Endpoint | +| Endpoint | Retrieval Endpoint | |---|---| | `scrape` | `GET /v1/scrape/{id}` | | `crawl` | `GET /v1/crawl/{id}` | diff --git a/api-reference/v1-endpoint/activity.mdx b/api-reference/v1-endpoint/activity.mdx index 22e5b435..408bee71 100644 --- a/api-reference/v1-endpoint/activity.mdx +++ b/api-reference/v1-endpoint/activity.mdx @@ -5,7 +5,7 @@ openapi: '/api-reference/v1-openapi.json GET /activity' Lists your recent API activity from the last 24 hours. Use this to discover job IDs, then retrieve results with the corresponding GET endpoint. -| Kind | Retrieval Endpoint | +| Endpoint | Retrieval Endpoint | |---|---| | `scrape` | `GET /v1/scrape/{id}` | | `crawl` | `GET /v1/crawl/{id}` | diff --git a/api-reference/v1-openapi.json b/api-reference/v1-openapi.json index 3c5d7a73..05d62626 100644 --- a/api-reference/v1-openapi.json +++ b/api-reference/v1-openapi.json @@ -2071,7 +2071,7 @@ "get": { "summary": "List recent API activity", "operationId": "getActivity", - "description": "Lists your team's recent API activity from the last 24 hours. Returns metadata about each job including the job ID, which can be used with the corresponding GET endpoint (e.g. GET /v1/crawl/{id}) to retrieve full results. Supports cursor-based pagination and filtering by job kind.", + "description": "Lists your team's recent API activity from the last 24 hours. Returns metadata about each job including the job ID, which can be used with the corresponding GET endpoint (e.g. GET /v1/crawl/{id}) to retrieve full results. Supports cursor-based pagination and filtering by endpoint.", "tags": ["Account"], "security": [ { @@ -2080,14 +2080,14 @@ ], "parameters": [ { - "name": "kind", + "name": "endpoint", "in": "query", "required": false, "schema": { "type": "string", "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent", "browser"] }, - "description": "Filter by job kind" + "description": "Filter by endpoint" }, { "name": "limit", @@ -2108,7 +2108,7 @@ "schema": { "type": "string" }, - "description": "Cursor for pagination. Use the next_cursor value from the previous response." + "description": "Cursor for pagination. Use the cursor value from the previous response." } ], "responses": { @@ -2132,10 +2132,10 @@ "type": "string", "description": "The job ID. Use this with the corresponding GET endpoint to retrieve results." }, - "kind": { + "endpoint": { "type": "string", "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent", "browser"], - "description": "The type of job" + "description": "The endpoint used for this job" }, "api_version": { "type": "string", @@ -2155,7 +2155,7 @@ } } }, - "next_cursor": { + "cursor": { "type": "string", "nullable": true, "description": "Cursor to use for the next page. Null if there are no more results." diff --git a/api-reference/v2-openapi.json b/api-reference/v2-openapi.json index 02c08c41..2c822967 100644 --- a/api-reference/v2-openapi.json +++ b/api-reference/v2-openapi.json @@ -2191,7 +2191,7 @@ "get": { "summary": "List recent API activity", "operationId": "getActivity", - "description": "Lists your team's recent API activity from the last 24 hours. Returns metadata about each job including the job ID, which can be used with the corresponding GET endpoint (e.g. GET /crawl/{id}) to retrieve full results. Supports cursor-based pagination and filtering by job kind.", + "description": "Lists your team's recent API activity from the last 24 hours. Returns metadata about each job including the job ID, which can be used with the corresponding GET endpoint (e.g. GET /crawl/{id}) to retrieve full results. Supports cursor-based pagination and filtering by endpoint.", "tags": ["Account"], "security": [ { @@ -2200,14 +2200,14 @@ ], "parameters": [ { - "name": "kind", + "name": "endpoint", "in": "query", "required": false, "schema": { "type": "string", "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent", "browser"] }, - "description": "Filter by job kind" + "description": "Filter by endpoint" }, { "name": "limit", @@ -2228,7 +2228,7 @@ "schema": { "type": "string" }, - "description": "Cursor for pagination. Use the next_cursor value from the previous response." + "description": "Cursor for pagination. Use the cursor value from the previous response." } ], "responses": { @@ -2252,10 +2252,10 @@ "type": "string", "description": "The job ID. Use this with the corresponding GET endpoint to retrieve results." }, - "kind": { + "endpoint": { "type": "string", "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent", "browser"], - "description": "The type of job" + "description": "The endpoint used for this job" }, "api_version": { "type": "string", @@ -2275,7 +2275,7 @@ } } }, - "next_cursor": { + "cursor": { "type": "string", "nullable": true, "description": "Cursor to use for the next page. Null if there are no more results." From 3260ab9b713f98f22558cd017b7ba769cf6612cb Mon Sep 17 00:00:00 2001 From: "firecrawl-spring[bot]" <254786068+firecrawl-spring[bot]@users.noreply.github.com> Date: Mon, 23 Mar 2026 17:51:51 +0000 Subject: [PATCH 5/6] fix(docs): trim activity endpoint list and fix v2 retrieval paths - Remove search, extract, llmstxt, deep_research, map, and browser from activity endpoint tables and OpenAPI enum lists - Fix v2 activity.mdx to reference /v2 retrieval endpoints instead of /v1 Co-Authored-By: micahstairs --- api-reference/endpoint/activity.mdx | 14 ++++---------- api-reference/v1-endpoint/activity.mdx | 6 ------ api-reference/v1-openapi.json | 4 ++-- api-reference/v2-openapi.json | 4 ++-- 4 files changed, 8 insertions(+), 20 deletions(-) diff --git a/api-reference/endpoint/activity.mdx b/api-reference/endpoint/activity.mdx index ced02e56..268c6e6f 100644 --- a/api-reference/endpoint/activity.mdx +++ b/api-reference/endpoint/activity.mdx @@ -7,13 +7,7 @@ Lists your recent API activity from the last 24 hours. Use this to discover job | Endpoint | Retrieval Endpoint | |---|---| -| `scrape` | `GET /v1/scrape/{id}` | -| `crawl` | `GET /v1/crawl/{id}` | -| `batch_scrape` | `GET /v1/batch/scrape/{id}` | -| `search` | — | -| `map` | — | -| `extract` | `GET /v1/extract/{id}` | -| `llmstxt` | `GET /v1/llmstxt/{id}` | -| `deep_research` | `GET /v1/deep-research/{id}` | -| `agent` | `GET /v1/extract/{id}` | -| `browser` | — | +| `scrape` | `GET /v2/scrape/{id}` | +| `crawl` | `GET /v2/crawl/{id}` | +| `batch_scrape` | `GET /v2/batch/scrape/{id}` | +| `agent` | `GET /v2/extract/{id}` | diff --git a/api-reference/v1-endpoint/activity.mdx b/api-reference/v1-endpoint/activity.mdx index 408bee71..43e8c263 100644 --- a/api-reference/v1-endpoint/activity.mdx +++ b/api-reference/v1-endpoint/activity.mdx @@ -10,10 +10,4 @@ Lists your recent API activity from the last 24 hours. Use this to discover job | `scrape` | `GET /v1/scrape/{id}` | | `crawl` | `GET /v1/crawl/{id}` | | `batch_scrape` | `GET /v1/batch/scrape/{id}` | -| `search` | — | -| `map` | — | -| `extract` | `GET /v1/extract/{id}` | -| `llmstxt` | `GET /v1/llmstxt/{id}` | -| `deep_research` | `GET /v1/deep-research/{id}` | | `agent` | `GET /v1/extract/{id}` | -| `browser` | — | diff --git a/api-reference/v1-openapi.json b/api-reference/v1-openapi.json index 05d62626..18825405 100644 --- a/api-reference/v1-openapi.json +++ b/api-reference/v1-openapi.json @@ -2085,7 +2085,7 @@ "required": false, "schema": { "type": "string", - "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent", "browser"] + "enum": ["scrape", "crawl", "batch_scrape", "agent"] }, "description": "Filter by endpoint" }, @@ -2134,7 +2134,7 @@ }, "endpoint": { "type": "string", - "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent", "browser"], + "enum": ["scrape", "crawl", "batch_scrape", "agent"], "description": "The endpoint used for this job" }, "api_version": { diff --git a/api-reference/v2-openapi.json b/api-reference/v2-openapi.json index 2c822967..6bf8a986 100644 --- a/api-reference/v2-openapi.json +++ b/api-reference/v2-openapi.json @@ -2205,7 +2205,7 @@ "required": false, "schema": { "type": "string", - "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent", "browser"] + "enum": ["scrape", "crawl", "batch_scrape", "agent"] }, "description": "Filter by endpoint" }, @@ -2254,7 +2254,7 @@ }, "endpoint": { "type": "string", - "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent", "browser"], + "enum": ["scrape", "crawl", "batch_scrape", "agent"], "description": "The endpoint used for this job" }, "api_version": { From 2d2fdff4a07d27acdb932dd57773c38db81bd69c Mon Sep 17 00:00:00 2001 From: "firecrawl-spring[bot]" <254786068+firecrawl-spring[bot]@users.noreply.github.com> Date: Mon, 23 Mar 2026 18:16:43 +0000 Subject: [PATCH 6/6] revert: restore full endpoint enum lists in OpenAPI specs The full endpoint list should remain in the OpenAPI enums; only the doc tables were trimmed. Co-Authored-By: micahstairs --- api-reference/v1-openapi.json | 4 ++-- api-reference/v2-openapi.json | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/api-reference/v1-openapi.json b/api-reference/v1-openapi.json index 18825405..05d62626 100644 --- a/api-reference/v1-openapi.json +++ b/api-reference/v1-openapi.json @@ -2085,7 +2085,7 @@ "required": false, "schema": { "type": "string", - "enum": ["scrape", "crawl", "batch_scrape", "agent"] + "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent", "browser"] }, "description": "Filter by endpoint" }, @@ -2134,7 +2134,7 @@ }, "endpoint": { "type": "string", - "enum": ["scrape", "crawl", "batch_scrape", "agent"], + "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent", "browser"], "description": "The endpoint used for this job" }, "api_version": { diff --git a/api-reference/v2-openapi.json b/api-reference/v2-openapi.json index 6bf8a986..2c822967 100644 --- a/api-reference/v2-openapi.json +++ b/api-reference/v2-openapi.json @@ -2205,7 +2205,7 @@ "required": false, "schema": { "type": "string", - "enum": ["scrape", "crawl", "batch_scrape", "agent"] + "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent", "browser"] }, "description": "Filter by endpoint" }, @@ -2254,7 +2254,7 @@ }, "endpoint": { "type": "string", - "enum": ["scrape", "crawl", "batch_scrape", "agent"], + "enum": ["scrape", "crawl", "batch_scrape", "search", "extract", "llmstxt", "deep_research", "map", "agent", "browser"], "description": "The endpoint used for this job" }, "api_version": {