# Serphouse Api

> Teach AI agents to call SERPHouse REST APIs with curl for web search, SERP data, and SEO intelligence

- **Type:** Skill
- **Install:** `agentstack add skill-serphouse-agent-skills-api`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [SERPHouse](https://agentstack.voostack.com/s/serphouse)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [SERPHouse](https://github.com/SERPHouse)
- **Source:** https://github.com/SERPHouse/agent-skills/tree/master/skills/api

## Install

```sh
agentstack add skill-serphouse-agent-skills-api
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# SERPHouse API Skill

This skill equips the agent to search the web and scrape SERP data via the [SERPHouse API](https://docs.serphouse.com). The agent can search Google, Bing, Yahoo — web, news, images, shopping, jobs, forums, local, video, and more.

## How to Use

1. **On first invocation**, the user must provide a `SERPHOUSE_API_KEY`. The agent will store and reuse it for subsequent searches.
2. The agent uses `curl` to call SERPHouse endpoints unless the codebase provides a dedicated client.
3. Always prefer `curl` examples when showing the user how to use an endpoint — include the full command with `api_token=` or `Authorization: Bearer `.

## Authentication

Pass your API key in one of two ways:

- **Header:** `Authorization: Bearer `
- **Query param:** `api_token=`

Base URL: `https://api.serphouse.com`

## curl Examples for Every Endpoint

### 1. SERP API (General)

**Live GET search (realtime):**
```bash
curl "https://api.serphouse.com/serp/live?q=best+coding+courses&serp_type=web&api_token=$SERPHOUSE_API_KEY"
```

**Live POST search:**
```bash
curl -X POST https://api.serphouse.com/serp/live \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"best coding courses","domain":"google.com","lang":"en","device":"desktop","serp_type":"web"}'
```

**Schedule batch tasks (up to 100):**
```bash
curl -X POST https://api.serphouse.com/serp/schedule \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"q":"python tutorial","domain":"google.com","lang":"en","device":"desktop","serp_type":"web"}]'
```

**Google Advanced (top 100 results):**
```bash
curl -X POST https://api.serphouse.com/serp/google_advanced \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"machine learning","domain":"google.com","lang":"en","device":"desktop","max_pages":5}'
```

**Check task status:**
```bash
curl "https://api.serphouse.com/serp/check?id=TASK_ID&api_token=$SERPHOUSE_API_KEY"
```

**Get task result:**
```bash
curl "https://api.serphouse.com/serp/get?id=TASK_ID&api_token=$SERPHOUSE_API_KEY"
```

### 2. Google APIs

**Google Web Search:**
```bash
curl -X POST https://api.serphouse.com/google-web \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"rust programming","domain":"google.com","device":"desktop","lang":"en"}'
```

**Google Lite:**
```bash
curl -X POST https://api.serphouse.com/web-search-lite \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"typescript","domain":"google.com","lang":"en","gl":"US"}'
```

**Google News:**
```bash
curl -X POST https://api.serphouse.com/google-news \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"AI breakthroughs","domain":"google.com","lang":"en","device":"desktop"}'
```

**Google Images:**
```bash
curl -X POST https://api.serphouse.com/google-image \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"minimalist desk setup","domain":"google.com","lang":"en","loc":"US"}'
```

**Google Shopping:**
```bash
curl -X POST https://api.serphouse.com/google-shop \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"mechanical keyboard","domain":"google.com","lang":"en","loc":"US"}'
```

**Google Jobs:**
```bash
curl -X POST https://api.serphouse.com/google-jobs-api \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"software engineer","domain":"google.com","device":"desktop","lang":"en"}'
```

**Google Videos:**
```bash
curl -X POST https://api.serphouse.com/google-videos-api \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"react tutorial","domain":"google.com","device":"desktop","lang":"en"}'
```

**Google Short Videos:**
```bash
curl -X POST https://api.serphouse.com/google-short-videos-api \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"cooking tips","domain":"google.com","device":"desktop","lang":"en"}'
```

**Google Forums:**
```bash
curl -X POST https://api.serphouse.com/google-forums-api \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"best IDE","domain":"google.com","device":"desktop","lang":"en"}'
```

**Google Local:**
```bash
curl -X POST https://api.serphouse.com/google-local-api \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"coffee shop","domain":"google.com","lang":"en","loc":"US"}'
```

**Google Autocomplete (5 credits):**
```bash
curl -X POST https://api.serphouse.com/google-autocomplete-api \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"how to","lang":"en","loc":"US","gl":"US"}'
```

### 3. Bing APIs

**Bing Web:**
```bash
curl -X POST https://api.serphouse.com/bing-web \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"cloudflare workers","lang":"en","device":"desktop"}'
```

**Bing News:**
```bash
curl -X POST https://api.serphouse.com/bing-news \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"tech news","lang":"en","device":"desktop"}'
```

**Bing Image:**
```bash
curl -X POST https://api.serphouse.com/bing-image \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"nature wallpaper","lang":"en"}'
```

### 4. Yahoo APIs

**Yahoo Web:**
```bash
curl -X POST https://api.serphouse.com/yahoo-web \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"stock market","domain":"yahoo.com","lang":"en","device":"desktop"}'
```

**Yahoo News:**
```bash
curl -X POST https://api.serphouse.com/yahoo-news \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"world news","domain":"yahoo.com","lang":"en","device":"desktop"}'
```

**Yahoo Image:**
```bash
curl -X POST https://api.serphouse.com/yahoo-image \
  -H "Authorization: Bearer $SERPHOUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"sunset","domain":"yahoo.com","lang":"en"}'
```

### 5. Utility APIs

**Domains list:**
```bash
curl "https://api.serphouse.com/domain/list?api_token=$SERPHOUSE_API_KEY"
```

**Languages list:**
```bash
curl "https://api.serphouse.com/language/list/google?api_token=$SERPHOUSE_API_KEY"
```

**Location search:**
```bash
curl "https://api.serphouse.com/location/search?q=new+york&type=google&api_token=$SERPHOUSE_API_KEY"
```

**Account info:**
```bash
curl "https://api.serphouse.com/account/info?api_token=$SERPHOUSE_API_KEY"
```

### 6. Webhooks & Callbacks

- **Pingback:** SERPHouse calls your `pingback_url` via GET when a scheduled task completes. You then call `GET /serp/get?id=` to retrieve the result.
- **Postback:** SERPHouse POSTs the full result JSON to your `postback_url` when the task finishes. No polling needed.

**Configure at:** https://www.serphouse.com/wehook-setting

---

## Rate Limits

| Plan | Requests/min |
|------|-------------|
| Free Trial | 60 |
| Basic | 60 |
| Regular | 60 |
| Custom | As needed |

Returns `429 Too Many Requests` when exceeded.

---

## Important Notes

- **`*` = required field** in all parameter lists
- **Credit cost:** Most searches = 1 credit/page. Google Autocomplete = 5 credits. Google Advanced (top-100) = 10 credits/page.
- **Device values:** `desktop` or `mobile`
- **serp_type values:** `web`, `news`, `image`, `video`, `shopping`, `local`, `places`, `books`, `scholar`
- **Pagination:** `page` + `num` for standard pagination; `max_pages` for Google Advanced (top-100)

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [SERPHouse](https://github.com/SERPHouse)
- **Source:** [SERPHouse/agent-skills](https://github.com/SERPHouse/agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-serphouse-agent-skills-api
- Seller: https://agentstack.voostack.com/s/serphouse
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.