pinterest-dl 1.0.0 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71ad1b053f92b611430a8e44a0a678037daa37577afaa1a0ff5dd04a3f53329b
-  data.tar.gz: 2754556eacec0edfcb5f52700773bc9d725597c01c6f512f692fd1eff3c706ac
+  metadata.gz: 73cae48cd87360325168ee188b8a67b25944402f33857a61dee4ea3a13457f91
+  data.tar.gz: 313a17fd00772aa8980ee8389dc5bd934b8217225f4e4b11f130ad4882e629c0
 SHA512:
-  metadata.gz: 55f78b7fe0ffb4d69f17f65b5bdf580d985a8418780145a8717c2a166c61ba123c3de7e64ed6cea1394bc6588db3c0279fe07e621403f0155f71c52eaef3b34b
-  data.tar.gz: b662d4914cd490516c54f5c0e6b8b42476c6781e65b7a97846381a1be596295725b3525187338d8a62cee79b46b6d9bdf322ab3c26d66bf752d49027290aae43
+  metadata.gz: e08fc0e08bec2a47a91659d10b1ba3a87e6d2c70e81fc27134366768108ebf3e1a5f10bfea2dc3391c63fa038eb9daba58594ffd8c5997338b240dd21fcaa558
+  data.tar.gz: 7bcfe71875c82f31ddaf9e27a0f648b646bb6381045830d03d6ee0a8fb561283e8a0eb4e85036915a6d71e6f5865e05f0aa4a5e0658f601b593f8e5a6f42f714

data/README.md

@@ -1,12 +1,29 @@
+<div align="center">
+
 # pinterest-dl
 
-Get direct image and video URLs from Pinterest:)
+---
 
+[![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">
 
-```ruby
-gem install pinterest-dl
+</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
@@ -15,11 +32,45 @@ gem install pinterest-dl
 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)
 
-# Get image url
-url = PinterestDL.get_image_url('link')
-# => "https://i.pinimg.com/originals/8e/2a/..."
+## License
 
-# Get video url
-url = PinterestDL.get_video_url('link')
-# => "https://v.pinimg.com/videos/..."
+MIT © [monji024](https://github.com/monji024)

data/lib/pinterest-dl.rb

@@ -1,8 +1,7 @@
 #!/usr/bin/env ruby
-# pinterest-dl.rb
 # Pinterest downloader
 # creator: Monji 
-# ver: 1.0.0
+# ver: 1.0.3
 # github: https://github.com/monji024/pinterest-dl
 
 require 'net/http'
@@ -12,11 +11,10 @@ require 'openssl'
 
 
 module PinterestDL
-  ver = '1.0.0'.freeze
-  craetor  = 'Monji'.freeze
+  ver = '1.0.3'.freeze
   github  = 'https://github.com/monji024/pinterest-dl'.freeze
 
-  puts "pinterest-dl v#{ver} by #{craetor} (#{github})\n\n"
+  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
 
@@ -28,7 +26,6 @@ module PinterestDL
       # 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
@@ -36,7 +33,6 @@ module PinterestDL
         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
@@ -46,8 +42,7 @@ module PinterestDL
         puts "#{green}image url :#{reset} #{url}"
         return url
       end
-
-      puts 'No found'
+      puts 'No found:)'
       nil
     end
 
@@ -63,7 +58,6 @@ module PinterestDL
         puts "ok : #{url}"
         return url
       end
-
       # 2 -> Open Graph video
       match = html.match(%r{<meta[^>]*property="og:video"[^>]*content="([^"]+)"})
       if match
@@ -71,7 +65,6 @@ module PinterestDL
         puts "video url: #{url}"
         return url
       end
-
       # 3 -> contentUrl in page source
       match = html.match(/"contentUrl"\s*:\s*"([^"]+\.mp4[^"]*)"/)
       if match
@@ -85,7 +78,76 @@ module PinterestDL
       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)
@@ -95,9 +157,7 @@ module PinterestDL
       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']
@@ -107,11 +167,9 @@ module PinterestDL
         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
@@ -123,7 +181,6 @@ module PinterestDL
     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?
@@ -133,4 +190,4 @@ module PinterestDL
       nil
     end
   end
-end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: pinterest-dl
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.3
 platform: ruby
 authors:
 - Monji
 bindir: bin
 cert_chain: []
-date: 2026-02-12 00:00:00.000000000 Z
+date: 2026-07-28 00:00:00.000000000 Z
 dependencies: []
 description: Simple Pinterest Downloader Tool:)
 email: hoseinmonjiofficial@gmail.com
@@ -39,5 +39,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 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: []