Skip to content

Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥

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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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 =