Open source alternative to Semrush and Ahrefs
TypeScript backlink-analysisgoogle-search-console-mcpkeyword-researchmcpseoseo-agentseo-auditseo-automationseo-skillsseo-toolssite-audit
import { dataforseoGet } from "@/server/lib/dataforseo/core";
import {
assertOk,
type DataforseoTaskLike,
} from "@/server/lib/dataforseo/envelope";
/**
* Account snapshot from the free GET /v3/appendix/user_data. Every field is
* optional on the wire; `money.statistics.day` / `.minute` group spend by
* function under `total_<function>` keys, so those stay untyped records.
*/
interface DataforseoUserData {
login?: string | null;
timezone?: string | null;
money?: {
total?: number | null;
balance?: number | null;
statistics?: {
day?: Record<string, unknown> | null;
minute?: Record<string, unknown> | null;
[key: string]: unknown;
} | null;
[key: string]: unknown;
} | null;
[key: string]: unknown;
}
/**
* Reads account spend + balance from DataForSEO's free GET
* /v3/appendix/user_data. This is the standard, non-billable way to inspect
* cost — unlike the other billing scripts, it does NOT make a live billable
* call to observe spend, so there is nothing to meter and it is deliberately
* NOT wired through meterDataforseoCall / client.ts.
*
* The result carries `money.total` (lifetime deposited), `money.balance`
* (remaining), and `money.statistics.day` / `.minute` — spend grouped by
* function (serp, keywords_data, backlinks, dataforseo_labs, on_page,
* business_data, …) for the rolling day / minute window.
*/
export async function fetchUserData(): Promise<DataforseoUserData | undefined> {
const response = await dataforseoGet<
DataforseoTaskLike & { result?: DataforseoUserData[] }
>("/v3/appendix/user_data");
// Validates top-level + task status; the call is free so there is no billing
// envelope to build.
const task = assertOk(response);
return task.result?.[0];
}