Web Search

POST /search/web

Search the web using Google Custom Search. Returns structured results with titles, URLs, snippets, and dates.

Costs 1 utility call per request.

Request

{
  "query": "user onboarding pain points",
  "site": "reddit.com",
  "date_restrict": "m6",
  "num_results": 10
}
FieldTypeRequiredDescription
querystringyesSearch query
sitestringnoRestrict results to a specific domain (e.g., reddit.com)
date_restrictstringnoRestrict by recency: d7 (7 days), m6 (6 months), y1 (1 year)
num_resultsintegernoNumber of results to return (1–50, default 10)

Response

{
  "results": [
    {
      "title": "Why do SaaS onboarding flows suck?",
      "url": "https://www.reddit.com/r/SaaS/comments/...",
      "snippet": "I've been evaluating 20 different SaaS products and the onboarding is consistently...",
      "date": "2026-02-10"
    }
  ],
  "total_results": 8420,
  "query": "user onboarding pain points"
}
FieldTypeDescription
resultsarrayList of search results
results[].titlestringPage title
results[].urlstringPage URL
results[].snippetstringText excerpt
results[].datestringPublication date (when available)
total_resultsintegerEstimated total results matching the query
querystringThe query that was executed

Example: site-scoped search

curl -X POST https://api.noodlespy.com/search/web \
  -H "Authorization: Bearer nspy_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best CRM for startups",
    "site": "reddit.com",
    "num_results": 20
  }'