API Reference

Rate Meter

Inspect current account/global token-bucket rate state.

Overview

Rate meter exposes current token availability for account and global throttling buckets.

What You Will Learn

  • How to diagnose throttling headroom for one Pinterest account.
  • Difference between account and global buckets.
  • When to slow submission proactively.

Implementation Checklist

  • Read account and global bucket status before high-volume operations.
  • Apply client-side throttling when token headroom stays low.
  • Combine with webhook/job status data for better throughput tuning.

Relevant Endpoints

GET
/v1/rate-meter?account_id=<ACCOUNT_ID>

Return account/global token availability and refill rates.

Related Guides