# Example Requests ### 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 \ -U "username:password" \ -H "Content-Type: application/json" \ -d '{ "engine": "chatgpt", "prompt": "what is the best headphones in 2025", "web_search": true }' ``` **Example Response:** > Example shape – your actual `traceID`, timestamps, and content will vary. 
{
  "traceID": "f2c90481-f71d-4896-8588-dcee9ea7f482",
  "model": "gpt-5.2",
  "timestamp": "2025-12-08T11:39:19.269Z",
  "request_duration": 22.29,
  "process_duration": 22.29,

  "response": {
    "prompt": "what is the best headphones in 2025",

    "text_markdown": "Here are some of the **best headphones you can buy in 2025**, based on expert reviews:\n\n### Sony WH-1000XM6\n*$399.99*\n\n### Bose QuietComfort Ultra\n*$399.00*\n\nLet me know if you want recommendations by use case.",

    "text": "Here are some of the best headphones you can buy in 2025, including Sony WH-1000XM6 and Bose QuietComfort Ultra. These models are widely praised for sound quality, comfort, and noise cancellation.",
    
    "model_search_queries": [
            "best headphones 2025 reviews and ranking",
            "top headphones to buy in 2025 best headphones list"
        ],
        
    "widgets": [
      {
        "type": "product_carousel",
        "items": [
          {
            "type": "product_card",
            "name": "Sony WH-1000XM6 Wireless Noise Canceling Headphones",
            "price": 399.99,
            "currency": "$",
            "merchant": "Sony + others"
          },
          {
            "type": "product_card",
            "name": "Bose QuietComfort Ultra Wireless Headphones",
            "price": 399.00,
            "currency": "$",
            "merchant": "Bose + others"
          }
        ]
      }
    ],

    "citations_found": true,
    "citations": [
      {
        "id": "1",
        "title": "The Best Headphones of 2025",
        "url": "https://example.com/best-headphones-2025",
        "section": "citations"
      },
      {
        "id": "2",
        "title": "Top Noise Cancelling Headphones in 2025",
        "url": "https://example.com/noise-cancelling-headphones-2025",
        "section": "more"
      }
    ]
  },

  "raw_response": [
    "data: {\"type\":\"server_ste_metadata\",\"metadata\":{\"model_slug\":\"gpt-5.2\",\"cluster_region\":\"westus3\",\"request_id\":\"c4a36d48-5164-4168-ad18-4bfe82f59e95\"}}",
    "",
    "event: delta",
    "data: {\"v\":{\"metadata\":{\"search_model_queries\":{\"type\":\"search_model_queries\",\"queries\":[\"best headphones 2025 reviews and ranking\",\"top headphones to buy in 2025 best headphones list\"]}}}",
    "",
    "event: delta",
    "data: {\"v\":{\"metadata\":{\"search_result_groups\":[{\"domain\":\"example.com\",\"entries\":[{\"url\":\"https://example.com/article\",\"title\":\"Best headphones to buy in 2025\"}]}]}}}"
  ]
}
#### In this response: * `model` specifies the AI model used to generate the response (for example, `gpt-5.2`). * `text_markdown` contains the **full markdown-formatted answer**, including headings, lists, and emphasis. * `text` contains a **plain-text version** of the same content, with all markdown removed. * `model_search_queries` contains an array of search queries generated by the model during the request, reflecting how the original prompt was expanded or refined when performing web search or information retrieval. * `widgets` contains **structured UI components** extracted from the model output (such as product carousels and product cards). * `citations_found` indicates whether any sources were detected. * `citations` is a flat list of source objects, each tagged with: * `section: "citations"` for primary sources * `section: "more"` for additional references * `raw_response` contains the **raw streamed model output**, exactly as captured from the session before parsing.\ This includes server events, metadata, search fan-out queries, and intermediate results. *** #### 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)** Copy ``` curl -X POST https://llm-scraper.netnut.io/search\ -H "Authorization: Basic base64(username:password)" \ -H "Content-Type: application/json" \ -d '{ "engine": "chatgpt", "prompt": "what is the best seo tips for new companies", "web_search": true, "follow_up_prompt": "and what about ecommerce companies?" }' ``` **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. Copy ``` { "traceID": "ab36d428-bf83-441a-b458-385782a54ef3", "scraper": "ChatGPT scraper", "timestamp": "2025-12-10T12:41:31.760Z", "request_duration": 37.11, "process_duration": 37.11, "response": { "prompt": "what is the best seo tips for new companies", "text": "If you’re a new company (startup or small business) and want to do SEO right from the start — that’s a very smart move. Good SEO done early can pay off big over time. Here are **some of the best SEO tips** tailored especially for **new companies**. I grouped them into foundational principles and tactical steps you can take right away 👇\n\n---\n\n## ✅ Foundational SEO Principles for New Companies\n\n- **Think of SEO as a long-term investment, not a quick fix.**\nSEO rarely gives instant wins — but consistent good work builds compounding results...", "citations_found": true, "citations": [ { "id": 1, "url": "https://crowdo.net/blog/sturtup-seo?utm_source=chatgpt.com", "title": "A Complete Guide To SEO For Startups - Crowdo Blog", "date": "April 8, 2025", "section": "citations" }, { "id": 2, "url": "https://www.searchenginejournal.com/small-business-seo-improve-rankings/260141/?utm_source=chatgpt.com", "title": "Small Business SEO Checklist: 11 Ways To Improve Rankings", "date": "February 11, 2022", "section": "citations" }, { "id": 3, "url": "https://www.cloudways.com/blog/seo-for-startups/?utm_source=chatgpt.com", "title": "SEO for Startups: A Complete Guide for Startup Founders", "date": "August 11, 2018", "section": "citations" }, { "id": 4, "url": "https://www.novo.co/blog/seo-best-practices-for-small-business?utm_source=chatgpt.com", "title": "Small Business SEO Checklist: 9 Ways to Improve Rankings | Novo", "section": "citations" } // ... more citations and "more" entries ] }, "follow_up_response": { "prompt": "and what about ecommerce companies?", "text": "For an **ecommerce company**, SEO requires all the fundamentals of regular SEO *plus* a strong focus on product-focused optimization, site structure, and conversion elements. Here are the best, high-impact tips specifically for ecommerce:\n\n---\n\n## ✅ **1. Optimize Product Pages Thoroughly**\nEcommerce sites often have hundreds of product pages—each one is a ranking opportunity.\n\n**Key elements to optimize:**\n- Unique product titles and descriptions (avoid manufacturer copy)\n- High-quality images with descriptive ALT text\n- Clear product benefits and features...", "citations_found": false, "citations": [] } } ``` 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.netnut.io/netnut-documentation/netnut-scraper-apis/llm-scraper/chatgpt/example-requests.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.