Rename folder name for NSTProxy integration examples for crawl4ai

docs/examples/nst_proxy/api_proxy_example.py

@@ -0,0 +1,48 @@
+"""
+NSTProxy Integration Examples for crawl4ai
+------------------------------------------
+
+NSTProxy is a premium residential proxy provider.
+👉 Purchase Proxies: https://nstproxy.com
+💰 Use coupon code "crawl4ai" for 10% off your plan.
+
+"""
+import asyncio, requests
+from crawl4ai import AsyncWebCrawler, BrowserConfig
+
+
+async def main():
+    """
+    Example: Dynamically fetch a proxy from NSTProxy API before crawling.
+    """
+    NST_TOKEN = "YOUR_NST_PROXY_TOKEN"  # Get from https://app.nstproxy.com/profile
+    CHANNEL_ID = "YOUR_NST_PROXY_CHANNEL_ID"  # Your NSTProxy Channel ID
+    country = "ANY"  # e.g. "ANY", "US", "DE"
+
+    # Fetch proxy from NSTProxy API
+    api_url = (
+        f"https://api.nstproxy.com/api/v1/generate/apiproxies"
+        f"?fType=2&channelId={CHANNEL_ID}&country={country}"
+        f"&protocol=http&sessionDuration=10&count=1&token={NST_TOKEN}"
+    )
+    response = requests.get(api_url, timeout=10).json()
+    proxy = response[0]
+
+    ip = proxy.get("ip")
+    port = proxy.get("port")
+    username = proxy.get("username", "")
+    password = proxy.get("password", "")
+
+    browser_config = BrowserConfig(proxy_config={
+        "server": f"http://{ip}:{port}",
+        "username": username,
+        "password": password,
+    })
+
+    async with AsyncWebCrawler(config=browser_config) as crawler:
+        result = await crawler.arun(url="https://example.com")
+        print("[API Proxy] Status:", result.status_code)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())