API documentation/v2

Search

External result URLs from every part of Google's results page, with accompanying text for scraping pipelines, research and AI ingestion. Recommended for most integrations.

https://api.reserp.ai/v2/serp/search

On this page

When to use Search

Start here when Google helps you find source pages to read, scrape or process downstream.

Stable format: Google can add, remove or redesign SERP features without changing the URL-and-text format your pipeline consumes. Your integration doesn’t depend on Google keeping particular result fields.
Every result type: external result links from across the entire page, including organic listings, ads, carousels, sitelinks and other SERP features, in one flat list.
Token-efficient input: URLs and their accompanying text, without HTML or extra result-specific fields.

For example, a scheduled scraping pipeline can search Google, use an AI model to select relevant URLs, then scrape the selected pages. The same response also works for research tools and interactive agents.

Need rankings, SERP features or named fields such as prices and ratings? Structured results provides best-effort extraction for applications that can tolerate missing or inaccurate fields.

Request

Send a POST request with a complete Google Search URL in the url field. All Google Search parameters pass through unchanged except num.

Use the URL to search images or shopping results, choose a country or language, filter by date, and more. Search options belong inside the URL, not in separate JSON fields.

Authenticate with Authorization: Bearer $API_KEY and send the JSON body with Content-Type: application/json.

cURL

curl -X POST https://api.reserp.ai/v2/serp/search \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.google.com/search?q=coffee&gl=us&hl=en"
  }'

Field	Type	Description
`url`	`string`	Required. A `https://www.google.com/search` URL with a non-empty `q`. Maximum 10,000 characters.

num (results per page) is unsupported and returns a non-billable 400 invalid_request. Missing or invalid url values and extra body fields also return 400 invalid_request without a charge.

For additional result pages, see Pagination.

Text

text combines the text shown alongside a link, such as its title, source, snippet, date and ratings, separated by newlines. Use it to assess relevance before opening or scraping the URL. The field is omitted when no text is available and limited to 4,000 characters.

Response

Successful requests return HTTP 200 with the fields below plus the shared billing fields.

For every search type, the number of entries in results is independent of Google's pagination offset. Do not use results.length to calculate start or the next offset. Follow pagination.next_url instead. See Pagination.

Success fields

Field	Type	Description
`ok`	`boolean`	True for a successful response.
`request`	`Request`	Contains only `url`, the submitted Google Search URL. The final URL after redirects is `page.url`.
`page`	`object`	Contains `url`, the final URL after redirects.
`results`	`ResultEntry[]`	URLs and accompanying text from every result type, with duplicates combined. Occasional navigation or help links may also appear.
`pagination`	`Pagination`	Contains `next_url`, the URL to request the next page. It does not indicate whether more results exist.

ResultEntry object

Field	Type	Description
`url`	`string`	Result URL.
`text`	`string?`	All text the page shows with the link, one line per piece, up to 4,000 characters. Omitted when the link has none.

Example

A web page, trimmed to the first eight of sixteen entries.

JSON

{
  "ok": true,
  "request": {
    "url": "https://www.google.com/search?q=best+noise+cancelling+headphones&hl=en&gl=us"
  },
  "page": {
    "url": "https://www.google.com/search?q=best+noise+cancelling+headphones&hl=en&gl=us&sei=-vKZaoLmOK6gkPIPs46R6AY"
  },
  "results": [
    {
      "url": "https://recordingnow.com/blog/best-noise-cancelling-headphones",
      "text": "RecordingNOW.com\nhttps://recordingnow.com\nBest Noise Cancelling Headphones 2026 (50+ Tested!)\nTrue to its name, the\nBose QuietComfort Ultra 2nd Gen\nis the most comfortable pair of over-ear, noise cancelling headphones we've tested to date."
    },
    {
      "url": "https://www.nytimes.com/wirecutter/reviews/best-noise-cancelling-headphones",
      "text": "The New York Times\nhttps://www.nytimes.com\nThe 4 Best Noise-Cancelling Headphones of 2026 | Reviews by Wirecutter\nJul 20, 2026\n—\nSoundcore Space One\n. This pair of over-ear headphones cancels noise impressively, sounds great, is comfortable to wear, and has a long battery ..."
    },
    {
      "url": "https://www.reddit.com/r/digitalnomad/comments/1pt8k3a/what_are_the_best_noisecancelling_headphones_or",
      "text": "Reddit · r/digitalnomad\n90+ comments · 8 months ago\nWhat are the best noise-cancelling headphones or brands widely ...\nThis question is currently being asked quite alot so I'm going to share my experience on this. There are several companies that make effective sound cancelling ...\nView all posts"
    },
    {
      "url": "https://www.reddit.com/r/digitalnomad/comments/1pt8k3a/what_are_the_best_noisecancelling_headphones_or/o4fk2ui",
      "text": "been through so many pairs but this one I settled on has incredible comfort and the noise canceling ...\nMore\nTop answer\n· 18 votes"
    },
    {
      "url": "https://www.reddit.com/r/digitalnomad/comments/1pt8k3a/what_are_the_best_noisecancelling_headphones_or/nwc6b2j",
      "text": "I am using these headphones and I absolutely love them. Noise cancelling is really good, ...\nMore\n11 votes"
    },
    {
      "url": "https://www.reddit.com/r/productivity/comments/1c8x5vy/what_are_the_best_noisecancelling_headphones",
      "text": "What are the best noise-cancelling headphones?\nr/productivity\n·\n110+ comments\n2y"
    },
    {
      "url": "https://www.reddit.com/r/SonyHeadphones/comments/1ssq1ne/the_best_noisecancelling_headphones_that_are",
      "text": "Best Noise-cancelling Headphones Worth Buying Today\nr/SonyHeadphones\n·\n20+ comments\n4mo\nMore results from Reddit\nDiscussions and forums\nThe best noise-cancelling headphones that are actually worth buying?"
    },
    {
      "url": "https://www.rtings.com/headphones/reviews/best/by-feature/noise-cancelling",
      "text": "RTINGS.com\nhttps://www.rtings.com\nThe 5 Best Noise Cancelling Headphones of 2026\nAug 26, 2026\n—\nThe Sony WH-1000XM6 are the best noise cancelling headphones we've tested. These premium over-ears have remarkable noise isolation."
    }
  ],
  "pagination": {
    "next_url": "https://www.google.com/search?q=best+noise+cancelling+headphones&hl=en&gl=us&start=10"
  },
  "billed": true,
  "billing_source": "prepaid"
}