{
  "info": {
    "name": "Scrapegraph Ai — mcp.ai",
    "description": "REST API for the Scrapegraph Ai MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/scrapegraph_ai",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "scrapegraph_ai_convert_webpage_to_markdown_v2",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/convert/webpage/to/markdown/v2",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "convert",
            "webpage",
            "to",
            "markdown",
            "v2"
          ]
        },
        "description": "Tool to convert any webpage into clean, well-formatted Markdown with full parameter control. Use when you need advanced options like stealth mode, custom headers, or webhook notifications. Supports al",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"mock\": false,\n  \"steps\": \"\",\n  \"stream\": false,\n  \"headers\": {},\n  \"stealth\": false,\n  \"wait_ms\": 0,\n  \"branding\": false,\n  \"webhook_url\": \"\",\n  \"website_url\": \"\",\n  \"country_code\": \"\",\n  \"render_heavy_js\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_generate_schema",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/generate/schema",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "generate",
            "schema"
          ]
        },
        "description": "Generate or modify a JSON schema based on a search query for structured data extraction. Use when you need a schema template for scraping specific data fields.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"user_prompt\": \"\",\n  \"existing_schema\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_get_agentic_scraper_history",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/agentic/scraper/history",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "agentic",
            "scraper",
            "history"
          ]
        },
        "description": "Retrieve paginated history of agentic scraper jobs. Use to view past scraping requests, their status, and results.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"page_size\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_get_crawler_history",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/crawler/history",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "crawler",
            "history"
          ]
        },
        "description": "Retrieve the history of crawler jobs for your account. Returns paginated list of past crawler requests with their status, results, and metadata.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"page_size\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_get_credits",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/credits",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "credits"
          ]
        },
        "description": "Retrieve remaining and used credits for your ScrapeGraphAI account. Useful for checking credit availability before bulk scraping operations to avoid mid-run failures.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_get_endpoint_suggestions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/endpoint/suggestions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "endpoint",
            "suggestions"
          ]
        },
        "description": "Tool to get AI-powered suggestions for creating scraping endpoints. Use when you need to identify what data can be extracted from a website and how to structure the scraping logic.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"prompt\": \"\",\n  \"website_url\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_get_live_session_url",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/live/session/url",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "live",
            "session",
            "url"
          ]
        },
        "description": "Tool to get a URL for a live browser session. Use when you need to interact with a webpage in real-time through a controlled browser environment.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\",\n  \"timeout\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_get_markdownify_history",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/markdownify/history",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "markdownify",
            "history"
          ]
        },
        "description": "Tool to retrieve the history of markdownify webpage-to-Markdown conversion jobs. Use when you need to view past markdownify requests and their statuses.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"page_size\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_get_scrape_history",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/scrape/history",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "scrape",
            "history"
          ]
        },
        "description": "Retrieve the history of scrape jobs from your ScrapeGraphAI account. Use this to check the status of past scrapes, view results, and track credit usage.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"page_size\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_get_searchscraper_history",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/searchscraper/history",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "searchscraper",
            "history"
          ]
        },
        "description": "Get the history of searchscraper jobs with pagination support. Use this to retrieve past searchscraper requests, their status, and results.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"page_size\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_get_sitemap_history",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/sitemap/history",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "sitemap",
            "history"
          ]
        },
        "description": "Tool to retrieve the history of sitemap extraction jobs. Use when you need to view past sitemap extraction requests, their status, and results.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"page_size\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_get_smartscraper_history",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/smartscraper/history",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "smartscraper",
            "history"
          ]
        },
        "description": "Tool to retrieve the history of smartscraper jobs. Use when you need to view past scraping requests and their results.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"page_size\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_get_usage_timeline",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/usage/timeline",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "usage",
            "timeline"
          ]
        },
        "description": "Tool to retrieve usage timeline statistics for your ScrapeGraphAI account. Use when you need to visualize or analyze service usage patterns over time.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"days\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_get_webhook_logs",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/webhook/logs",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "webhook",
            "logs"
          ]
        },
        "description": "Tool to retrieve webhook delivery logs for a crawler job. Use when you need to check the status and history of webhook notifications sent for a specific crawler execution.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"crawler_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_list_scheduled_jobs",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/scheduled/jobs",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "scheduled",
            "jobs"
          ]
        },
        "description": "Retrieve a paginated list of all scheduled scraping jobs for your account. Use this action to view and manage your scheduled jobs, including their configuration, cron schedules, and active status. Sup",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"is_active\": \"\",\n  \"page_size\": 0,\n  \"service_type\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_markdownify_status",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/markdownify/status",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "markdownify",
            "status"
          ]
        },
        "description": "Check the status and retrieve results of a Markdownify webpage-to-Markdown conversion job. Use this action to poll for the status of an async Markdownify request started via SCRAPEGRAPH_AI_MARKDOWNIFY",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"request_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_save_endpoint",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/save/endpoint",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "save",
            "endpoint"
          ]
        },
        "description": "Tool to save custom scraping endpoint configurations to ScrapeGraphAI. Use when you need to create reusable scraping endpoints with specific parameters and extraction logic.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"suggestions\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_search_scraper",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/search/scraper",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "search",
            "scraper"
          ]
        },
        "description": "Perform AI-powered web searches with structured, parsed results. Some sites block scrapers and return empty bodies; treat these as unrecoverable for that URL. JS-rendered pages may yield incomplete co",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"mock\": false,\n  \"query\": \"\",\n  \"language\": \"\",\n  \"num_results\": 0,\n  \"extraction_mode\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_search_scraper_status",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/search/scraper/status",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "search",
            "scraper",
            "status"
          ]
        },
        "description": "Check the status and results of an asynchronous SearchScraper job.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"request_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_smart_crawler_status",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/smart/crawler/status",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "smart",
            "crawler",
            "status"
          ]
        },
        "description": "Check the status and retrieve results of a SmartCrawler web crawling job. Use this action to poll for completion and get the extracted content from a previously started SmartCrawler job. Returns the j",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"task_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_smart_scraper_start",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/smart/scraper/start",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "smart",
            "scraper",
            "start"
          ]
        },
        "description": "Start AI-powered web scraping with natural language extraction prompts. When `wait` is false (default), returns a `request_id`; poll for results using SCRAPEGRAPH_AI_SMART_SCRAPER_STATUS. Check `error",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"mock\": false,\n  \"wait\": false,\n  \"steps\": \"\",\n  \"cookies\": {},\n  \"headers\": {},\n  \"stealth\": false,\n  \"plain_text\": false,\n  \"total_pages\": 0,\n  \"user_prompt\": \"\",\n  \"website_url\": \"\",\n  \"website_html\": \"\",\n  \"output_schema\": {},\n  \"render_heavy_js\": false,\n  \"website_markdown\": \"\",\n  \"number_of_scrolls\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_smart_scraper_status",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/smart/scraper/status",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "smart",
            "scraper",
            "status"
          ]
        },
        "description": "Check the status and retrieve results of a SmartScraper web scraping job. Use this action to poll for completion after starting a SmartScraper job with wait=false. The request_id is returned by the St",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"request_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_start_smart_crawler",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/start/smart/crawler",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "start",
            "smart",
            "crawler"
          ]
        },
        "description": "Tool to start a multi-page web crawl using SmartCrawler for AI-powered data extraction. Use when you need to extract structured data from multiple pages of a website. Returns immediately with a task_i",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\",\n  \"depth\": 0,\n  \"rules\": {},\n  \"prompt\": \"\",\n  \"schema\": {},\n  \"breadth\": 0,\n  \"sitemap\": false,\n  \"stealth\": false,\n  \"max_pages\": 0,\n  \"batch_size\": 0,\n  \"webhook_url\": \"\",\n  \"cache_website\": false,\n  \"extraction_mode\": false,\n  \"render_heavy_js\": false,\n  \"same_domain_only\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_submit_feedback",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/submit/feedback",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "submit",
            "feedback"
          ]
        },
        "description": "Submit feedback and ratings for completed ScrapeGraphAI requests.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"rating\": 0,\n  \"request_id\": \"\",\n  \"feedback_text\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_submit_product_feedback",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/submit/product/feedback",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "submit",
            "product",
            "feedback"
          ]
        },
        "description": "Submit product feedback for ScrapeGraphAI. Use to provide ratings, comments, suggestions, and other feedback about the product itself.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"email\": \"\",\n  \"issues\": \"\",\n  \"rating\": 0,\n  \"company\": \"\",\n  \"disliked\": \"\",\n  \"use_cases\": \"\",\n  \"liked_most\": \"\",\n  \"setup_easy\": false,\n  \"can_contact\": false,\n  \"feedback_id\": \"\",\n  \"contact_method\": \"\",\n  \"how_discovered\": \"\",\n  \"recommend_score\": 0,\n  \"usage_frequency\": \"\",\n  \"requested_features\": \"\",\n  \"improvement_suggestions\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_toonify",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/toonify",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "toonify"
          ]
        },
        "description": "Tool to convert JSON data to TOON (Token-Oriented Object Notation) format. Use when you need to reduce token usage for LLM processing while maintaining data structure.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "scrapegraph_ai_validate_api_key",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/validate/api/key",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "validate",
            "api",
            "key"
          ]
        },
        "description": "Validate your ScrapeGraphAI API key to ensure it is active and authorized. Use this action to check API key validity before making other API calls.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}