Google SERP

Google 搜尋、新聞、趨勢、財經與購物資料結構化 API。

搜尋：網頁搜尋結果，支援分頁
新聞：Google 新聞文章
趨勢：搜尋熱度隨時間變化
財經：股票行情資料
購物：商品列表，支援價格篩選

搜尋

`GET /google/search` — 2 點數

搜尋 Google 並取得結構化結果。

參數	類型	必填	預設	說明
`q`	string	是	—	搜尋關鍵字
`num`	integer	否	10	結果數量
`language`	string	否	`en`	語言代碼
`country`	string	否	`us`	國家代碼
`page`	integer	否	1	頁碼

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/google/search?q=openai&num=5"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/google/search",
    headers={"x-api-key": "sk_byc_xxx"},
    params={"q": "openai", "num": 5},
    timeout=30,
)
print(response.json())

JavaScript


const params = new URLSearchParams({ q: "openai", num: "5" });
const response = await fetch(
  `https://api.bycrawl.com/google/search?${params}`,
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

回應


{
  "query": "openai",
  "results": [
    {
      "title": "OpenAI",
      "url": "https://openai.com/",
      "description": "OpenAI is an AI research and deployment company..."
    }
  ],
  "totalResults": 10
}

新聞

`GET /google/news` — 2 點數

取得 Google 新聞搜尋結果。

參數	類型	必填	預設	說明
`q`	string	是	—	搜尋關鍵字
`language`	string	否	`en`	語言代碼
`country`	string	否	`us`	國家代碼

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/google/news?q=artificial+intelligence"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/google/news",
    headers={"x-api-key": "sk_byc_xxx"},
    params={"q": "artificial intelligence"},
    timeout=30,
)
print(response.json())

JavaScript


const params = new URLSearchParams({ q: "artificial intelligence" });
const response = await fetch(
  `https://api.bycrawl.com/google/news?${params}`,
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

回應


{
  "query": "artificial intelligence",
  "articles": [
    {
      "title": "AI Breakthrough in 2026...",
      "url": "https://example.com/article",
      "source": "TechCrunch",
      "publishedAt": "2026-03-24T10:00:00Z"
    }
  ]
}

趨勢

`GET /google/trends` — 2 點數

取得 Google Trends 搜尋趨勢資料。

參數	類型	必填	預設	說明
`q`	string	是	—	搜尋關鍵字
`timeframe`	string	否	`today 12-m`	時間範圍（如 `today 12-m`、`today 3-m`）
`geo`	string	否	—	地理區域（如 `US`、`GB`）
`category`	integer	否	0	分類 ID

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/google/trends?q=chatgpt&timeframe=today+3-m&geo=US"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/google/trends",
    headers={"x-api-key": "sk_byc_xxx"},
    params={"q": "chatgpt", "timeframe": "today 3-m", "geo": "US"},
    timeout=30,
)
print(response.json())

JavaScript


const params = new URLSearchParams({ q: "chatgpt", timeframe: "today 3-m", geo: "US" });
const response = await fetch(
  `https://api.bycrawl.com/google/trends?${params}`,
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

回應


{
  "query": "chatgpt",
  "timeframe": "today 3-m",
  "geo": "US",
  "interestOverTime": [
    { "date": "2026-01-01", "value": 75 },
    { "date": "2026-02-01", "value": 82 }
  ]
}

財經

`GET /google/finance` — 2 點數

取得股票行情資料。

參數	類型	必填	預設	說明
`ticker`	string	是	—	股票代碼（如 `AAPL`、`GOOGL`）

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/google/finance?ticker=AAPL"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/google/finance",
    headers={"x-api-key": "sk_byc_xxx"},
    params={"ticker": "AAPL"},
    timeout=30,
)
print(response.json())

JavaScript


const params = new URLSearchParams({ ticker: "AAPL" });
const response = await fetch(
  `https://api.bycrawl.com/google/finance?${params}`,
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

回應


{
  "ticker": "AAPL",
  "name": "Apple Inc",
  "price": 178.52,
  "change": 2.34,
  "changePercent": 1.33,
  "currency": "USD",
  "exchange": "NASDAQ"
}

購物

`GET /google/shopping` — 2 點數

搜尋 Google 購物商品。

參數	類型	必填	預設	說明
`q`	string	是	—	搜尋關鍵字
`num`	integer	否	20	結果數量
`min_price`	number	否	—	最低價格篩選
`max_price`	number	否	—	最高價格篩選
`country`	string	否	`us`	國家代碼

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/google/shopping?q=mechanical+keyboard&num=10&country=us"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/google/shopping",
    headers={"x-api-key": "sk_byc_xxx"},
    params={"q": "mechanical keyboard", "num": 10, "country": "us"},
    timeout=30,
)
print(response.json())

JavaScript


const params = new URLSearchParams({ q: "mechanical keyboard", num: "10", country: "us" });
const response = await fetch(
  `https://api.bycrawl.com/google/shopping?${params}`,
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

回應


{
  "query": "mechanical keyboard",
  "products": [
    {
      "title": "Keychron K2 Wireless Mechanical Keyboard",
      "price": 89.99,
      "currency": "USD",
      "source": "Amazon",
      "url": "https://...",
      "imageUrl": "https://..."
    }
  ],
  "totalResults": 20
}

Google SERP

搜尋

GET /google/search — 2 點數

cURL

Python

JavaScript

新聞

GET /google/news — 2 點數

cURL

Python

JavaScript

趨勢

GET /google/trends — 2 點數

cURL

Python

JavaScript

財經

GET /google/finance — 2 點數

cURL

Python

JavaScript

購物

GET /google/shopping — 2 點數

cURL

Python

JavaScript

`GET /google/search` — 2 點數

`GET /google/news` — 2 點數

`GET /google/trends` — 2 點數

`GET /google/finance` — 2 點數

`GET /google/shopping` — 2 點數