Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥
TypeScript aiai-agentsai-crawlerai-scrapingai-searchcrawlerdata-extractionhtml-to-markdownllmmarkdownscraperscrapingweb-crawlerweb-dataweb-data-extractionweb-scraperweb-scrapingweb-searchwebscraping
feat(api): add GET /v2/team/activity endpoint for listing recent jobs (#3160)
firecrawl-spring[bot]60af96396fb1
diff --git a/apps/api/src/controllers/v1/activity.ts b/apps/api/src/controllers/v1/activity.tsnew file mode 100644index 000000000..e57aa73f9--- /dev/null+++ b/apps/api/src/controllers/v1/activity.ts@@ -0,0 +1,121 @@+import { Response } from "express";+import { RequestWithAuth, ErrorResponse } from "./types";+import { supabase_rr_service } from "../../services/supabase";+import { logger as _logger } from "../../lib/logger";++const ACTIVITY_WINDOW_HOURS = 24;+const DEFAULT_LIMIT = 50;+const MAX_LIMIT = 100;++const VALID_ENDPOINTS = [+ "scrape",+ "crawl",+ "batch_scrape",+ "search",+ "extract",+ "llmstxt",+ "deep_research",+ "map",+ "agent",+ "browser",+ "interact",+] as const;++type ActivityEndpoint = (typeof VALID_ENDPOINTS)[number];++interface ActivityItem {+ id: string;+ endpoint: ActivityEndpoint;+ api_version: string;+ created_at: string;+ target: string | null;+}++interface ActivityResponse {+ success: true;+ data: ActivityItem[];+ cursor: string | null;+ has_more: boolean;+}++export async function activityController(+ req: RequestWithAuth,+ res: Response<ActivityResponse | ErrorResponse>,+) {+ const logger = _logger.child({+ module: "activity",+ method: "activityController",+ teamId: req.auth.team_id,+ });++ // Parse and validate query params+ const endpoint = req.query.endpoint as string | undefined;+ if (endpoint && !VALID_ENDPOINTS.includes(endpoint as ActivityEndpoint)) {+ return res.status(400).json({+ success: false,+ error: `Invalid endpoint filter. Must be one of: ${VALID_ENDPOINTS.join(", ")}`,+ });+ }++ let limit = parseInt(req.query.limit as string, 10);+ if (isNaN(limit) || limit < 1) {+ limit = DEFAULT_LIMIT;+ }+ limit = Math.min(limit, MAX_LIMIT);++ const cursor = req.query.cursor as string | undefined;++ // Build query+ const windowStart = new Date(+ Date.now() - ACTIVITY_WINDOW_HOURS * 60 * 60 * 1000,+ ).toISOString();++ let query = supabase_rr_service+ .from("requests")+ .select("id, kind, api_version, created_at, target_hint")+ .eq("team_id", req.auth.team_id)+ .gte("created_at", windowStart)+ .order("id", { ascending: false })+ .limit(limit + 1); // fetch one extra to determine has_more++ if (endpoint) {+ query = query.eq("kind", endpoint);+ }++ if (cursor) {+ query = query.lt("id", cursor);+ }++ const { data, error } = await query;++ if (error) {+ logger.error("Failed to fetch activity", { error });+ return res.status(500).json({+ success: false,+ error: "Failed to fetch activity.",+ });+ }++ const hasMore = (data?.length ?? 0) > limit;+ const items = hasMore ? data!.slice(0, limit) : (data ?? []);++ const responseData: ActivityItem[] = items.map((row: any) => ({+ id: row.id,+ endpoint: row.kind,+ api_version: row.api_version,+ created_at: row.created_at,+ target: row.target_hint,+ }));++ const nextCursor =+ hasMore && responseData.length > 0+ ? responseData[responseData.length - 1].id+ : null;++ return res.status(200).json({+ success: true,+ data: responseData,+ cursor: nextCursor,+ has_more: hasMore,+ });+}diff --git a/apps/api/src/controllers/v1/types.ts b/apps/api/src/controllers/v1/types.tsindex 8a6015de4..4310555f0 100644--- a/apps/api/src/controllers/v1/types.ts+++ b/apps/api/src/controllers/v1/types.ts@@ -1263,6 +1263,7 @@ export type AuthCreditUsageChunk = {scrapeAgentPreview?: number;browser?: number;browserExecute?: number;+ account?: number;};concurrency: number;flags: TeamFlags;diff --git a/apps/api/src/routes/v1.ts b/apps/api/src/routes/v1.tsindex 0d27d69c0..70db19616 100644--- a/apps/api/src/routes/v1.ts+++ b/apps/api/src/routes/v1.ts@@ -37,6 +37,7 @@ import {} from "./shared";import { queueStatusController } from "../controllers/v1/queue-status";import { creditUsageHistoricalController } from "../controllers/v1/credit-usage-historical";+import { tokenUsageHistoricalController } from "../controllers/v1/token-usage-historical";import {paymentMiddleware,@@ -291,31 +292,31 @@ v1Router.post(v1Router.get("/team/credit-usage",- authMiddleware(RateLimiterMode.CrawlStatus),+ authMiddleware(RateLimiterMode.Account),wrap(creditUsageController),);v1Router.get("/team/credit-usage/historical",- authMiddleware(RateLimiterMode.CrawlStatus),+ authMiddleware(RateLimiterMode.Account),wrap(creditUsageHistoricalController),);v1Router.get("/team/token-usage",- authMiddleware(RateLimiterMode.ExtractStatus),+ authMiddleware(RateLimiterMode.Account),wrap(tokenUsageController),);v1Router.get("/team/token-usage/historical",- authMiddleware(RateLimiterMode.ExtractStatus),+ authMiddleware(RateLimiterMode.Account),wrap(tokenUsageHistoricalController),);v1Router.get("/team/queue-status",- authMiddleware(RateLimiterMode.CrawlStatus),+ authMiddleware(RateLimiterMode.Account),wrap(queueStatusController),);diff --git a/apps/api/src/routes/v2.ts b/apps/api/src/routes/v2.tsindex 6e10084e0..b4fdc6139 100644--- a/apps/api/src/routes/v2.ts+++ b/apps/api/src/routes/v2.ts@@ -50,6 +50,7 @@ import {browserListController,browserWebhookDestroyedController,} from "../controllers/v2/browser";+import { activityController } from "../controllers/v1/activity";import { agentSignupController } from "../controllers/v2/agent-signup";import {agentSignupConfirmController,@@ -361,25 +362,25 @@ v2Router.delete(v2Router.get("/team/credit-usage",- authMiddleware(RateLimiterMode.CrawlStatus),+ authMiddleware(RateLimiterMode.Account),wrap(creditUsageController),);v2Router.get("/team/credit-usage/historical",- authMiddleware(RateLimiterMode.CrawlStatus),+ authMiddleware(RateLimiterMode.Account),wrap(creditUsageHistoricalController),);v2Router.get("/team/token-usage",- authMiddleware(RateLimiterMode.ExtractStatus),+ authMiddleware(RateLimiterMode.Account),wrap(tokenUsageController),);v2Router.get("/team/token-usage/historical",- authMiddleware(RateLimiterMode.ExtractStatus),+ authMiddleware(RateLimiterMode.Account),wrap(tokenUsageHistoricalController),);@@ -391,10 +392,16 @@ v2Router.get(v2Router.get("/team/queue-status",- authMiddleware(RateLimiterMode.CrawlStatus),+ authMiddleware(RateLimiterMode.Account),wrap(queueStatusController),);+v2Router.get(+ "/team/activity",+ authMiddleware(RateLimiterMode.Account),+ wrap(activityController),+);+v2Router.post("/browser",authMiddleware(RateLimiterMode.Browser),diff --git a/apps/api/src/services/rate-limiter.ts b/apps/api/src/services/rate-limiter.tsindex 9d4d475c3..4f8724b26 100644--- a/apps/api/src/services/rate-limiter.ts+++ b/apps/api/src/services/rate-limiter.ts@@ -29,6 +29,7 @@ const fallbackRateLimits: AuthCreditUsageChunk["rate_limits"] = {scrapeAgentPreview: 10,browser: 20,browserExecute: 1000,+ account: 1000,};export function getRateLimiter(diff --git a/apps/api/src/types.ts b/apps/api/src/types.tsindex e9437594c..9e68367d8 100644--- a/apps/api/src/types.ts+++ b/apps/api/src/types.ts@@ -145,6 +145,7 @@ export enum RateLimiterMode {ExtractAgentPreview = "extractAgentPreview",Browser = "browser",BrowserExecute = "browserExecute",+ Account = "account",}export type AuthResponse =