Serpbit API

curl -G https://api.serpbit.com/v1/search \
  -H "Authorization: Bearer $SERPBIT_KEY" \
  --data-urlencode "q=coffee near me"

curl -G https://api.serpbit.com/v1/search \
  -H "Authorization: Bearer $SERPBIT_KEY" \
  -H "Idempotency-Key: 7c0e7a52-3f6b-4e2b-9a61-5d2f0c8e1b44" \
  --data-urlencode "q=running shoes"

HTTP/2 200
x-credits: 0
idempotent-replayed: true
x-request-id: 5f0c2a9e1b7d4c3a8e6f1d20

# Claude, ChatGPT: Settings → Connectors → Add custom connector
https://api.serpbit.com/mcp

# Claude Code: add it, then sign in with /mcp
claude mcp add --transport http serpbit https://api.serpbit.com/mcp

# or with a key
claude mcp add --transport http serpbit https://api.serpbit.com/mcp \
  --header "Authorization: Bearer $SERPBIT_KEY"

// Cursor: ~/.cursor/mcp.json · VS Code: .vscode/mcp.json ("servers", "type": "http")
{
  "mcpServers": {
    "serpbit": { "url": "https://api.serpbit.com/mcp" }
  }
}

curl https://api.serpbit.com/v1/batches \
  -H "Authorization: Bearer $SERPBIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"webhook": "https://example.com/serpbit",
       "requests": [
         {"path": "/v1/search", "params": {"q": "running shoes", "gl": "de"}, "id": "kw-1"},
         {"path": "/v1/search", "params": {"q": "trail shoes", "pages": 2}, "id": "kw-2"}
       ]}'

{
  "id": "bat_5f0c2a9e1b7d4c3a8e6f1d20",
  "status": "running",
  "total": 2, "done": 0, "succeeded": 0, "failed": 0,
  "credits": 0,
  "created_at": "2026-11-08T21:04:05Z"
}

# pip install serpbit
from serpbit import Serpbit

sb = Serpbit()
answer = sb.search("espresso grinder", gl="de", content=3)
print(answer["organic"][0]["content"]["text"])

// npm install serpbit
import Serpbit from "serpbit";

const sb = new Serpbit();
const answer = await sb.search("espresso grinder", { gl: "de", content: 3 });
console.log(answer.organic[0].content?.text);

curl -G https://api.serpbit.com/v1/search \
  -H "Authorization: Bearer $SERPBIT_KEY" \
  --data-urlencode "q=running shoes" \
  --data-urlencode "ai_overview=1"

{
  "request_id": "5f0c2a9e1b7d4c3a8e6f1d20",
  "ai_overview": { "text": "Look for cushioning…", "sources": […] },
  "organic": [{
    "position": 1,
    "page": 1,
    "title": "The best running shoes of 2026",
    "url": "https://www.example.com/running",
    "domain": "example.com",
    "snippet": "We ran 400 miles in 30 pairs…"
  }],
  "related_questions": ["How do I choose a running shoe?"],
  "pages": [{ "page": 1, "results": 10 }],
  "pagination": { "next_start": 10 },
  "meta": { "elapsed_ms": 2870 }
}

curl -G https://api.serpbit.com/v1/news \
  -H "Authorization: Bearer $SERPBIT_KEY" \
  --data-urlencode "q=wildfire" \
  --data-urlencode "sort=date"

{
  "news": [{
    "position": 1, "page": 1,
    "title": "Crews work to contain wildfire in the White Mountains",
    "url": "https://www.example.com/news/wildfire",
    "source": "WGME",
    "date": "20 hours ago",
    "published_at": "2026-11-05T22:47:47Z",
    "story_id": "4906325574"
  }],
  "pages": [{ "page": 1, "results": 10 }]
}

curl -G https://api.serpbit.com/v1/shopping \
  -H "Authorization: Bearer $SERPBIT_KEY" \
  --data-urlencode "q=running shoes"

{
  "shopping": [{
    "position": 1, "page": 1,
    "title": "Brooks Women's Glycerin Max 2",
    "product_id": "10327006607387456741",
    "source": "Fitness Sports",
    "price": "$149.95", "extracted_price": 149.95,
    "rating": 4.4, "reviews": 407
  }],
  "filters": [{ "type": "Price", "options": [
    { "text": "Under $100", "q": "running shoes under $100", "shoprs": "CAESFhIU…" }
  ] }]
}

curl -G https://api.serpbit.com/v1/shopping/product \
  -H "Authorization: Bearer $SERPBIT_KEY" \
  --data-urlencode "product_id=10573081257954387607"

{
  "product": { "title": "Timemore C2 Coffee Grinder", "brand": "Time More" },
  "sellers": [{
    "name": "mercari.com",
    "price": 46.66, "currency": "USD",
    "delivery_price": 0, "total_price": 46.66,
    "link": "https://www.mercari.com/us/item/…"
  }],
  "sellers_count": 11,
  "complete": true
}

curl -G https://api.serpbit.com/v1/images \
  -H "Authorization: Bearer $SERPBIT_KEY" \
  --data-urlencode "q=eiffel tower" \
  --data-urlencode "size=large"

{
  "images": [{
    "position": 1, "page": 1,
    "title": "Eiffel Tower - Wikipedia",
    "url": "https://en.wikipedia.org/wiki/Eiffel_Tower",
    "original": "https://upload.wikimedia.org/…/Tour_Eiffel.jpg",
    "original_width": 330, "original_height": 550,
    "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:…"
  }],
  "pages": [{ "page": 1, "results": 100 }]
}

curl -G https://api.serpbit.com/v1/videos \
  -H "Authorization: Bearer $SERPBIT_KEY" \
  --data-urlencode "q=eiffel tower" \
  --data-urlencode "duration=short"

{
  "videos": [{
    "position": 1, "page": 1,
    "title": "Gustave Eiffel, The Eiffel Tower",
    "url": "https://www.youtube.com/watch?v=vurh8_SO6_c",
    "duration": "9:26", "duration_seconds": 566,
    "platform": "YouTube", "channel": "Smarthistory",
    "video_id": "vurh8_SO6_c"
  }],
  "pages": [{ "page": 1, "results": 10 }]
}

curl -G https://api.serpbit.com/v1/maps \
  -H "Authorization: Bearer $SERPBIT_KEY" \
  --data-urlencode "q=coffee shops" \
  --data-urlencode "location=Philadelphia,Pennsylvania,United States"

{
  "places": [{
    "position": 1, "page": 1,
    "title": "Freedom Coffee House",
    "type": "Coffee shop",
    "rating": 5, "reviews": 66,
    "address": "4906 Old York Rd, Philadelphia, PA 19141",
    "phone": "(267) 441-2131",
    "place_id": "ChIJG9bzoEu3xokR6Mly5crxWPs"
  }],
  "pages": [{ "page": 1, "results": 20 }],
  "pagination": { "next_start": 20 }
}

curl -G https://api.serpbit.com/v1/autocomplete \
  -H "Authorization: Bearer $SERPBIT_KEY" \
  --data-urlencode "q=golden ret" \
  --data-urlencode "client=gws-wiz"

{
  "suggestions": [
    { "position": 1, "value": "golden retriever", "type": "ENTITY",
      "title": "Golden Retriever", "description": "Dog breed" },
    { "position": 2, "value": "golden retriever puppies", "type": "QUERY" }
  ]
}

curl -G https://api.serpbit.com/v1/ai-mode \
  -H "Authorization: Bearer $SERPBIT_KEY" \
  --data-urlencode "q=why is the sky blue" \
  --max-time 120

{
  "text_blocks": [
    { "type": "paragraph", "snippet": "The sky is blue because of Rayleigh scattering…",
      "reference_indexes": [0, 1] },
    { "type": "heading", "snippet": "How It Works", "level": 4 }
  ],
  "references": [
    { "index": 0, "title": "Why Is the Sky Blue? | NASA Space Place",
      "link": "https://spaceplace.nasa.gov/blue-sky/", "source": "NASA Space Place (.gov)" }
  ],
  "markdown": "The sky is blue because of Rayleigh scattering…"
}

curl "https://api.serpbit.com/customsearch/v1?key=$SERPBIT_KEY&q=espresso+grinder&num=10"

{
  "kind": "customsearch#search",
  "queries": { "nextPage": [{ "startIndex": 11, "count": 10 }] },
  "items": [{
    "title": "The 6 Best Espresso Grinders of 2026",
    "link": "https://www.example.com/best-espresso-grinders",
    "displayLink": "www.example.com",
    "snippet": "We tested 25 grinders…"
  }]
}