SERP

A SERP call tells you who actually ranks for a query right now, which SERP features Google shows, what people also ask, and whether an AI Overview appears and which sources it cites. That last part is the GEO signal: being cited in the overview matters more than ranking third below it.

POST/v1/serp

Google results

Returns the organic results for a keyword, the People Also Ask questions, the list of SERP features present, and the AI Overview block when Google shows one.

Costs 1 credit per call. The AI Overview and People Also Ask come from the same call at no extra cost.

Required attributes

Name
keyword
Type
string
Description
The search query, 1 to 200 characters.

Optional attributes

Name
country
Type
string
Description
ISO 3166-1 alpha-2 code such as US, ES or MX. Default US. See Countries and languages.
Name
language
Type
string
Description
ISO 639-1 code such as en or es. Defaults to the main language of the country, so ES means Spanish unless you say otherwise.
Name
limit
Type
integer
Description
Organic results to return, 10 to 30. Default 10.

Response fields

Name
features
Type
array
Description
Every block type present on the page, for example organic, ai_overview, people_also_ask, video, local_pack.
Name
organic[].position
Type
integer
Description
Absolute position on the page, counting every block above it.
Name
ai_overview.present
Type
boolean
Description
Whether Google showed an AI Overview for this query in this country.
Name
ai_overview.text
Type
string
Description
The overview text with citation markup removed. null when not present.
Name
ai_overview.citations
Type
array
Description
The sources the overview links to, in order. A domain cited here without ranking organically won the answer without winning the SERP.

Request

POST

/v1/serp

curl -X POST https://suvjexogmfpvxjcktvuk.supabase.co/functions/v1/api/v1/serp \
  -H "Authorization: Bearer $PENGU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "best crm for small business", "country": "US"}'

Response

{
  "data": {
    "keyword": "best crm for small business",
    "country": "US",
    "language": "en",
    "checked_at": "2026-09-09T11:47:00.841Z",
    "total_results": 115,
    "features": [
      "ai_overview",
      "organic",
      // ...
    ],
    "organic": [
      {
        "position": 2,
        "title": "Best and inexpensive CRM for small business",
        "url": "https://www.reddit.com/r/CRM/comments/1e5141p/best_and_inexpensive_crm_for_small_business/",
        "domain": "reddit.com",
        "description": "Teamgate CRM is definitely the best CRM for small business as a generical sweeping statement, Pipedrive and Hu..."
      },
      {
        "position": 4,
        "title": "CRM For Small Business (Your Complete Guide)",
        "url": "https://www.salesforce.com/crm/crm-for-small-business/",
        "domain": "salesforce.com",
        "description": "Salesforce CRM is the best for small businesses Small businesses need a CRM solution that addresses existing p..."
      },
      // ...
    ],
    "people_also_ask": [
      "Will CRM be replaced by AI?",
      "What is the simplest CRM to use?",
      // ...
    ],
    "ai_overview": {
      "present": true,
      "text": "The best CRM for a small business depends on your budget and primary goal, with [Zoho CRM](https://www.zoho.co...",
      "citations": [
        {
          "domain": "reddit.com",
          "url": "https://www.reddit.com/r/CRM/comments/1e5141p/best_and_inexpensive_crm_for_small_business/",
          "title": "Best and inexpensive CRM for small business - Reddit"
        },
        {
          "domain": "uschamber.com",
          "url": "https://www.uschamber.com/co/start/strategy/low-cost-crm-tools",
          "title": "10 Free or Low-Cost CRM Tools for Small Businesses"
        },
        // ...
      ]
    }
  },
  "meta": {
    "credits_charged": 0.5,
    "credits_remaining": 483.5,
    "request_id": "52275c9e-dd9f-4ac7-8d12-79a2d5b2a111"
  }
}