# 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.