Skip to Content
API ReferenceGoogle SERP

Google SERP

Google Search, News, Trends, Finance, and Shopping data via structured API.

  • Search: Web search results with pagination
  • News: Google News articles
  • Trends: Interest over time data
  • Finance: Stock ticker data
  • Shopping: Product listings with price filters

GET /google/search — 2 credits

Search Google and get structured results.

ParamTypeRequiredDefaultDescription
qstringYesSearch query
numintegerNo10Number of results
languagestringNoenLanguage code
countrystringNousCountry code
pageintegerNo1Page number
curl -H "x-api-key: sk_byc_xxx" \ "https://api.bycrawl.com/google/search?q=openai&num=5"

Response

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

News

GET /google/news — 2 credits

Get Google News results for a query.

ParamTypeRequiredDefaultDescription
qstringYesSearch query
languagestringNoenLanguage code
countrystringNousCountry code
curl -H "x-api-key: sk_byc_xxx" \ "https://api.bycrawl.com/google/news?q=artificial+intelligence"

Response

{ "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 credits

Get Google Trends data for a query.

ParamTypeRequiredDefaultDescription
qstringYesSearch query
timeframestringNotoday 12-mTime range (e.g. today 12-m, today 3-m)
geostringNoGeographic region (e.g. US, GB)
categoryintegerNo0Category ID
curl -H "x-api-key: sk_byc_xxx" \ "https://api.bycrawl.com/google/trends?q=chatgpt&timeframe=today+3-m&geo=US"

Response

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

Finance

GET /google/finance — 2 credits

Get financial data for a stock ticker.

ParamTypeRequiredDefaultDescription
tickerstringYesStock ticker symbol (e.g. AAPL, GOOGL)
curl -H "x-api-key: sk_byc_xxx" \ "https://api.bycrawl.com/google/finance?ticker=AAPL"

Response

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

Shopping

GET /google/shopping — 2 credits

Search Google Shopping for products.

ParamTypeRequiredDefaultDescription
qstringYesSearch query
numintegerNo20Number of results
min_pricenumberNoMinimum price filter
max_pricenumberNoMaximum price filter
countrystringNousCountry code
curl -H "x-api-key: sk_byc_xxx" \ "https://api.bycrawl.com/google/shopping?q=mechanical+keyboard&num=10&country=us"

Response

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