Skip to main content
Use Serply through Corsair: one client, typed API calls, local DB sync. Copy your API key from the Serply dashboard (app.serply.io). Each uncached call spends one credit, so every operation is a metered read (read); new accounts get free credits for 30 days. Things to know:
  • Search terms. Every search takes q. web.search also takes Google’s num (about 10 per page at most), start (offset; 10 is page two), gl (country) and hl (language). Google operators such as site: work in q.
  • Region and device. proxy_location (US, DE, GB, …) and device (desktop or mobile) set where Google thinks the search comes from. Without gl or a region, results can change between calls.
  • Answers. images.search, places.search and articles.search return a fixed set of fields per row (the ones they store). Every other operation returns Serply’s JSON as it came, with the main list typed (results, jobs, products, entries, Reddit data.children) and every other field kept.
  • Reddit. reddit.subredditPosts and reddit.userPosts page with after (the previous answer’s data.after); reddit.post takes with_comments.
  • Pages. pages.fetch returns the page in data, as markdown (response_type: markdown) or HTML (full, which also returns the page’s HTTP status).
  • Stored rows. Images, places and Scholar articles are stored locally; phone numbers and author names are not. Search terms are never written to events, and a failed call drops them from the error.
What you get:
  • 16 typed API operations
  • 3 synced entities (articles, images, places) for fast .search() / .list()

Setup

1

Install

2

Add the plugin

corsair.ts
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

4

Connect a tenant

Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.

Example API calls

Search Google
Write No write-style endpoint inferred; pick any operation from the API reference. See the full list on the API page.

Query synced data

Synced entities support tenant.serply.db.<entity>.search() and .list(): articles, images, places. See Database for filters and operators.

What’s next

API reference

Every serply.api.* operation with input and output types.

Database

Synced entities, search filters, and operators.

Connect / OAuth

createLink, Hub delivery, and tenant connect flows.

Use with agents

Expose this plugin’s operations as MCP tools.