POST/v1/serp

Quickstart

Construct a standard Google Search URL containing a q parameter. Use Google's URL parameters for language, region, pagination, and search type.

curl -X POST https://api.amayalabs.io/v1/serp \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.google.com/search?q=openai+latest+models&gl=us&hl=en"}'

curl -X POST https://api.amayalabs.io/v1/serp \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.google.com/search?q=hotels+tokyo&gl=jp&hl=ja&start=10"}'

Request

Output format

The response contains normalized external result URLs and their associated page text in items.

{
  "ok": true,
  "url": "https://www.google.com/search?q=google&gl=us&hl=en",
  "finalUrl": "https://www.google.com/search?q=google&gl=us&hl=en",
  "items": [
    {
      "text": "1:14 A dairy farm is a very complex biological system. See how Michigan dairy farmer Paul uses Gemini 3.6 Flash in Google Antigravity to build a custom AI dashboard, automating farm financial calculations so he can spend less time behind a screen and more time hands-on. Instagram · 4 hr",
      "url": "https://www.instagram.com/reel/DbJpeHbSzum"
    },
    {
      "text": "1:13 How to know if an image is AI generated or not YouTube · 9 hr",
      "url": "https://www.youtube.com/watch?v=Sm7OTow3mcY"
    },
    {
      "text": "0:32 New? Check. Easy? Check. Secure? Also check. Our selfie video feature lets you sign-in your Google Account — even if you forget your password or lose your device. Here’s what to know ↓ Facebook · 12 hr",
      "url": "https://www.facebook.com/Google/posts/new-check-easy-check-secure-also-check-our-selfie-video-feature-lets-you-sign-in/1605967640884664"
    },
    {
      "text": "Facebook 36M followers",
      "url": "https://www.facebook.com/Google"
    },
    {
      "text": "X 32M followers",
      "url": "https://twitter.com/Google"
    },
    {
      "text": "Instagram 16M followers",
      "url": "https://www.instagram.com/google"
    },
    {
      "text": "Introducing selfie for sign-in: a new, easy way to access your Google Account 16 hours ago blog.google",
      "url": "https://blog.google/innovation-and-ai/technology/safety-security/selfie-video-sign-in"
    },
    {
      "text": "Google just had its first negative cash flow quarter due to massive AI spending 10 hours ago Ars Technica",
      "url": "https://arstechnica.com/google/2026/07/google-just-had-its-first-negative-cash-flow-quarter-ever-due-to-massive-ai-spending"
    },
    {
      "text": "Google just had its first negative cash flow quarter due to massive AI spending Popular comment · This AI race is starting to look more like an infrastructure spending contest, and the question here is who can afford to keep building data centers long enough to win.... 360+ upvotes . 90+ comments · 8 hours ago r/technology Reddit",
      "url": "https://www.reddit.com/r/technology/comments/1v4kmk4/google_just_had_its_first_negative_cash_flow"
    },
    {
      "text": "Google will spend 20% of the US military budget on capex this year 9 hours ago typesfast · X American businessman",
      "url": "https://x.com/typesfast/status/2080339052398891244?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet"
    },
    {
      "text": "About Google https://about.google About Google: Our products, technology and company ...",
      "url": "https://about.google/",
      "children": [
        {
          "text": "About this result"
        }
      ]
    },
    {
      "text": "Wikipedia https://en.wikipedia.org Google",
      "url": "https://en.wikipedia.org/wiki/Google",
      "children": [
        {
          "text": "About this result"
        }
      ]
    },
    {
      "text": "blog.google https://blog.google News from Google | Google Product and Technology News and Stories",
      "url": "https://blog.google/",
      "children": [
        {
          "text": "About this result"
        }
      ]
    }
  ],
  "billed": true
}

Errors

Authenticate with the bearer API key shown above. Error responses include ok: false, error, and retryable. Retry only when retryable is true, and honor Retry-After when it is present.