postproxy-sdk 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 822ce030b347645daad188e55da76ab9a3494b0f7f01d0b6a78a02b4c9e933d6
-  data.tar.gz: 33dc5d8cf8e97817b9f6f69d8f57dd4dfd207ff1b8add0ba58661cddfd88f64f
+  metadata.gz: a9a60fab0c383896df7be59f688fb8692ab12eb60725d031fac50e76d7acc507
+  data.tar.gz: 38cc6ceda7bb03d4adb4e2bdfe7a27155ee0d4ef20b39d6d2b82d8e115284201
 SHA512:
-  metadata.gz: 8460f568b415ec00973fa57d9065a85a141fe16aafb430765054ae51ca0ee16c514a55c02f59c54b7983def183c9131c07c65a5db448976f05d9db2139243915
-  data.tar.gz: 64c079b04bbd82dde18a2c612000ad42f8525351326714243c923dfde21bba6e51125006169a36675301b2fde2857f94c54e74cab08ae406345bf1dd8a26e711
+  metadata.gz: b314e1009d278281897233d3059b3a04c29d2729a86d9f06299113d11cb973788b01a29bb9393e5ac8e9bf62a08f63e9de35eabcc8a033e943350d774236c24c
+  data.tar.gz: c2142242f1ee28e96152c6de5869aca4821de27f6eb7b756c05034d2546d80a941fa0fd530ec823b6d6b1fde5e9b77f88aecc6503998d5bd143dbdc54e8fca09

data/README.md

@@ -96,6 +96,56 @@ post = client.posts.create(
 client.posts.delete("post-id")
 ```
 
+## Post Stats
+
+Retrieve stats snapshots for posts over time. Supports filtering by profiles/networks and timespan.
+
+```ruby
+# Get stats for one or more posts
+stats = client.posts.stats(["post-id-1", "post-id-2"])
+stats.data.each do |post_id, post_stats|
+  post_stats.platforms.each do |platform|
+    puts "#{post_id} on #{platform.platform} (#{platform.profile_id}):"
+    platform.records.each do |record|
+      puts "  #{record.recorded_at}: #{record.stats}"
+    end
+  end
+end
+
+# Filter by profiles or networks
+stats = client.posts.stats(["post-id"], profiles: ["instagram", "twitter"])
+
+# Filter by profile hashids
+stats = client.posts.stats(["post-id"], profiles: ["prof-abc", "prof-def"])
+
+# Filter by time range
+stats = client.posts.stats(
+  ["post-id"],
+  from: "2026-02-01T00:00:00Z",
+  to: "2026-02-24T00:00:00Z"
+)
+
+# Using Time objects
+stats = client.posts.stats(
+  ["post-id"],
+  from: Time.now - 86400 * 7,
+  to: Time.now
+)
+```
+
+Stats vary by platform:
+
+| Platform | Fields |
+|----------|--------|
+| Instagram | `impressions`, `likes`, `comments`, `saved`, `profile_visits`, `follows` |
+| Facebook | `impressions`, `clicks`, `likes` |
+| Threads | `impressions`, `likes`, `replies`, `reposts`, `quotes`, `shares` |
+| Twitter | `impressions`, `likes`, `retweets`, `comments`, `quotes`, `saved` |
+| YouTube | `impressions`, `likes`, `comments`, `saved` |
+| LinkedIn | `impressions` |
+| TikTok | `impressions`, `likes`, `comments`, `shares` |
+| Pinterest | `impressions`, `likes`, `comments`, `saved`, `outbound_clicks` |
+
 ## Profiles
 
 ```ruby

data/lib/postproxy/resources/posts.rb

@@ -87,6 +87,19 @@ module PostProxy
         Post.new(**result)
       end
 
+      def stats(post_ids, profiles: nil, from: nil, to: nil)
+        params = { post_ids: post_ids.is_a?(Array) ? post_ids.join(",") : post_ids }
+        params[:profiles] = profiles.is_a?(Array) ? profiles.join(",") : profiles if profiles
+        params[:from] = format_time(from) if from
+        params[:to] = format_time(to) if to
+
+        result = @client.request(:get, "/posts/stats", params: params)
+        posts = (result[:data] || {}).each_with_object({}) do |(post_id, post_data), hash|
+          hash[post_id.to_s] = PostStats.new(**post_data.transform_keys(&:to_sym))
+        end
+        StatsResponse.new(data: posts)
+      end
+
       def delete(id, profile_group_id: nil)
         result = @client.request(:delete, "/posts/#{id}", profile_group_id: profile_group_id)
         DeleteResponse.new(**result)

data/lib/postproxy/types.rb

@@ -110,6 +110,56 @@ module PostProxy
     attr_accessor :id, :name
   end
 
+  class StatsRecord < Model
+    attr_accessor :stats, :recorded_at
+
+    def initialize(**attrs)
+      @stats = {}
+      @recorded_at = nil
+      super
+      @recorded_at = parse_time(@recorded_at)
+    end
+
+    private
+
+    def parse_time(value)
+      return nil if value.nil?
+      value.is_a?(Time) ? value : Time.parse(value.to_s)
+    end
+  end
+
+  class PlatformStats < Model
+    attr_accessor :profile_id, :platform, :records
+
+    def initialize(**attrs)
+      @records = []
+      super
+      @records = (@records || []).map do |r|
+        r.is_a?(StatsRecord) ? r : StatsRecord.new(**r.transform_keys(&:to_sym))
+      end
+    end
+  end
+
+  class PostStats < Model
+    attr_accessor :platforms
+
+    def initialize(**attrs)
+      @platforms = []
+      super
+      @platforms = (@platforms || []).map do |p|
+        p.is_a?(PlatformStats) ? p : PlatformStats.new(**p.transform_keys(&:to_sym))
+      end
+    end
+  end
+
+  class StatsResponse
+    attr_reader :data
+
+    def initialize(data:)
+      @data = data
+    end
+  end
+
   class ListResponse
     attr_reader :data
 

data/lib/postproxy/version.rb

@@ -1,3 +1,3 @@
 module PostProxy
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: postproxy-sdk
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - PostProxy