NoodleSpy

/

Docs
llms.txtGet Started

Your First API Call

This guide gets you from zero to a working API call in under 2 minutes.

1. Get your API key

Sign up at noodlespy.com/sign-up and create an API key in your dashboard.

Your key looks like nspy_abc123.... You'll only see the full key once — save it somewhere safe.

2. Make a search request

The simplest endpoint is POST /search/web. It runs a Google Custom Search and returns structured results.

curl -X POST https://api.noodlespy.com/search/web \
  -H "Authorization: Bearer nspy_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best practices for user onboarding",
    "num_results": 5
  }'

3. Read the response

{
  "results": [
    {
      "title": "User Onboarding Best Practices in 2026",
      "url": "https://example.com/onboarding-guide",
      "snippet": "The most effective onboarding flows focus on...",
      "date": "2026-02-15"
    }
  ],
  "total_results": 12400,
  "query": "best practices for user onboarding"
}

Check the response headers for your remaining quota:

X-Usage-Remaining-Utility: 999

4. Try a site-scoped search

Target a specific site by adding the site parameter:

curl -X POST https://api.noodlespy.com/search/web \
  -H "Authorization: Bearer nspy_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "onboarding pain points",
    "site": "reddit.com",
    "num_results": 10
  }'

Next steps