# Example Requests

### Gemini Scraper API example request

Use this Gemini Scraper API example to send a basic prompt with the NetNut LLM Scraper.

This page shows a cURL request, a sample Gemini response, and the main response fields returned by the API.

Gemini performs AI-powered web retrieval and synthesis, returning a structured answer with citations and contextual signals.

***

#### cURL request

```bash
curl -X POST https://llm-scraper.netnut.io/search \
  -U "username:password" \
  -H "Content-Type: application/json" \
  -d '{
    "engine": "gemini",
    "prompt": "what are the leading SEO tips in 2026"
  }'
```

***

#### Example Gemini response

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

```json
{
  "timestamp": "2026-04-13T14:16:13.543Z",
  "traceID": "121da7f7-c8c8-42bc-980e-a1f0a07961e8",
  "request_duration": 18.56,
  "process_duration": 18.56,
  "scraper": "Gemini",
  "response": {
    "prompt": "what are the leading SEO tips in 2026",
    "text": "In 2026, SEO has shifted from \"ranking for keywords\" to \"optimizing for visibility across the AI ecosystem.\" With Google's AI Overviews (formerly SGE) and search assistants like ChatGPT and Claude siphoning up to 60% of clicks for informational queries, the strategy is no longer just about being #1-it's about being the cited source. Here are the leading SEO tips for 2026: Generative Engine Optimization (GEO) Traditional SEO focused on links; GEO focuses on being \"extractable\" for AI...",
    "text_markdown": "In 2026, SEO has shifted from \"ranking for keywords\" to \"optimizing for visibility across the AI ecosystem.\"\n\n### 1. Generative Engine Optimization (GEO)\n* **Answer-First Formatting:** Lead your articles with a concise, 2-3 sentence direct answer.\n* **Modular Content:** Use clear headings, bulleted lists, and tables.\n* **Schema Markup Everything:** Use FAQ, HowTo, and Product schema.\n\n### 2. Double Down on E-E-A-T (Experience is King)\n* **Proof of Human Effort:** Include original photos, case studies, and personal anecdotes.\n* **Verified Authorship:** Robust author bio linked to social profiles and credentials.\n\n### 3. Build \"Entity\" Authority, Not Just Keywords\n* **Brand Mentions Matter More Than Links:** High-authority site mentions can outweigh no-follow links.\n* **Topical Clusters:** Build Content Hubs covering every sub-question of a topic.\n\n### 4. Optimize for \"Zero-Click\" & Multi-Surface Search\n* **Conversational Long-Tails:** Optimize for how people talk, not just how they type.\n* **Visual Search:** Optimize image ALT text and use high-resolution, original imagery.\n\n### 5. Technical SEO: Interaction over Speed\n* **UX Stability:** Eliminate layout shifts and intrusive pop-ups.\n* **Engagement Depth:** High \"dwell time\" on a page is a massive ranking signal.",
    "citations_found": true,
    "citations": [
      {
        "id": 1,
        "url": "https://www.mandr-group.com/the-future-of-seo-how-ai-is-changing-content-strategy-in-2026/",
        "title": "The Future of SEO: How AI Is Changing Content Strategy in 2026 - M&R Marketing",
        "description": "SEO Is No Longer About Ranking on Search—It's About Visibility Across AI-Powered Platforms.",
        "section": "citations"
      },
      {
        "id": 2,
        "url": "https://thistle.media/how-will-googles-ai-search-sge-reshape-seo-strategies-by-2026/",
        "title": "How Will Google's AI Search (SGE) Reshape SEO Strategies by 2026? - Thistle Media",
        "description": "Visibility is no longer just about ranking first; it's about being referenced, cited, and trusted by AI systems.",
        "section": "citations"
      },
      {
        "id": 3,
        "url": "https://www.yotpo.com/blog/google-trends-seo-strategy/",
        "title": "Google Trends For SEO In 2026: The Velocity Playbook - Yotpo",
        "description": "In 2026, optimization involves considering both the human user and the Synthesizer—the AI model constructing the answer.",
        "section": "citations"
      }
    ]
  }
}
```

***

#### Response fields

In this Gemini Scraper response:

* `engine` selects the Gemini scraper through the `engine` request field.
* `prompt` contains the original prompt sent to the LLM Scraper API.
* `text` returns the plain-text Gemini answer.
* `text_markdown` returns the same answer in markdown format.
* `citations_found` shows whether Gemini returned source citations.
* `citations` lists the source URLs, titles, and metadata used in the 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/gemini/example-requests.md?ask=<question>
```

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.
