The Cheapest Pixel Position API for Developers

curl "https://apiserpent.com/api/search?q=car+insurance+quotes&engine=google&country=us&pixel_position=true" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

FOLD = 768            # the viewport height the page is measured against
DOMAIN = "example.com"

r = requests.get(
    "https://apiserpent.com/api/search",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"q": "car insurance quotes", "engine": "google",
            "country": "us", "pixel_position": "true"},
).json()["results"]

mine = next((o for o in r["organic"] if DOMAIN in o["url"]), None)
y = mine and mine.get("pixel_position")     # may be absent — never assume it
print(f"rank {mine['position']}, opens at {y}px, {round(y / FOLD, 2)} screens down")
# → rank 1, opens at 1082px, 1.41 screens down

# Everything the SERP put above you, with the height each one takes.
blocks = []
for key in ("aiOverview", "featuredSnippet", "knowledgePanel"):
    b = r.get(key)
    if b and b.get("pixel_position") is not None:
        blocks.append((key, b["pixel_position"], (b.get("pixel_box") or {}).get("h")))
for name, items in (("ad", (r.get("ads") or {}).get("top") or []),
                    ("paa", r.get("peopleAlsoAsk") or [])):
    for it in items:
        if it.get("pixel_position") is not None:
            blocks.append((name, it["pixel_position"], (it.get("pixel_box") or {}).get("h")))

above = sorted(b for b in blocks if b[1] < y)
print(len(above), "blocks above you,",
      sum(h or 0 for _, _, h in above), "px of them")

const FOLD = 768;

const res = await fetch(
  "https://apiserpent.com/api/search?q=mortgage+rates+today&engine=google&country=us&pixel_position=true",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const { results } = await res.json();

// pixel_position is the TOP edge. A row is fully visible only if its box ends
// above the fold too — that is what pixel_box.h is for.
const visible = results.organic.filter(o =>
  o.pixel_position != null && o.pixel_position + ((o.pixel_box && o.pixel_box.h) || 0) <= FOLD
);
console.log(`${visible.length} organic results fit on the first screen`);

// Share of the first screen taken by everything that is not an organic result.
const area = b => (b && b.pixel_box) ? b.pixel_box.w * b.pixel_box.h : 0;
const featureArea = area(results.aiOverview) + area(results.featuredSnippet)
  + (results.ads?.top || []).reduce((s, a) => s + area(a), 0);
console.log("feature pixels above the fold:", featureArea);

{
  "success": true,
  "engine": "google",
  "results": {
    "organic": [
      {
        "position": 1,                 // ordinal — 1st organic result
        "title": "…",
        "url": "https://example.com",
        "pixel_position": 1082,        // y of the element's top edge
        "pixel_box": { "x": 126, "y": 1082, "w": 652, "h": 118 }
      }                                 // pixel_box.y === pixel_position, always
    ],
    "ads": {
      "top": [
        { "title": "…", "pixel_position": 120, "pixel_box": { "x": 126, "y": 120, "w": 652, "h": 82 } }
      ]
    },
    "aiOverview": {
      "text": "…",
      "pixel_position": 398,
      "pixel_box": { "x": 125, "y": 398, "w": 1100, "h": 428 }
    },                                  // 398 + 428 = 826 → crosses the 768px fold
    "peopleAlsoAsk": [
      { "question": "…", "pixel_position": 842, "pixel_box": { "x": 126, "y": 842, "w": 652, "h": 52 } }
    ],
    "featuredSnippet": null,          // not on this page — the key is still here
    "knowledgePanel": null
  }
}

// (a) the call was served from your free allowance
{ "metadata": { "pixelPositionUnavailable": "free_tier" } }

// (b) you sent the flag to /api/search/quick
{ "metadata": {
    "pixelPositionUnavailable": "not_supported_on_quick",
    "pixelPositionHint": "Pixel positions are available on /api/search (Deep Search)."
} }

// Both still return the search itself. Branch on the marker, not on an error:
// neither of these is a 4xx, and neither changes the rest of the response.