Serphouse Api

SERPHouse API Skill

This skill equips the agent to search the web and scrape SERP data via the SERPHouse API. 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):

curl "https://api.serphouse.com/serp/live?q=best+coding+courses&serp_type=web&api_token=$SERPHOUSE_API_KEY"

Live POST search:

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):

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):

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:

curl "https://api.serphouse.com/serp/check?id=TASK_ID&api_token=$SERPHOUSE_API_KEY"

Get task result:

curl "https://api.serphouse.com/serp/get?id=TASK_ID&api_token=$SERPHOUSE_API_KEY"

2. Google APIs

Google Web Search:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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):

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:

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:

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:

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:

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:

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:

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:

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

Languages list:

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

Location search:

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

Account info:

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
• Source: SERPHouse/agent-skills
• License: MIT

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