Serpex Docs

What is Serpex?

Serpex is a developer API for two things:

Search — send a query, get structured web-search results (title, URL, snippet, position, engine) in JSON. No browser required. 1 credit per fresh search.
Extract / Crawl — send URLs, get clean page content in Markdown or HTML. Up to 10 URLs per request. 1 credit per URL, or 5 credits per URL with stealth mode for pages behind heavy anti-bot protection.

Base URL: https://api.serpex.dev. Auth: Authorization: Bearer sk_....

Quickstart

Make your first search and extract call in under 5 minutes.

Authentication

Bearer API keys — how to get one and keep it safe.

Search API

Full parameter reference for POST /api/search.

TypeScript SDK

Official SDK for Node.js — npm install serpex.

APIs at a glance

Endpoint	What it does	Cost
`POST /api/search`	Web search — returns ranked results	1 credit
`POST /api/crawl`	Extract page content → Markdown or HTML	1 credit/URL
`POST /api/crawl` with `"stealth": true`	Same, for anti-bot-protected pages	5 credits/URL

Quick example

curl -X POST https://api.serpex.dev/api/search \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"q": "openai gpt-4o"}'

Response:

{
  "results": [
    {
      "title": "GPT-4o — OpenAI",
      "url": "https://openai.com/gpt-4o",
      "snippet": "GPT-4o is our most capable multimodal model...",
      "position": 1,
      "engine": "duckduckgo"
    }
  ],
  "metadata": {
    "credits_used": 1,
    "from_cache": false,
    "status": "success",
    "response_time": 1105
  }
}