Afinal, quantas pastas você pode ter no Pinterest: 2.000 de qualquer tipo

Quantas pastas você pode ter no Pinterest?

Digite quantas pastas você pode ter no Pinterest em uma caixa de busca e o que aparece são palpites, sendo que o próprio Pinterest publica o número na documentação para desenvolvedores: 2.000 pastas de qualquer tipo, por conta. O guia para desenvolvedores do Pinterest sobre criar pastas e Pins traz uma seção com o título "Volume limits for boards and Pins" que começa pelo motivo: "To keep Pinterest running smoothly, there's a limit to the total number of Pins, boards, and follows we can store for accounts."

Dois desses três limites ganham um número. O terceiro não.

Entidade	Teto publicado	O que o teto conta
Pastas	2.000	"boards of any type (public, private, and secret), including group boards you didn't create"
Pins	200.000	"including secret Pins and your Pins on group boards for personal accounts"
Seguidas	Não publicado	Citado na mesma frase que pastas e Pins, sem número associado

Vale registrar a lacuna das seguidas antes de continuar. O Pinterest cita três coisas que mede, imprime dois números e deixa o terceiro para você descobrir esbarrando nele.

O que conta para o limite de 2.000 pastas?

Toda pasta que aparece na sua conta conta, inclusive as pastas que outras pessoas criaram e para as quais convidaram você. A redação é deliberada: "including group boards you didn't create". É essa oração que a maioria das respostas de terceiros deixa passar, e ela muda a aritmética de quem passou anos aceitando convites de colaboração. Cinquenta pastas em grupo tocadas por outras pessoas são cinquenta pastas das suas 2.000.

Dá para ver essa mesma população pela API. GET /boards está documentado como um endpoint que devolve "a list of the boards owned by the 'operation user_account' + group boards where this account is a collaborator", que é o mesmo conjunto descrito pelo teto. As suas mais aquelas em que você colabora. Nada além disso.

Existe uma assimetria correspondente na volta. DELETE /boards/{board_id} remove uma pasta que pertence a você. A especificação v5 não publica nenhum endpoint para sair de uma pasta em grupo que pertence a outra pessoa, então a API não oferece jeito programático de encolher essa parte da contagem.

Mais um item se infiltra na lista. Se você criar um Pin exclusivo de anúncio definindo is_removable como true sem passar um board_id, o Pinterest o arquiva em uma pasta criada automaticamente com o nome "Ad-only Pins", e a configuração privacy dessa pasta passa a ser PROTECTED. Você não pediu uma pasta e ganhou uma.

Quantos Pins uma conta do Pinterest pode ter?

Uma conta pessoal do Pinterest comporta até 200.000 Pins, e a contagem inclui os Pins secretos junto com os seus Pins em pastas em grupo. A ressalva "for personal accounts" faz trabalho de verdade nessa frase. O Pinterest prende o número de 200.000 às contas pessoais especificamente e não publica número separado para contas comerciais em nenhum ponto da página, então, se você toca uma conta comercial, a resposta honesta é que o Pinterest não contou.

Também não há limite publicado de Pins por pasta. O objeto Board devolve um campo pin_count, mas o teto que o Pinterest documenta vale para a conta inteira, não por pasta.

Pastas secretas contam, e o que é uma pasta privada?

Pastas secretas contam, as privadas também, e o Pinterest usa três vocabulários diferentes para as mesmas três configurações, dependendo do documento que você abrir.

Onde você lê	Os nomes usados
Guia para desenvolvedores, seção de limites de volume	public, private, and secret
Enum privacy da API em BoardCreate e Board	PUBLIC, PROTECTED, SECRET
Artigo da central de ajuda em /en/article/secret-boards	intitulado "Private boards"

O BoardPrivacyFilter usado por GET /boards acrescenta mais dois valores, ALL e PUBLIC_AND_SECRET, que existem para filtrar e não para configurar nada.

Desembaraçando: o SECRET da API é o que a central de ajuda hoje chama de pasta privada, a URL do artigo continua dizendo secret-boards, e PROTECTED é o recurso comercial que o Pinterest documenta separadamente. Seja qual for o rótulo que você encontrar, os três valores de privacidade são pastas, e o teto diz "any type". Nenhum deles sai de graça.

Por que o limite de pastas está na documentação para desenvolvedores e não na central de ajuda?

O Pinterest enquadra o teto como uma questão de armazenamento para clientes da API, então ele vive em um guia para desenvolvedores sob um título sobre volume, e não na central de ajuda para usuários. O artigo da central de ajuda "Create a board" mostra o botão que se clica na web, no iOS e no Android, cobre como deixar uma pasta secreta e convidar colaboradores, e nunca menciona um teto. Quem usa o Pinterest e lê a documentação do Pinterest feita para usuários não tem como descobrir o número.

Essa é a razão inteira pela qual essa pergunta é mal respondida pela web afora. Quem pergunta são usuários, a resposta está publicada para desenvolvedores, e os dois públicos leem sites diferentes. Se você viu um post de blog cravar um número diferente com confiança, ele quase certamente não veio da seção de limites de volume, porque essa seção diz 2.000 e diz isso há muito tempo.

Você deve usar Create Pin ou Save Pin?

O Pinterest restringe POST /pins a conteúdo criado pelo próprio usuário, e a referência da API diz isso em uma frase: "This function is intended solely for publishing new content created by the user. If you are interested in saving content created by others to your Pinterest boards, sometimes called 'curated content', please use our Save button instead."

O guia para desenvolvedores dá uma segunda orientação, diferente, para a mesma situação: "We recommend using the POST Save Pin endpoint whenever you or your users are curating Pins. This will prevent users from meeting their entity limits unnecessarily."

Ou seja, a referência manda quem faz curadoria para o botão Save, um complemento da web, e o guia manda essas pessoas para POST /pins/{pin_id}/save, um endpoint de API. Mesmo problema, duas respostas, duas páginas.

Leia a segunda citação com atenção, porque é fácil afirmar demais. O Pinterest diz que usar o Save Pin evita que usuários alcancem seus limites de entidades desnecessariamente. Não diz que os Pins salvos estão excluídos dos 200.000. A própria linha dos 200.000 lista os Pins secretos e os seus Pins em pastas em grupo, e não menciona salvamentos em nenhum sentido. A recomendação está documentada, o motivo está documentado em termos gerais, e a contabilidade real de um Pin salvo não está.

O que está documentado sobre salvar: POST /pins/{pin_id}/save aceita "any Pin type", e "any public Pin can be saved given a pin ID". O guia acrescenta que "Pins can be saved to multiple boards", enquanto a página de entidades do Pinterest afirma que "Each Pin has a unique Pin id and can only be associated with one board or board section". As duas coisas são verdadeiras se cada salvamento produzir o próprio objeto Pin com o próprio id, que é também a leitura segundo a qual salvar consome a cota em vez de escapar dela.

Create Pin ou Save Pin?

Create Pin

• Destinado apenas a conteúdo criado pelo próprio usuário
• A referência da API direciona curadores ao botão Save

Save Pin

• Recomendado pelo guia para desenvolvedores para curar Pins
• Usa POST /pins/{pin_id}/save
• Diz evitar que usuários atinjam seus limites de entidade sem necessidade

Que erro você recebe ao bater no limite?

O Pinterest não publica código de erro nem mensagem para o estouro do teto de pastas ou de Pins. POST /boards documenta respostas para 400, 401, 403, 404 e 429, além de um erro padrão, e nenhuma delas é descrita como resposta de limite de entidades. O 429 é definido como "The user has sent too many requests in a given amount of time and is being rate limited", que é um limite sobre a frequência de requisições, não um teto de objetos armazenados. São limites diferentes e falham de formas diferentes.

A consequência prática é que você não consegue detectar esse teto procurando uma string. Você tem que contar.

Como contar as pastas que você já tem?

Chame GET /boards e percorra as páginas, porque o endpoint devolve exatamente o conjunto que o teto conta. A paginação usa um cursor bookmark com page_size, que vale 25 por padrão e vai no máximo até 250. Uma conta perto do teto significa, portanto, pelo menos oito páginas de trabalho.

Cada Board na resposta carrega os campos de que você precisa para auditar o número:

Campo	Para que serve
owner.username	Separa as pastas que você criou das pastas em grupo que você não criou
privacy	PUBLIC, PROTECTED ou SECRET, e os três contam
collaborator_count	Sinaliza as pastas compartilhadas
pin_count	Os Pins daquela pasta, não o total da conta

Somar pin_count em todas as suas pastas não reproduz o número de 200.000, porque esse teto conta os seus Pins em pastas em grupo que não pertencem a você, e essas pastas não são todas suas para enumerar.

O que isso significa para agendar conteúdo no Pinterest

Os limites pertencem ao Pinterest e à conta, e nenhuma ferramenta de agendamento os muda. O que uma ferramenta muda é quantas pastas e Pins você cria sem perceber. Uma importação em massa que espalha uma campanha em uma pasta nova por linha de produto gasta pastas num ritmo que ninguém alcançaria clicando pelo aplicativo, e 2.000 chega mais rápido do que parece quando as pastas em grupo já estão comendo uma fatia.

O AdaptlyPost publica no Pinterest pelo seu agendador de posts do Pinterest e traz os resultados de volta pelas análises do Pinterest. Se você enfileira em volume, o agendamento em massa e o calendário de conteúdo são onde dá para ver quantos Pins uma campanha vai realmente criar antes de ela criar, e a publicação em várias contas manda o mesmo item para outras redes sem multiplicar o que cai no Pinterest.

Perguntas frequentes

Dá para ter pastas ilimitadas no Pinterest?

Não. O Pinterest armazena até 2.000 pastas por conta, conforme sua documentação para desenvolvedores em "Volume limits for boards and Pins". O limite cobre pastas de qualquer tipo e inclui as pastas em grupo que você não criou.

Pastas em grupo contam para o limite de pastas do Pinterest?

Sim, inclusive as pastas em grupo que você não criou. A redação do Pinterest é "up to 2,000 boards of any type (public, private, and secret), including group boards you didn't create". GET /boards devolve o mesmo conjunto, descrito como as pastas que você tem mais "group boards where this account is a collaborator".

Quantos Pins você pode ter no Pinterest?

200.000 em uma conta pessoal, contando os Pins secretos e os seus Pins em pastas em grupo. O Pinterest prende esse número às contas pessoais especificamente e não publica número equivalente para contas comerciais.

Pastas secretas contam para o limite de 2.000 pastas?

Sim. O teto se aplica a pastas "of any type (public, private, and secret)". Na API os três valores são PUBLIC, PROTECTED e SECRET, e a central de ajuda do Pinterest hoje intitula seu artigo sobre pastas secretas de "Private boards", mas as diferenças de nome não criam isenção.

A central de ajuda do Pinterest publica o limite de pastas?

Não. O artigo da central de ajuda "Create a board" cobre como criar pastas na web, no iOS e no Android, como deixar uma secreta e como adicionar colaboradores, e não dá teto nenhum. Os números 2.000 e 200.000 aparecem apenas na documentação para desenvolvedores.

Você deve usar Create Pin ou Save Pin para conteúdo de outra pessoa?

Save Pin. A referência da API do Pinterest diz que POST /pins "is intended solely for publishing new content created by the user" e manda quem faz curadoria para outro lugar, enquanto o guia para desenvolvedores recomenda POST /pins/{pin_id}/save para curadoria e diz que isso "will prevent users from meeting their entity limits unnecessarily". O Pinterest não publica nenhuma afirmação de que os Pins salvos estejam excluídos da contagem dos 200.000.

Dá para sair de uma pasta em grupo do Pinterest que você não criou?

A API não oferece nenhuma forma de fazer isso. DELETE /boards/{board_id} remove apenas pastas que você possui, e a especificação v5 não publica nenhum endpoint para sair de uma pasta criada por outra pessoa. Essa pasta em grupo continua contando para as suas 2.000 até que o dono te remova.

O Pinterest cria alguma pasta automaticamente para você?

Em um caso específico, sim: ao criar um Pin somente de anúncio com is_removable definido como true e sem enviar um board_id. O Pinterest o coloca em uma pasta criada automaticamente chamada "Ad-only Pins", com a configuração de privacy definida como PROTECTED, uma pasta que ninguém pediu e que mesmo assim conta para as 2.000.

Qual é a diferença entre o erro 429 do Pinterest e bater no limite de pastas?

Os dois não têm relação. A resposta 429 significa que o usuário enviou solicitações demais em um período e está sendo limitado por taxa, um limite sobre a frequência das requisições. Para ultrapassar o limite de pastas ou de Pins, o Pinterest não publica nenhum código de erro nem mensagem, então só resta contar por conta própria.

Quantas páginas são necessárias para conferir o número de pastas pela API?

Pelo menos oito para uma conta perto do teto. GET /boards pagina com um cursor bookmark e um page_size que por padrão é 25 e chega a no máximo 250, então contar até as 2.000 pastas significa percorrer várias páginas de resultado em vez de ler um único número.