NetNut Dashboard

Example Requests

Step-by-step examples demonstrating how to send prompts to the ChatGPT Scraper API, including basic requests, Web Search mode, and follow-up prompts.

Basic Request Example (Single Prompt)

In this example, we send a simple LLM Scraper request asking for SEO tips for companies. The request enables web_search so the model can enrich its answer with up-to-date information and citations.

Request

curl -X POST https://llm-scraper.netnut.io/search  \
  -H "Authorization: Basic <base64(username:password)>" \
  -H "Content-Type: application/json" \
  -d '{
    "engine": "chatgpt",
    "prompt": "whats are the best SEO tips for companies?",
    "web_search": true
  }'

Example Response (Single Prompt)

Example shape – your actual traceID, timestamps, and content will vary.

{
  "traceID": "43af00ae-7a3a-4d3d-810e-b51e12a6efdc",
  "scraper": "ChatGPT scraper",
  "timestamp": "2025-12-08T15:01:46.618Z",
  "request_duration": 19.2,
  "process_duration": 19.2,
  "response": {
    "prompt": "whats are the best SEO tips for companies?",
    "text": "Here are some of the **best SEO (Search Engine Optimization) tips for companies** — covering what works now (2024–2025) to boost visibility, traffic, authority, and user-experience. Good SEO isn’t a one-time task but an ongoing strategy.\n\n---\n\n## ✅ Core SEO Best Practices for Companies\n\n### **🎯 Understand your audience & search intent**\n\n- Do keyword research to figure out which words and phrases potential customers use when searching for products or services like yours.\n- Think about **search intent** — are users looking for general info (informational), trying to find your site (navigational), looking to buy (transactional), or comparing options (commercial)? Tailor your content accordingly.\n- Focus on **“information gain”** — create content that offers something unique (original research, insights, visuals, case studies), not just rehash what’s out there. That helps you stand out.\n\n### **📝 On-page content & structure: quality matters**\n\n- Write high-quality, valuable, and user-friendly content...",
    "citations_found": true,
    "citations": [
      {
        "id": 1,
        "url": "https://www.reddit.com/r/SEO/comments/q0ohlu/what_seo_tips_do_you_wish_you_knew_when_you_were/?utm_source=chatgpt.com",
        "title": "What SEO tips do you wish you knew when you were ...",
        "section": "citations"
      },
      {
        "id": 2,
        "url": "https://www.semrush.com/blog/seo-best-practices/?utm_source=chatgpt.com",
        "title": "10 SEO Best Practices to Help You Rank Higher",
        "section": "citations"
      },
      {
        "id": 3,
        "url": "https://backlinko.com/seo-strategy?utm_source=chatgpt.com",
        "title": "How to Create an Effective SEO Strategy in 2025",
        "section": "citations"
      },
      {
        "id": 4,
        "url": "https://developers.google.com/search/docs/fundamentals/seo-starter-guide?utm_source=chatgpt.com",
        "title": "SEO Starter Guide: The Basics | Google Search Central",
        "section": "more"
      }
      // ...
    ]
  }
}

In this response:

  • response.text contains the full markdown-formatted answer from ChatGPT.

  • citations_found indicates whether any sources were detected.

  • citations is a flat list of source objects, each tagged with section: "citations" or section: "more" depending on how they appeared in the ChatGPT UI.

Request with Additional Follow-Up Prompt

In this example, we send:

  • An initial prompt: best SEO tips for new companies.

  • An additional follow-up prompt: “and what about ecommerce companies?”.

The LLM Scraper runs both prompts within the same flow and returns:

  • response – main answer for the original prompt.

  • follow_up_response – answer to the follow-up prompt.

Request (Prompt + Additional Prompt)

Example Response (Prompt + Additional Prompt)

This is a real example payload from the system; line breaks in text are preserved as returned by the LLM.

In this response:

  • response holds the answer to the main prompt (“what is the best seo tips for new companies”).

  • follow_up_response holds the answer to the additional prompt (“and what about ecommerce companies?”).

  • Each block has its own:

    • prompt

    • text (markdown content)

    • citations_found

    • citations array (which may be empty for some follow-ups, as in this example).

This pattern is ideal for SEO customers who:

  • Ask a general question first (e.g., overall SEO tips).

  • Then add a more specific follow-up (e.g., ecommerce-specific tactics) and want both results in a single, structured response.

PreviousFeaturesNextOverview

Last updated