TL;DR, szybka odpowiedź
8 min czytaniaPinterest stosuje jednocześnie dwa pułapy. Uniwersalny to 1 000 zapytań dziennie przy dostępie Trial i 100 zapytań na sekundę na użytkownika i aplikację przy Standard. Faktycznie wiążący jest limit kategorii, a tworzenie Pinów podlega pod org_write: 300 dziennie w Trial i 100 na minutę w Standard. Każdy endpoint w opublikowanej specyfikacji Pinteresta dokumentuje odpowiedź 429, której treść to tylko kod i komunikat, a Pinterest nie publikuje dla niej numerycznego kodu błędu. Poniższe liczby sprawdzono 12 września 2026.
Jaki jest limit zapytań API Pinteresta?
Limit zapytań API Pinteresta wyznaczają dwa pułapy, a zatrzymuje cię ten niższy: limit uniwersalny, obowiązujący wszystkie zapytania, oraz limit kategorii, który Pinterest nakłada dodatkowo. Dokumentacja limitów podaje wartości uniwersalne jako "Trial access: 1000 requests per day for all API requests" oraz "Standard access: 100 requests per second per user per app for all API requests."
Jednostka zmienia się wraz z poziomem dostępu i to właśnie ten szczegół większość integracji interpretuje błędnie. Strona poziomów dostępu Pinteresta mówi wprost: "Apps with Trial access are rate limited based on calls per day/per app", natomiast "Apps with Standard access are rate limited at a more granular level at calls per minute/per user/per app." Aplikacja Trial ma jeden wspólny budżet dzienny, niezależnie od liczby obsługiwanych kont. Aplikacja Standard dostaje osobny budżet minutowy dla każdego połączonego użytkownika.
Każdy endpoint należy do dokładnie jednej kategorii limitów, a kategoria jest podana w opisie OpenAPI Pinteresta w polu x-ratelimit-category. Na tej samej stronie Pinterest ostrzega też, że "all rate limits are subject to change without notice."
Jakie limity Pinterest stosuje w poszczególnych kategoriach?
Własne wartości ma dwanaście kategorii. Liczby dla Trial to zapytania dziennie na aplikację, a dla Standard to zapytania na minutę na użytkownika i aplikację, chyba że wiersz podaje inaczej.
| Kategoria | Zakres | Trial (dziennie na aplikację) | Standard (na minutę na użytkownika i aplikację) |
|---|---|---|---|
ads_analytics | Dane analityczne o reklamach | 1 000 | 300 |
ads_conversions | Paczki zdarzeń konwersji | 1 000 na konto reklamowe i aplikację | 120 000 na konto reklamowe i aplikację |
ads_read | Odczyt reklam, grup reklam, kampanii i kont reklamowych | 1 000 | 1 000 |
ads_write | Tworzenie, edycja i usuwanie elementów reklamowych | 300 | 400 |
advanced_auction_read | Odczyt opcji stawek w aukcjach reklam | 1 000 | 50 |
advanced_auction_write | Operacje na elementach stawek w aukcjach reklam | 1 000 | 25 |
catalogs_read | Odczyt pozycji katalogu | 1 000 | 100 |
catalogs_write | Tworzenie i modyfikowanie pozycji katalogu | 1 000 | 100 |
org_analytics | Analityka użytkownika, informacje o koncie, najlepsze Piny | 1 000 | 60 |
org_read | Odczyt kont użytkowników, tablic, sekcji tablic i Pinów | 1 000 | 1 000 |
org_write | Tworzenie, edycja i usuwanie tablic, sekcji tablic lub Pinów | 300 | 100 |
trends_read | Informacje o popularnych słowach kluczowych | 1 000 | 60 |
Do której kategorii limitów należy publikacja Pina?
Publikowanie podlega pod org_write, czyli najciaśniejszy budżet, z jakim styka się narzędzie do planowania: 300 wywołań dziennie w Trial i 100 wywołań na minutę w Standard. Opublikowany przez Pinteresta opis OpenAPI, wersja 5.28.0 Pinterest REST API, oznacza każdą operację bezpośrednio:
| Operacja | Endpoint | Kategoria |
|---|---|---|
pins/create | POST /v5/pins | org_write |
pins/update | PATCH /v5/pins/{pin_id} | org_write |
pins/delete | DELETE /v5/pins/{pin_id} | org_write |
pins/save | POST /v5/pins/{pin_id}/save | org_write |
media/create | POST /v5/media | org_write |
boards/create | POST /v5/boards | org_write |
pins/list | GET /v5/pins | org_read |
boards/list | GET /v5/boards | org_read |
user_account/get | GET /v5/user_account | org_read |
pins/analytics | GET /v5/pins/{pin_id}/analytics | org_analytics |
user_account/analytics | GET /v5/user_account/analytics | org_analytics |
Pin wideo kosztuje dwa wywołania org_write zamiast jednego. media/create rejestruje przesyłanie i zwraca upload_url, sam plik trafia pod ten adres, a nie do API, a następnie pins/create dołącza gotowe multimedia. Przy dostępie Standard odczyt jest znacznie tańszy niż zapis (1 000 na minutę wobec 100), natomiast budżet analityki jest mniejszy od obu i wynosi 60 na minutę. Panel odpytujący statystyki 200 Pinów trafi na limit org_analytics dużo wcześniej, niż narzędzie publikujące dojdzie do limitu org_write.
Dzienny pułap Trial zaskakuje osoby budujące pierwszą integrację. Przy 300 wywołaniach org_write dziennie aplikacja w Trial może w ciągu 24 godzin utworzyć około 300 Pinów ze zdjęciem lub 150 Pinów wideo, wspólnie dla wszystkich połączonych kont. Ten budżet tłumaczy też sporą część przypadków, gdy podczas testów Pin nie zostaje opublikowany.

Gdzie liczby Pinteresta sobie przeczą
Pinterest publikuje wartości na dwóch stronach i w jednej specyfikacji, a te nie dają się ze sobą pogodzić. Zanim ustalisz przepustowość kolejki, warto znać trzy rozbieżności.
Uniwersalny limit Standard jest 60 razy wyższy od limitu kategorii poniżej niego. Strona limitów podaje, że dostęp Standard to "100 requests per second per user per app for all API requests", czyli 6 000 na minutę. Tabela kategorii na tej samej stronie ogranicza org_write do 100 na minutę. Wygrywa niższa liczba, a przykładowy nagłówek samego Pinteresta potwierdza, że jednocześnie egzekwowane jest więcej niż jedno okno:
< x-ratelimit-limit: 100, 100;w=1, 1000;w=60
< x-ratelimit-remaining: 99
< x-ratelimit-reset: 1Oznacza to 100 w oknie jednosekundowym i 1 000 w oknie sześćdziesięciosekundowym, czyli ani 6 000, ani 100.
Uniwersalny limit Trial jest wyższy niż dwa limity kategorii pod nim. Trial opisano jako "1000 requests per day for all API requests", a mimo to ads_write i org_write mają w tabeli kategorii po 300 dziennie.
Endpoint konwersji przeczy własnej kategorii. Strona limitów podaje dla ads_conversions przy dostępie Standard 120 000 zapytań na minutę na konto reklamowe i aplikację. Opis POST /v5/ad_accounts/{ad_account_id}/events, oznaczonego jako x-ratelimit-category: ads_conversions, mówi w opublikowanej specyfikacji Pinteresta: "This endpoint has a rate limit of 5,000 calls per minute per ad account." To 24-krotna różnica między dwoma źródłami Pinteresta dla tego samego endpointu.
W każdej z tych par przyjmuj mniejszą liczbę. Pinterest nie określa, która strona jest nadrzędna.

AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Jak wygląda odpowiedź 429 z Pinteresta?
Każdy endpoint w specyfikacji dokumentuje kod 429, opisany jako "the user has sent too many requests in a given amount of time and is being rate limited." Treścią odpowiedzi jest ogólny obiekt błędu Pinteresta, czyli dokument JSON z dokładnie dwoma wymaganymi polami:
{
"code": 2,
"message": "AdAccount not found."
}To przykład, który Pinterest zamieszcza w specyfikacji dla wspólnego schematu błędu, a nie przykład przekroczenia limitu. Lista kodów błędów Pinteresta obejmuje kody dla list klientów, grup odbiorców i feedów produktowych, ale nie podaje żadnego numerycznego code dla odpowiedzi 429. Specyfikacja nie dokumentuje nagłówka Retry-After ani nagłówków odpowiedzi x-ratelimit-* przy żadnym endpoincie, choć strona limitów pokazuje te nagłówki w przykładzie cURL. Traktuj nagłówki jako realne, a kod numeryczny jako nieudokumentowany, i opieraj logikę ponawiania na statusie HTTP, a nie na treści odpowiedzi.
Jak nie przekraczać limitów API Pinteresta?
Odczytuj liczniki, zamiast je zgadywać. Metoda opisana przez Pinteresta polega na wysyłaniu zapytań w trybie szczegółowym i sprawdzaniu odpowiedzi, na przykład curl -v --location --request GET 'https://api.pinterest.com/v5/pins' --header 'Authorization: Bearer <token>', a następnie śledzeniu x-ratelimit-remaining względem x-ratelimit-limit dla każdej kategorii, a nie dla całej aplikacji.
Cztery nawyki pomagają utrzymać integrację w budżecie:
- Planuj budżet na kategorię, a nie na integrację. Narzędzie publikujące, odpytywanie statystyk i synchronizacja katalogu korzystają osobno z
org_write,org_analyticsicatalogs_write, więc wyczerpanie jednego budżetu nie spowalnia pozostałych. - Rozkładaj zapisy w ramach minuty przy dostępie Standard. Przy 100 wywołaniach
org_writena minutę na użytkownika paczka 200 Pinów w kolejce jednego konta wymaga dwóch minut rozłożonej pracy. Ta sama arytmetyka rządzi budżetem punktów Bluesky i limitem 100 postów na 24 godziny na Instagramie. - Wyjdź z Trial przed startem. Trial ogranicza
org_writedo 300 dziennie dla całej aplikacji, a według strony poziomów dostępu Piny i tablice utworzone w Trial "are only visible to their creator as Sandbox entities", więc nic, co opublikujesz podczas testów, i tak nie będzie publiczne. - Poproś o więcej, gdy domyślne limity przestaną wystarczać. Pinterest wskazuje drogę przez zgłoszenie do zespołu wsparcia. W ten sam sposób zwolnisz miejsce w limicie pięciu aplikacji, o którym wspomina jego FAQ.
Jeśli rozkładasz kolejkę ręcznie, a nie przez klienta API, ta sama arytmetyka minutowa dotyczy zbiorczego planowania postów na Pintereście.
Najczęściej zadawane pytania
Ile Pinów dziennie mogę utworzyć przez API Pinteresta?
Przy dostępie Trial około 300, ponieważ pins/create podlega pod org_write, a Trial ogranicza tę kategorię do 300 zapytań dziennie na aplikację. Przy dostępie Standard nie ma opublikowanego limitu dziennego dla org_write, jest tylko 100 zapytań na minutę na użytkownika i aplikację, co przy stałym tempie daje 144 000 dziennie.
Czy limit API Pinteresta dotyczy aplikacji czy użytkownika?
Obu, zależnie od poziomu. Dostęp Trial jest liczony dziennie na aplikację, więc wszystkie połączone konta dzielą jeden budżet. Dostęp Standard jest liczony na minutę na użytkownika i aplikację, więc każde połączone konto ma własny.
Jaki kod HTTP zwraca Pinterest po przekroczeniu limitu?
429. Opis OpenAPI Pinteresta definiuje go przy każdym endpoincie z opisem "the user has sent too many requests in a given amount of time and is being rate limited", a treścią odpowiedzi jest ogólny obiekt błędu z polami code i message.
Które nagłówki pokazują pozostały limit API Pinteresta?
x-ratelimit-limit, x-ratelimit-remaining i x-ratelimit-reset. Strona limitów pokazuje je w szczegółowym przykładzie cURL, a x-ratelimit-limit zawiera w nim więcej niż jedno okno, na przykład 100, 100;w=1, 1000;w=60.
Czy Pinterest podaje wartość Retry-After w odpowiedziach 429?
Nie. Ani strona limitów, ani opublikowany opis OpenAPI nie definiują Retry-After przy żadnym endpoincie. Jedyną udokumentowaną informacją o czasie jest x-ratelimit-reset, w przykładzie Pinteresta z wartością 1.
Jak uzyskać wyższy limit API Pinteresta?
Przenieś aplikację na dostęp Standard, a następnie złóż zgłoszenie do wsparcia. Strona poziomów dostępu kieruje zmianę poziomu przez My apps i wymaga nagrania wideo procesu OAuth, a strona limitów odsyła osoby chcące dalszych zmian do zgłoszenia w pomocy technicznej Pinteresta.
Czy istnieje limit liczby aplikacji, które mogę zarejestrować na Pintereście?
FAQ Pinteresta wspomina o limicie pięciu aplikacji na konto deweloperskie. To samo zgłoszenie do wsparcia, którym prosi się o wyższy limit zapytań, pozwala zwolnić miejsce, gdy ten pułap przestanie wystarczać.
Czy Piny wideo zużywają więcej limitu niż Piny ze zdjęciem?
Pin wideo kosztuje dwa wywołania org_write zamiast jednego, ponieważ media/create rejestruje przesyłanie, zanim pins/create dołączy gotowy plik. W efekcie budżet 300 wywołań org_write w aplikacji Trial wystarcza na około 150 Pinów wideo dziennie, czyli połowę pułapu dla samych Pinów ze zdjęciem.
Czy Piny utworzone w dostępie Trial widzi ktoś poza deweloperem?
Według strony poziomów dostępu Piny i tablice utworzone, gdy aplikacja ma dostęp Trial, są elementami Sandbox widocznymi tylko dla ich twórcy. Testowanie przy pułapie 300 wywołań org_write nie niesie więc ryzyka publicznej ekspozycji, bo nic opublikowanego przed przejściem na Standard nie jest publiczne.
O ile tańszy jest odczyt niż zapis przy dostępie Standard na Pintereście?
org_read działa przy dostępie Standard z limitem 1 000 zapytań na minutę na użytkownika i aplikację, czyli dziesięć razy więcej niż 100 na minutę dla org_write. Analityka jest poniżej obu, z limitem 60 na minutę. Z tej różnicy wynika, że panel odpytujący statystyki 200 Pinów dojdzie do swojego pułapu, zanim narzędzie publikujące dojdzie do limitu org_write.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Wykorzystaj to w praktyce z AdaptlyPost
Czy ten artykuł był pomocny?
Chętnie poznamy opinię!
Więcej naszych treści w Google
Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.
Jeszcze chwila...
AdaptlyPost
Planowanie treści na wszystkich platformach
Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Powiązane hasła ze słownika


Dlaczego w większości API mediów społecznościowych brakuje 429 Retry-After
Para 429 i Retry-After to sposób, w jaki HTTP mówi „poczekaj”. X, Meta, LinkedIn, TikTok i YouTube nie dokumentują Retry-After, oto co wysyłają w zamian.


Limit API Bluesky przeliczony na posty na godzinę
Limit zapisów w API Bluesky to budżet punktów, a nie liczba żądań: 5 000 punktów na godzinę, 3 za post, czyli 1 666 postów na godzinę.


Dlaczego deweloperzy potrzebują zatwierdzenia aplikacji, by publikować na TikToku publicznie
Bez zatwierdzenia aplikacji posty z API zostają SELF_ONLY, a publikować może dziennie tylko 5 prywatnych kont. Co sprawdza audyt i jakie błędy zobaczysz.
Powiązane artykuły


Wszystkie pola do planowania wideo przez API YouTube i ich pułapki
API YouTube nie ma metody do planowania wideo. Planowanie to jedno pole daty i godziny, status.publishAt, które działa tylko przy privacyStatus równym private.


Ile tablic można mieć na Pintereście? 2 000 dowolnego typu
Limit tablic na Pintereście to 2 000 dowolnego typu, łącznie z tablicami grupowymi, oraz 200 000 Pinów. Obie liczby są w dokumentacji dla deweloperów.


Dzienny limit Pinów na Pintereście zależy od sposobu ich tworzenia
Pinterest nie ustala dziennego limitu dla Pinów tworzonych ręcznie. RSS i zbiorcze przesyłanie wideo kończą się na 200 dziennie, a API ma własne limity.

