How to Run a Technical SEO Page Audit Using Minifetch

Run a complete technical SEO audit on a single web page in one API call. Returns a structured report with PASS/ WARN/ FAIL findings for every signal. No black-box scoring — every threshold is documented and applied deterministically.

Run the audit from our homepage and the results will show up on our results page as a list of action items with explanations in a handy UI. If you'd like to take the audit data with you and pipe it into an AI agent or automation pipeline there are instructions for workflows below.

This is a composer endpoint /run/seo-page-audit. Under the hood it runs the preflight check, fetches metadata, extracts links, and assembles the audit according to deterministic rules. You pay one price for the whole thing. If robots.txt blocks the page, the request fails and you are not charged.

Building with an AI agent? This tutorial is also available as a skill your AI agent can load directly. The skill file also contains all the rules Minifetch uses for the audit: minifetch.com/skills/seo-page-audit/SKILL.md

  1. Get access

    First, choose a payment method:

    Credit card & API key — Sign up on the dashboard and get credits worth 25 free audits automatically. Then create your API key. No credit card required to begin. Top up for as little as $2 with your credit card. Recommended for most builders.

    USDC on Base or Solana — Just load your wallet with USDC on Base or Solana and you're ready. No "gas token" (ETH or SOL) required. No Minifetch account setup needed. Recommended for agents and agent builders.

  2. Check the URL first

    Free

    Before spending a credit, run a quick preflight check to confirm the URL is fetchable. This is free and tells you whether the site's robots.txt allows Minifetch to fetch it. If you own the site and want to allow Minifetch access, see: How to Unblock Minifetch from your site.

    - From the homepage, enter your URL in the search box and click "Check URL".

    - Or from your CLI:

    curl "https://minifetch.com/api/v1/free/preflight/url-check?url=https://yoursite.com/your-page"

    - Or with the minifetch api, follow the README "Quick Start" section to initialize the client, then:

    const response = await client.preflightCheck("https://yoursite.com/your-page");
    Tip: The checkAndRunSeoPageAudit() method in the minifetch-api client runs the preflight automatically before every paid fetch — so you only pay when a result is likely. We never charge for blocked pages or errors.

  3. Run the audit

    $0.01 per URL

    - From the homepage, enter your URL then click "Go Fetch!".

    - Or from your CLI:

    curl "https://minifetch.com/api/v1/run/seo-page-audit?url=https://yoursite.com/your-page" \
  -H "Authorization: Bearer YOUR_API_KEY"

    - Or with the minifetch api:

    const response = await client.checkAndRunSeoPageAudit(
  "https://yoursite.com/your-page"
);
    The response maps directly to the signals search engines and social platforms care about. Every audit finding has the same shape: 

    {
  "status": "pass" | "warn" | "fail",
  "expected": ,
  ... // additional fields (value, count, length, etc.)
}

    Pure data fields (counts, dates, dimensions) appear without status or expected — they are informational pass-throughs.

  4. Audit rules

    Every threshold is documented. The audit utility applies these deterministically. No scoring model, no AI judgment.

    Audit rules are documented in two places: 1/ In the audit results UI, click on the rows that contain a [ + ] and the row will expand to reveal audit logic and rules. 2/ If you prefer, there is also a skill file that contains the same information, you can feed this file to your AI agent if you're working with one.

  5. Iterating on results

    The audit response is a structured JSON document with pass/ warn/ fail findings throughout. Triage by status: filter for fail first, then warn. Pure data fields without status are informational.

    The full page audit composes the API primitives /extract/url-metadata + /extract/url-links + the audit rules. While iterating or monitoring, you can call the primitives directly; they cost a fraction of the full audit and return the same underlying data. The API primitives are also designed to be more token-efficient, offering cost savings on both ends: fetching costs as well as AI compute.

    Every audit response includes a minifetchCache object: 

    "minifetchCache": {
  "hit": "false",
  "cachedAt": "2026-02-18T22:37:32.889Z",
  "expiresAt": "2026-02-18T22:39:32.889Z"
}

    Watch the minifetchCache.hit field — back-to-back calls within the cache window (~2 min) skip the network fetch entirely. Run the full audit again once your pipeline is stable and the cache expiresAt timestamp has passed. All Minifetch API endpoints share the cache, keyed by URL.