Perplexity

This document provides information about the API and the available POST parameters.

The LLM Scraper enables retrieval of Perplexity responses and returns a structured JSON output.

API Setup

Endpoint

https://llm-scraper.netnut.io/search

Authentication

Use HTTP Basic Authentication:

Authorization: Basic <base64(username:password)>

Where <base64(username:password)> is the Base64-encoded string of your NetNut credentials.

Request Body Schema

{
  "prompt": "Explain SEO ranking factors in 2025",   // Required
  "engine": "perplexity",                            // Required
  "country": "us",                                   // Optional
}

Field Descriptions

Field

Description

Parameter Type

prompt

Main prompt sent to Perplexity. Max length: 4096 chars.

Required

country

Target geographic region for contextual responses.

Optional

engine

The chatbot engine to use. Currently "chatgpt", "google_ai_mode" and "perplexity" are supported.

Required(default: chatgpt)

Example Usage

curl -X POST https://llm-scraper.netnut.io/search \
  -H "Content-Type: application/json" \
  -U "username:password" \
  -d '{
    "prompt": "Give me SEO trends for 2025",
    "engine": "perplexity",
    "country": "uk"
  }'

import requests
from base64 import b64encode

headers = {
    "Authorization": "Basic " + b64encode(b"username:password").decode(),
    "Content-Type": "application/json"
}

body = {
    "prompt": "Give me SEO trends for 2025",
    "country": "us",
    "engine": "google-ai-mode",
}

response = requests.post("https://llm-scraper.netnut.io/search", headers=headers, json=body)
print(response.json())

const username = 'your_username';
const password = 'your_password';
const auth = Buffer.from(`${username}:${password}`).toString('base64');

const headers = {
  'Authorization': `Basic ${auth}`,
  'Content-Type': 'application/json'
};

const body = {
  prompt: 'Give me SEO trends for 2025', 
  engine: "google-ai-mode",
  country: 'us'
};

fetch('https://llm-scraper.netnut.io/search', {
  method: 'POST',
  headers: headers,
  body: JSON.stringify(body)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error.message));

Response Format

The perplexity Scraper always returns structured JSON. No HTML is returned.

Example JSON Response

{
    "timestamp": "2026-02-28T12:54:34.613Z",
    "traceID": "aaa11111-2bbb-1234-a1b2-83f481f038bc",
    "request_duration": 8.84,
    "process_duration": 8.84,
     "scraper": "Perplexity",
    "llm_model": "gpt-5.4",
    "response": {
        "prompt": "what are the leading SEO tips in 2026",
        "text_markdown": "Here are the leading SEO tips for 2026, based on industry consensus and practical benchmarks:\n\n- Focus on semantic, intent-driven content\n  - Build topic clusters around core themes and map content to user intents (informational, navigational, transactional). This helps search engines understand your expertise and improves coverage across related queries.([SEO in 2026 Expert Tips and Predictions][1], [SEO in 2026: 17 Expert Tips & Predictions][7])\n\n- Embrace AI-assisted, structured optimization\n  - Use AI to surface gaps, generate content briefs, and optimize on-page elements, while maintaining human oversight for accuracy and quality. Prioritize structured data, entity linking, and schema where relevant to improve visibility in rich results.([The Future of SEO: What Marketers Must Prepare for in 2026][6], [SEO in 2026: 17 Expert Tips & Predictions][7])\n\n- Prioritize quality signals over sheer volume\n  - Invest in expert-backed content, robust E-A-T signals (expert author bios, credible sources, transparent publishing processes), and trust-building elements like citations and reviews. This remains a differentiator as search quality rises.([Top 9 Tips to Build Your SEO Strategy in 2026][3], [The Future of SEO: What Marketers Must Prepare for in 2026][6])\n\n- Master on-page and technical fundamentals\n  - Ensure fast, mobile-friendly experiences with proper server setup (HTTPS, caching), accessible design, and clean URL structures. Well-optimized titles, meta descriptions, headers, alt text, and internal linking support crawlability and user experience.([Top 9 Tips to Build Your SEO Strategy in 2026][3])\n\n- Leverage video and multimedia\n  - Create and optimize video content, use video schema, and adapt long-form text into videos or short-form formats to meet rising demand for visual/search-enabled experiences.([Top 10 SEO Tips for 2026 I Have Discovered So Far in January][5], [15 SEO Trends You Can't Ignore in 2026 | Envisionit][9])\n\n- Build brand signals and digital PR\n  - Brand authority and non-link mentions increasingly influence rankings. Focus on media coverage, expert roundups, podcasts, and earned coverage to strengthen recognition and trust.([Top 10 SEO Tips for 2026 I Have Discovered So Far in January][5], [The Future of SEO: What Marketers Must Prepare for in 2026][6])\n\n- Local and “geo-aware” optimization\n  - For location-based audiences, optimize Google Business Profile, local schema, and localized content. Build relationships with local publishers to earn regionally relevant signals.([15 SEO Trends You Can't Ignore in 2026 | Envisionit][9], [Top 10 SEO Tips for 2026 I Have Discovered So Far in January][5])\n\n- Optimize for “Search Everywhere” and AI discovery\n  - Structure content to be discoverable across surfaces (knowledge panels, snippets, answer boxes) and design content ecosystems that AI systems can easily map to entities and relationships.([SEO in 2026: 17 Expert Tips & Predictions][7], [15 SEO Trends You Can't Ignore in 2026 | Envisionit][9])\n\n- Elevate user experience and engagement\n  - Improve core web vitals, reduce friction in conversions, and create engaging, useful experiences that encourage dwell time and return visits. UX signals continue to correlate with ranking and conversions.([SEO in 2026 Expert Tips and Predictions][1], [The Future of SEO: What Marketers Must Prepare for in 2026][6])\n\n- Data-driven measurement and iteration\n  - Use dashboards to track impressions, click-through rates, dwell time, and task completion. Refresh and expand content quarterly to maintain relevance and capture new search intent.([SEO in 2026: 17 Expert Tips & Predictions][7], [SEO in 2026 Expert Tips and Predictions][1])\n\nIllustration: Example strategic framework\n- Create a central topic hub for “AI in marketing” with subtopics like AI tools, ethics, case studies, and ROI metrics.\n- Attach structured data (FAQ, how-to, product schemas) to boost eligibility for rich results.\n- Build internal links from hub to subtopics to reinforce semantic relationships.\n- Monitor performance and refresh assets every 3–6 months, adding new questions based on user intent shifts.\n\nIf you’d like, I can tailor these tips to your site or industry, or produce a one-page 2026 SEO plan with a content matrix and a quarterly refresh schedule. \n\nCitations:\n- The emphasis on semantic SEO, topic clustering, and entity optimization aligns with expert perspectives on 2026 SEO practices.([SEO in 2026 Expert Tips and Predictions][1], [SEO in 2026: 17 Expert Tips & Predictions][7])\n- The importance of structured data, rich results, and on-page signals is repeatedly recommended by industry analyses.([The Future of SEO: What Marketers Must Prepare for in 2026][6], [SEO in 2026: 17 Expert Tips & Predictions][7])\n- Brand signals, digital PR, and local optimization are highlighted as evolving ranking factors in 2026 discussions.([Top 10 SEO Tips for 2026 I Have Discovered So Far in January][5], [The Future of SEO: What Marketers Must Prepare for in 2026][6])",
        "text": "Here are the leading SEO tips for 2026, based on industry consensus and practical benchmarks: Focus on semantic, intent-driven content Build topic clusters around core themes and map content to user intents (informational, navigational, transactional). This helps search engines understand your expertise and improves coverage across related queries. Embrace AI-assisted, structured optimization Use AI to surface gaps, generate content briefs, and optimize on-page elements, while maintaining human oversight for accuracy and quality. Prioritize structured data, entity linking, and schema where relevant to improve visibility in rich results. Prioritize quality signals over sheer volume Invest in expert-backed content, robust E-A-T signals (expert author bios, credible sources, transparent publishing processes), and trust-building elements like citations and reviews. This remains a differentiator as search quality rises. Master on-page and technical fundamentals Ensure fast, mobile-friendly experiences with proper server setup (HTTPS, caching), accessible design, and clean URL structures. Well-optimized titles, meta descriptions, headers, alt text, and internal linking support crawlability and user experience. Leverage video and multimedia Create and optimize video content, use video schema, and adapt long-form text into videos or short-form formats to meet rising demand for visual/search-enabled experiences. Build brand signals and digital PR Brand authority and non-link mentions increasingly influence rankings. Focus on media coverage, expert roundups, podcasts, and earned coverage to strengthen recognition and trust. Local and “geo-aware” optimization For location-based audiences, optimize Google Business Profile, local schema, and localized content. Build relationships with local publishers to earn regionally relevant signals. Optimize for “Search Everywhere” and AI discovery Structure content to be discoverable across surfaces (knowledge panels, snippets, answer boxes) and design content ecosystems that AI systems can easily map to entities and relationships. Elevate user experience and engagement Improve core web vitals, reduce friction in conversions, and create engaging, useful experiences that encourage dwell time and return visits. UX signals continue to correlate with ranking and conversions. Data-driven measurement and iteration Use dashboards to track impressions, click-through rates, dwell time, and task completion. Refresh and expand content quarterly to maintain relevance and capture new search intent. Illustration: Example strategic framework Create a central topic hub for “AI in marketing” with subtopics like AI tools, ethics, case studies, and ROI metrics. Attach structured data (FAQ, how-to, product schemas) to boost eligibility for rich results. Build internal links from hub to subtopics to reinforce semantic relationships. Monitor performance and refresh assets every 3-6 months, adding new questions based on user intent shifts. If you’d like, I can tailor these tips to your site or industry, or produce a one-page 2026 SEO plan with a content matrix and a quarterly refresh schedule. Citations: The emphasis on semantic SEO, topic clustering, and entity optimization aligns with expert perspectives on 2026 SEO practices. The importance of structured data, rich results, and on-page signals is repeatedly recommended by industry analyses. Brand signals, digital PR, and local optimization are highlighted as evolving ranking factors in 2026 discussions.",
        "citations": [
            {
                "id": 1,
                "url": "https://key-g.com/blog/seo-in-2026-17-expert-tips-and-predictions/",
                "title": "SEO in 2026 Expert Tips and Predictions",
                "description": "Explore 2026 SEO with 17 expert tips and predictions: AI-influenced ranking signals, content quality, technical fixes, and practical, data-driven optimization tactics.",
                "section": "citations"
            },
            {
                "id": 2,
                "url": "https://www.reddit.com/r/SEOorganic/comments/1nx7cpm/seo_2026_predictions_trends_you_cant_ignore/",
                "title": "SEO 2026 Predictions: Trends You Can’t Ignore",
                "description": "SEO 2026 Predictions: Trends You Can’t Ignore",
                "section": "citations"
            },...
        ],
        "inline_citations": [
            {
                "id": 1,
                "url": "https://key-g.com/blog/seo-in-2026-17-expert-tips-and-predictions/",
                "title": "SEO in 2026 Expert Tips and Predictions",
                "text_anchor": "search engines understand your expertise and improves coverage across related queries."
            },
            {
                "id": 2,
                "url": "https://sitebulb.com/resources/guides/seo-in-2026-17-expert-tips-predictions/",
                "title": "SEO in 2026: 17 Expert Tips & Predictions",
                "text_anchor": "search engines understand your expertise and improves coverage across related queries."
            },....
        ],
        "citations_found": true,
        "follow_ups": [
            "Which SEO strategies will dominate 2026",
            "How to optimize for E-E-A-T in 2026",
            "Best SEO tools to use this year",
            "What are 2026 Google's algorithm focus areas",
            "How to measure SEO ROI in 2026"
        ],
        "media_items": [
            {
                "type": "video",
                "title": "SEO for 2026: The Complete Guide",
                "url": "https://img.youtube.com/vi/FC-bF9_FN9M/maxresdefault.jpg",
                "source_url": "https://www.youtube.com/watch?v=FC-bF9_FN9M"
            }
        ]
    }
}

PreviousExample Requests NextFeatures

Last updated 8 days ago

{ "timestamp": "2026-02-28T12:54:34.613Z", "traceID": "aaa11111-2bbb-1234-a1b2-83f481f038bc", "request_duration": 8.84, "process_duration": 8.84, "scraper": "Perplexity", "llm_model": "gpt-5.4", "response": { "prompt": "what are the leading SEO tips in 2026", "text_markdown": "Here are the leading SEO tips for 2026, based on industry consensus and practical benchmarks:\n\n- Focus on semantic, intent-driven content\n - Build topic clusters around core themes and map content to user intents (informational, navigational, transactional). This helps search engines understand your expertise and improves coverage across related queries.([SEO in 2026 Expert Tips and Predictions][1], [SEO in 2026: 17 Expert Tips & Predictions][7])\n\n- Embrace AI-assisted, structured optimization\n - Use AI to surface gaps, generate content briefs, and optimize on-page elements, while maintaining human oversight for accuracy and quality. Prioritize structured data, entity linking, and schema where relevant to improve visibility in rich results.([The Future of SEO: What Marketers Must Prepare for in 2026][6], [SEO in 2026: 17 Expert Tips & Predictions][7])\n\n- Prioritize quality signals over sheer volume\n - Invest in expert-backed content, robust E-A-T signals (expert author bios, credible sources, transparent publishing processes), and trust-building elements like citations and reviews. This remains a differentiator as search quality rises.([Top 9 Tips to Build Your SEO Strategy in 2026][3], [The Future of SEO: What Marketers Must Prepare for in 2026][6])\n\n- Master on-page and technical fundamentals\n - Ensure fast, mobile-friendly experiences with proper server setup (HTTPS, caching), accessible design, and clean URL structures. Well-optimized titles, meta descriptions, headers, alt text, and internal linking support crawlability and user experience.([Top 9 Tips to Build Your SEO Strategy in 2026][3])\n\n- Leverage video and multimedia\n - Create and optimize video content, use video schema, and adapt long-form text into videos or short-form formats to meet rising demand for visual/search-enabled experiences.([Top 10 SEO Tips for 2026 I Have Discovered So Far in January][5], [15 SEO Trends You Can't Ignore in 2026 | Envisionit][9])\n\n- Build brand signals and digital PR\n - Brand authority and non-link mentions increasingly influence rankings. Focus on media coverage, expert roundups, podcasts, and earned coverage to strengthen recognition and trust.([Top 10 SEO Tips for 2026 I Have Discovered So Far in January][5], [The Future of SEO: What Marketers Must Prepare for in 2026][6])\n\n- Local and “geo-aware” optimization\n - For location-based audiences, optimize Google Business Profile, local schema, and localized content. Build relationships with local publishers to earn regionally relevant signals.([15 SEO Trends You Can't Ignore in 2026 | Envisionit][9], [Top 10 SEO Tips for 2026 I Have Discovered So Far in January][5])\n\n- Optimize for “Search Everywhere” and AI discovery\n - Structure content to be discoverable across surfaces (knowledge panels, snippets, answer boxes) and design content ecosystems that AI systems can easily map to entities and relationships.([SEO in 2026: 17 Expert Tips & Predictions][7], [15 SEO Trends You Can't Ignore in 2026 | Envisionit][9])\n\n- Elevate user experience and engagement\n - Improve core web vitals, reduce friction in conversions, and create engaging, useful experiences that encourage dwell time and return visits. UX signals continue to correlate with ranking and conversions.([SEO in 2026 Expert Tips and Predictions][1], [The Future of SEO: What Marketers Must Prepare for in 2026][6])\n\n- Data-driven measurement and iteration\n - Use dashboards to track impressions, click-through rates, dwell time, and task completion. Refresh and expand content quarterly to maintain relevance and capture new search intent.([SEO in 2026: 17 Expert Tips & Predictions][7], [SEO in 2026 Expert Tips and Predictions][1])\n\nIllustration: Example strategic framework\n- Create a central topic hub for “AI in marketing” with subtopics like AI tools, ethics, case studies, and ROI metrics.\n- Attach structured data (FAQ, how-to, product schemas) to boost eligibility for rich results.\n- Build internal links from hub to subtopics to reinforce semantic relationships.\n- Monitor performance and refresh assets every 3–6 months, adding new questions based on user intent shifts.\n\nIf you’d like, I can tailor these tips to your site or industry, or produce a one-page 2026 SEO plan with a content matrix and a quarterly refresh schedule. \n\nCitations:\n- The emphasis on semantic SEO, topic clustering, and entity optimization aligns with expert perspectives on 2026 SEO practices.([SEO in 2026 Expert Tips and Predictions][1], [SEO in 2026: 17 Expert Tips & Predictions][7])\n- The importance of structured data, rich results, and on-page signals is repeatedly recommended by industry analyses.([The Future of SEO: What Marketers Must Prepare for in 2026][6], [SEO in 2026: 17 Expert Tips & Predictions][7])\n- Brand signals, digital PR, and local optimization are highlighted as evolving ranking factors in 2026 discussions.([Top 10 SEO Tips for 2026 I Have Discovered So Far in January][5], [The Future of SEO: What Marketers Must Prepare for in 2026][6])", "text": "Here are the leading SEO tips for 2026, based on industry consensus and practical benchmarks: Focus on semantic, intent-driven content Build topic clusters around core themes and map content to user intents (informational, navigational, transactional). This helps search engines understand your expertise and improves coverage across related queries. Embrace AI-assisted, structured optimization Use AI to surface gaps, generate content briefs, and optimize on-page elements, while maintaining human oversight for accuracy and quality. Prioritize structured data, entity linking, and schema where relevant to improve visibility in rich results. Prioritize quality signals over sheer volume Invest in expert-backed content, robust E-A-T signals (expert author bios, credible sources, transparent publishing processes), and trust-building elements like citations and reviews. This remains a differentiator as search quality rises. Master on-page and technical fundamentals Ensure fast, mobile-friendly experiences with proper server setup (HTTPS, caching), accessible design, and clean URL structures. Well-optimized titles, meta descriptions, headers, alt text, and internal linking support crawlability and user experience. Leverage video and multimedia Create and optimize video content, use video schema, and adapt long-form text into videos or short-form formats to meet rising demand for visual/search-enabled experiences. Build brand signals and digital PR Brand authority and non-link mentions increasingly influence rankings. Focus on media coverage, expert roundups, podcasts, and earned coverage to strengthen recognition and trust. Local and “geo-aware” optimization For location-based audiences, optimize Google Business Profile, local schema, and localized content. Build relationships with local publishers to earn regionally relevant signals. Optimize for “Search Everywhere” and AI discovery Structure content to be discoverable across surfaces (knowledge panels, snippets, answer boxes) and design content ecosystems that AI systems can easily map to entities and relationships. Elevate user experience and engagement Improve core web vitals, reduce friction in conversions, and create engaging, useful experiences that encourage dwell time and return visits. UX signals continue to correlate with ranking and conversions. Data-driven measurement and iteration Use dashboards to track impressions, click-through rates, dwell time, and task completion. Refresh and expand content quarterly to maintain relevance and capture new search intent. Illustration: Example strategic framework Create a central topic hub for “AI in marketing” with subtopics like AI tools, ethics, case studies, and ROI metrics. Attach structured data (FAQ, how-to, product schemas) to boost eligibility for rich results. Build internal links from hub to subtopics to reinforce semantic relationships. Monitor performance and refresh assets every 3-6 months, adding new questions based on user intent shifts. If you’d like, I can tailor these tips to your site or industry, or produce a one-page 2026 SEO plan with a content matrix and a quarterly refresh schedule. Citations: The emphasis on semantic SEO, topic clustering, and entity optimization aligns with expert perspectives on 2026 SEO practices. The importance of structured data, rich results, and on-page signals is repeatedly recommended by industry analyses. Brand signals, digital PR, and local optimization are highlighted as evolving ranking factors in 2026 discussions.", "citations": [ { "id": 1, "url": "https://key-g.com/blog/seo-in-2026-17-expert-tips-and-predictions/", "title": "SEO in 2026 Expert Tips and Predictions", "description": "Explore 2026 SEO with 17 expert tips and predictions: AI-influenced ranking signals, content quality, technical fixes, and practical, data-driven optimization tactics.", "section": "citations" }, { "id": 2, "url": "https://www.reddit.com/r/SEOorganic/comments/1nx7cpm/seo_2026_predictions_trends_you_cant_ignore/", "title": "SEO 2026 Predictions: Trends You Can’t Ignore", "description": "SEO 2026 Predictions: Trends You Can’t Ignore", "section": "citations" },... ], "inline_citations": [ { "id": 1, "url": "https://key-g.com/blog/seo-in-2026-17-expert-tips-and-predictions/", "title": "SEO in 2026 Expert Tips and Predictions", "text_anchor": "search engines understand your expertise and improves coverage across related queries." }, { "id": 2, "url": "https://sitebulb.com/resources/guides/seo-in-2026-17-expert-tips-predictions/", "title": "SEO in 2026: 17 Expert Tips & Predictions", "text_anchor": "search engines understand your expertise and improves coverage across related queries." },.... ], "citations_found": true, "follow_ups": [ "Which SEO strategies will dominate 2026", "How to optimize for E-E-A-T in 2026", "Best SEO tools to use this year", "What are 2026 Google's algorithm focus areas", "How to measure SEO ROI in 2026" ], "media_items": [ { "type": "video", "title": "SEO for 2026: The Complete Guide", "url": "https://img.youtube.com/vi/FC-bF9_FN9M/maxresdefault.jpg", "source_url": "https://www.youtube.com/watch?v=FC-bF9_FN9M" } ] } }

hashtagAPI Setup

hashtagEndpoint

hashtagAuthentication

hashtagRequest Body Schema

hashtagField Descriptions

hashtagExample Usage

hashtagResponse Format

hashtagExample JSON Response