# PinDL - Pinterest Media Downloader

> High-performance, SEO-optimized web tool and Chrome extension built on Next.js to parse and download media files (videos, images, and GIFs) from Pinterest without watermarks.

## Key Features

- [Home / Downloader](https://pindl.4kb.in/) - Main web-based downloader tool.
- [Image Downloader](https://pindl.4kb.in/en/image-downloader) - Specific tool optimized for downloading Pinterest images.
- [GIF Downloader](https://pindl.4kb.in/en/gif-downloader) - Specific tool optimized for downloading Pinterest GIFs.
- [Chrome Extension Setup](https://pindl.4kb.in/en/download-extension) - Setup guide for the PinDL Chrome/Firefox extension.
- [Full Documentation](https://pindl.4kb.in/llms-full.txt) - Complete text-based context for AI models (contains README, Design, and Roadmap).

## Dynamic Pages & Support

- [Frequently Asked Questions](https://pindl.4kb.in/en/faq) - FAQ list for the downloader and browser extension.
- [Device Guides](https://pindl.4kb.in/en/device) - Operating system and browser download guides.
- [Comparison Hub](https://pindl.4kb.in/en/compare) - Performance and capability comparisons against other downloaders.
- [Regional Landing Pages](https://pindl.4kb.in/en/country) - Localized and geo-targeted entry pages.
- [Blog Index](https://pindl.4kb.in/en/blog) - Dynamic localized blog hub for guides and tutorials.

## API Specification

- [Download Endpoint](https://pindl.4kb.in/api/download) - POST endpoint for parsing and resolving media URLs.
- [Extension Resolve Endpoint](https://pindl.4kb.in/api/extension/resolve) - GET endpoint for extension lookup requests.

### Download Request Schema
- **Endpoint**: `POST /api/download`
- **Body Schema (JSON)**:
  ```json
  {
    "url": "string (Pinterest link)",
    "turnstileToken": "string (Optional Cloudflare Turnstile token)"
  }
  ```
- **Response Schema (Success)**:
  ```json
  {
    "id": "string (Pin ID)",
    "title": "string",
    "description": "string",
    "thumbnailUrl": "string (Direct CDN URL)",
    "type": "video | image | gif",
    "outputs": [
      {
        "url": "string (Direct CDN download link)",
        "quality": "string (e.g. 1080p, Original, SD)",
        "format": "mp4 | gif | jpg",
        "width": 1920,
        "height": 1080
      }
    ]
  }
  ```

### Extension Resolve Request Schema
- **Endpoint**: `GET /api/extension/resolve?url=<url>`
- **Response**: Same as Download Request Schema (cached lookup completed under 150ms).

## Developer Policy & Limits

- Rate limits are active on all public endpoints: 30 requests/minute and 200 requests/day per anonymized client IP.
- Free to use online; no registration required. All downloads process directly from Pinterest CDNs.