pinterest-dl 1.0.1 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 27626810a9014457fd993c95652b1705437df4c008e4df3586bdea8baf0b7e65
-  data.tar.gz: ddb835faccb168517d3ff36ef36e1d601094d23ebb29b8f36b12473d67ffd62f
+  metadata.gz: 73cae48cd87360325168ee188b8a67b25944402f33857a61dee4ea3a13457f91
+  data.tar.gz: 313a17fd00772aa8980ee8389dc5bd934b8217225f4e4b11f130ad4882e629c0
 SHA512:
-  metadata.gz: c945ee342ddd919339e480708d7d9f88710e56841f7e5d744c878a4c88c68ad53e37383b9f71a2a333a858a5874ed50f0d0c1f77552b60e87ca9d5dbcbf38800
-  data.tar.gz: 53d172562e998a79ef4931ce716850be86a86ba13cb9b5c875b4bc2e77fdc77a0f4fa7b5f2c80d71b392130b6f7566411793e696ffe2de45c74507a8d5442bbd
+  metadata.gz: e08fc0e08bec2a47a91659d10b1ba3a87e6d2c70e81fc27134366768108ebf3e1a5f10bfea2dc3391c63fa038eb9daba58594ffd8c5997338b240dd21fcaa558
+  data.tar.gz: 7bcfe71875c82f31ddaf9e27a0f648b646bb6381045830d03d6ee0a8fb561283e8a0eb4e85036915a6d71e6f5865e05f0aa4a5e0658f601b593f8e5a6f42f714

data/README.md

@@ -1,57 +1,76 @@
-<div align="center">
-
-# pinterest-dl
-
----
-
-[![Gem Downloads](https://img.shields.io/gem/dt/pinterest-dl)](https://rubygems.org/gems/pinterest-dl)
-[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)
-[![Ruby](https://img.shields.io/badge/Ruby-2.5+-red)]()
-
-
-<img src="https://img.icons8.com/color/96/000000/pinterest--v1.png" width="80">
-
-</div>
-
----
-
-Get direct image and video URLs from Pinterest:)
-
-![Demo](https://github.com/monji024/pinterest-dl/raw/main/test.gif)
-
-Using a VPN is important for those in Iran!!!
-
-## Installation
-
-```ruby
-gem install pinterest-dl
-```
-
-## Usage
-
-```ruby
-require 'pinterest-dl'
-```
-
-### Get image url
-
-```ruby
-url = PinterestDL.get_image_url('https://www.pinterest.com/pin/example/')
-# => "https://i.pinimg.com/originals/8e/2a/..."
-```
-
-###  Get video url
-
-```ruby
-url = PinterestDL.get_video_url('https://www.pinterest.com/pin/example/')
-# => "https://v.pinimg.com/videos/..."
-```
-
-##  Links
-
-- [RubyGem](https://rubygems.org/gems/pinterest-dl)
-- [GitHub](https://github.com/monji024/pinterest-dl)
-
-##  License
-
+<div align="center">
+
+# pinterest-dl
+
+---
+
+[![Gem Downloads](https://img.shields.io/gem/dt/pinterest-dl)](https://rubygems.org/gems/pinterest-dl)
+[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)
+[![Ruby](https://img.shields.io/badge/Ruby-2.5+-red)](https://www.ruby-lang.org/)
+
+<img src="https://img.icons8.com/color/96/000000/pinterest--v1.png" width="80">
+
+</div>
+
+---
+
+Get direct image and video URLs from Pinterest.
+
+![Demo](https://github.com/monji024/pinterest-dl/raw/main/test.gif)
+
+> **Note:** Users in Iran may need a VPN to access Pinterest.
+
+## Installation
+
+```bash
+gem install pinterest-dl
+```
+
+## Usage
+
+```ruby
+require 'pinterest-dl'
+```
+
+### Get Image URL
+
+```ruby
+url = PinterestDL.get_image_url('https://www.pinterest.com/pin/example/')
+```
+
+### Get Video URL
+
+```ruby
+url = PinterestDL.get_video_url('https://www.pinterest.com/pin/example/')
+```
+
+### Search Pins
+
+```ruby
+# Search for pins with a specific query
+results = PinterestDL.search('nature landscape', limit: 10)
+
+# Returns an array of pin objects with:
+# id, pin_url, title, description, image_url, video_url
+
+# Get only image URLs from search results
+images = PinterestDL.search_images('sunset', limit: 5)
+# => ["https://i.pinimg.com/originals/...", ...]
+
+# Get only video URLs from search results
+videos = PinterestDL.search_videos('tutorial', limit: 3)
+# => ["https://v.pinimg.com/videos/...", ...]
+
+# Get search results as JSON
+json_results = PinterestDL.search_json('anime art', limit: 20)
+# => Returns formatted JSON string
+```
+
+## Links
+
+- [RubyGems](https://rubygems.org/gems/pinterest-dl)
+- [GitHub](https://github.com/monji024/pinterest-dl)
+
+## License
+
 MIT © [monji024](https://github.com/monji024)

data/lib/pinterest-dl.rb

@@ -1,135 +1,193 @@
-#!/usr/bin/env ruby
-# pinterest-dl.rb
-# Pinterest downloader
-# creator: Monji 
-# ver: 1.0.0
-# github: https://github.com/monji024/pinterest-dl
-
-require 'net/http'
-require 'uri'
-require 'json'
-require 'openssl'
-
-
-module PinterestDL
-  ver = '1.0.0'.freeze
-  github  = 'https://github.com/monji024/pinterest-dl'.freeze
-
-  puts "pinterest-dl v#{ver} (#{github})\n\n"
-
-  USER_AGENT = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36'.freeze
-
-  class << self
-    def get_image_url(pin_url)
-      html = fetch_html(pin_url)
-      return nil unless html
-
-      # 1 -> json-ld
-      url = extract_json_ld(html, 'ImageObject')
-      return url if url
-
-      # 2 -> open graph
-      match = html.match(%r{<meta[^>]*property="og:image"[^>]*content="([^"]+)"})
-      if match
-        url = match[1]
-        puts "image url: #{url}"
-        return url
-      end
-
-      # 3 -> direct i.pinimg.com patterns
-      match = html.match(%r{https://i\.pinimg\.com/(?:originals|474x|236x|736x)/[^"\s]+})
-      if match
-        url = match[0]
-        reset = "\e[0m"
-        green = "\e[32m"
-        puts "#{green}image url :#{reset} #{url}"
-        return url
-      end
-
-      puts 'No found'
-      nil
-    end
-
-
-    def get_video_url(pin_url)
-      html = fetch_html(pin_url)
-      return nil unless html
-
-      # 1 -> json-ld
-      url = extract_json_ld(html, 'VideoObject')
-      if url
-        url = url.gsub('\\u002F', '/').gsub('\\', '')
-        puts "ok : #{url}"
-        return url
-      end
-
-      # 2 -> Open Graph video
-      match = html.match(%r{<meta[^>]*property="og:video"[^>]*content="([^"]+)"})
-      if match
-        url = match[1].gsub('\\u002F', '/').gsub('\\', '')
-        puts "video url: #{url}"
-        return url
-      end
-
-      # 3 -> contentUrl in page source
-      match = html.match(/"contentUrl"\s*:\s*"([^"]+\.mp4[^"]*)"/)
-      if match
-        url = match[1].gsub('\\u002F', '/').gsub('\\', '')
-        green = "\e[32m"
-        reset = "\e[0m"
-        puts "#{green}video url :#{reset} #{url}"
-        return url
-      end
-
-      puts 'No found'
-      nil
-    end
-
-    private
-
-    def fetch_html(url)
-      uri = URI(url)
-      http = Net::HTTP.new(uri.host, uri.port)
-      http.use_ssl = (uri.scheme == 'https')
-      http.max_retries = 2
-      http.open_timeout = 10
-      http.read_timeout = 20
-
-      resp = http.request(Net::HTTP::Head.new(uri, 'User-Agent' => USER_AGENT))
-
-      5.times do
-        break unless resp.is_a?(Net::HTTPRedirection)
-        location = resp['location']
-        location = URI.join(uri.to_s, location) if location.start_with?('/')
-        uri = URI(location)
-        http = Net::HTTP.new(uri.host, uri.port)
-        http.use_ssl = (uri.scheme == 'https')
-        resp = http.request(Net::HTTP::Head.new(uri, 'User-Agent' => USER_AGENT))
-      end
-
-      # get final page
-      req = Net::HTTP::Get.new(uri, 'User-Agent' => USER_AGENT)
-      resp = http.request(req)
-
-      return resp.body if resp.is_a?(Net::HTTPSuccess)
-      nil
-    rescue StandardError => e
-      red = "\e[31m"
-      reset = "\e[0m"
-      puts "#{red}http err!:#{reset} #{e.message}"
-      nil
-    end
-    def extract_json_ld(html, type)
-      match = html.match(%r{<script[^>]*type="application/ld\+json"[^>]*>(.*?)</script>}m)
-      return nil unless match
-
-      begin
-        data = JSON.parse(match[1])
-        data = data[0] if data.is_a?(Array) && !data.empty?
-        return data['contentUrl'] if data['@type'] == type && data['contentUrl']
-      rescue JSON::ParserError
-      end
-      nil
-    end
-  end
-end
+#!/usr/bin/env ruby
+# Pinterest downloader
+# creator: Monji 
+# ver: 1.0.3
+# github: https://github.com/monji024/pinterest-dl
+
+require 'net/http'
+require 'uri'
+require 'json'
+require 'openssl'
+
+
+module PinterestDL
+  ver = '1.0.3'.freeze
+  github  = 'https://github.com/monji024/pinterest-dl'.freeze
+
+  puts "pinterest-dl v#{ver} (#{github})\n\n"
+
+  USER_AGENT = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36'.freeze
+
+  class << self
+    def get_image_url(pin_url)
+      html = fetch_html(pin_url)
+      return nil unless html
+
+      # 1 -> json-ld
+      url = extract_json_ld(html, 'ImageObject')
+      return url if url
+      # 2 -> open graph
+      match = html.match(%r{<meta[^>]*property="og:image"[^>]*content="([^"]+)"})
+      if match
+        url = match[1]
+        puts "image url: #{url}"
+        return url
+      end
+      # 3 -> direct i.pinimg.com patterns
+      match = html.match(%r{https://i\.pinimg\.com/(?:originals|474x|236x|736x)/[^"\s]+})
+      if match
+        url = match[0]
+        reset = "\e[0m"
+        green = "\e[32m"
+        puts "#{green}image url :#{reset} #{url}"
+        return url
+      end
+      puts 'No found:)'
+      nil
+    end
+
+
+    def get_video_url(pin_url)
+      html = fetch_html(pin_url)
+      return nil unless html
+
+      # 1 -> json-ld
+      url = extract_json_ld(html, 'VideoObject')
+      if url
+        url = url.gsub('\\u002F', '/').gsub('\\', '')
+        puts "ok : #{url}"
+        return url
+      end
+      # 2 -> Open Graph video
+      match = html.match(%r{<meta[^>]*property="og:video"[^>]*content="([^"]+)"})
+      if match
+        url = match[1].gsub('\\u002F', '/').gsub('\\', '')
+        puts "video url: #{url}"
+        return url
+      end
+      # 3 -> contentUrl in page source
+      match = html.match(/"contentUrl"\s*:\s*"([^"]+\.mp4[^"]*)"/)
+      if match
+        url = match[1].gsub('\\u002F', '/').gsub('\\', '')
+        green = "\e[32m"
+        reset = "\e[0m"
+        puts "#{green}video url :#{reset} #{url}"
+        return url
+      end
+
+      puts 'No found'
+      nil
+    end
+    def search(query, limit: 25)
+      source_path = "/search/pins/?q=#{URI.encode_www_form_component(query)}"
+      home_uri = URI("https://www.pinterest.com#{source_path}")
+      http = Net::HTTP.new(home_uri.host, home_uri.port)
+      http.use_ssl = true
+      http.open_timeout = 10
+      http.read_timeout = 20
+      home_req = Net::HTTP::Get.new(home_uri, 'User-Agent' => USER_AGENT)
+      home_resp = http.request(home_req)
+      cookies = (home_resp.get_fields('set-cookie') || []).map { |c| c.split(';').first }
+      cookie_header = cookies.join('; ')
+      csrf = cookies.find { |c| c.start_with?('csrftoken=') }&.split('=', 2)&.last || 'undefined'
+      data = {
+        options: { query: query, scope: 'pins', page_size: limit },
+        context: {}}.to_json
+      res_uri = URI('https://www.pinterest.com/resource/BaseSearchResource/get/')
+      res_uri.query = URI.encode_www_form('source_url' => source_path, 'data' => data)
+      req = Net::HTTP::Get.new(res_uri)
+      req['User-Agent'] = USER_AGENT
+      req['Accept'] = 'application/json, text/javascript, */*, q=0.01'
+      req['X-Requested-With'] = 'XMLHttpRequest'
+      req['X-Pinterest-PWS-Handler'] = 'www/search/[scope].js'
+      req['X-CSRFToken'] = csrf
+      req['Referer'] = home_uri.to_s
+      req['Cookie'] = cookie_header
+      resp = http.request(req)
+      unless resp.is_a?(Net::HTTPSuccess)
+        puts "\e[31msearch http err!:\e[0m #{resp.code}"
+        return []
+      end
+      json = begin
+        JSON.parse(resp.body)
+      rescue JSON::ParserError
+        nil
+      end
+      return [] unless json
+      raw_results = (json.dig('resource_response', 'data', 'results') || []).first(limit)
+      pins = raw_results.filter_map do |r|
+        id = r['id']
+        next nil unless id
+        orig_image = r.dig('images', 'orig', 'url')
+        fallback_image = r['images']&.values&.map { |v| v.is_a?(Hash) ? v['url'] : nil }&.compact&.last
+        image_url = orig_image || fallback_image
+        video_url = r.dig('videos', 'video_list')&.values&.first&.dig('url')
+        {
+          id: id,
+          pin_url: "https://www.pinterest.com/pin/#{id}/",
+          title: r['title'] || r['grid_title'],
+          description: r['description'],
+          image_url: image_url,
+          video_url: video_url
+        }
+      end
+      green = "\e[32m"
+      reset = "\e[0m"
+      puts "#{green}found #{pins.size} pin(s) for \"#{query}\"#{reset}"
+      pins
+    rescue StandardError => e
+      puts "\e[31msearch err!:\e[0m #{e.message}"
+      []
+    end
+    def search_json(query, limit: 25)
+      JSON.pretty_generate(search(query, limit: limit))
+    end
+    def search_images(query, limit: 25)
+      search(query, limit: limit).filter_map { |p| p[:image_url] }
+    end
+    def search_videos(query, limit: 25)
+      search(query, limit: limit).filter_map { |p| p[:video_url] }
+    end
+    private
+
+    def fetch_html(url)
+      uri = URI(url)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = (uri.scheme == 'https')
+      http.max_retries = 2
+      http.open_timeout = 10
+      http.read_timeout = 20
+      resp = http.request(Net::HTTP::Head.new(uri, 'User-Agent' => USER_AGENT))
+      5.times do
+        break unless resp.is_a?(Net::HTTPRedirection)
+        location = resp['location']
+        location = URI.join(uri.to_s, location) if location.start_with?('/')
+        uri = URI(location)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = (uri.scheme == 'https')
+        resp = http.request(Net::HTTP::Head.new(uri, 'User-Agent' => USER_AGENT))
+      end
+      # get final page
+      req = Net::HTTP::Get.new(uri, 'User-Agent' => USER_AGENT)
+      resp = http.request(req)
+      return resp.body if resp.is_a?(Net::HTTPSuccess)
+      nil
+    rescue StandardError => e
+      red = "\e[31m"
+      reset = "\e[0m"
+      puts "#{red}http err!:#{reset} #{e.message}"
+      nil
+    end
+    def extract_json_ld(html, type)
+      match = html.match(%r{<script[^>]*type="application/ld\+json"[^>]*>(.*?)</script>}m)
+      return nil unless match
+      begin
+        data = JSON.parse(match[1])
+        data = data[0] if data.is_a?(Array) && !data.empty?
+        return data['contentUrl'] if data['@type'] == type && data['contentUrl']
+      rescue JSON::ParserError
+      end
+      nil
+    end
+  end
+end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: pinterest-dl
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.3
 platform: ruby
 authors:
 - Monji
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-28 00:00:00.000000000 Z
+date: 2026-07-28 00:00:00.000000000 Z
 dependencies: []
 description: Simple Pinterest Downloader Tool:)
 email: hoseinmonjiofficial@gmail.com
@@ -24,7 +23,6 @@ licenses:
 metadata:
   source_code_uri: https://github.com/monji024/pinterest-dl
   bug_tracker_uri: https://github.com/monji024/pinterest-dl/issues
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -39,8 +37,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.3
 specification_version: 4
-summary: Extract direct image/video URLs from Pinterest!!!
+summary: Extract direct image/video/search URLs from Pinterest!!!
 test_files: []