<!-- Source: https://9pic.ai/pt-br/blog/export-event-photo-data-json/ -->
![Fundo abstrato com listras](/images/stripes.svg)

[Voltar ao blog](/pt-br/blog/)

![Como exportar os dados das fotos de um evento em JSON: uma entrada por foto com números de peito, marcações manuais, nome e caminho do arquivo](https://bgimg.9pic.ai/images/blog/export-event-photo-data-json.jpg?title=Como+exportar+os+dados+das+fotos+do+seu+evento+em+JSON&amp;subtitle=Uma+entrada+por+foto+com+n%C3%BAmeros+de+peito%2C+marca%C3%A7%C3%B5es+manuais%2C+nome+e+caminho%2C+em+um+s%C3%B3+arquivo.&amp;kicker=Guia+de+dados&amp;author=Equipe+9Pic+AI&amp;readTime=7+min&amp;lang=pt-BR)

**Em resumo**: abra o seu evento, vá em **Photo**, depois em **Tools**, e escolha **Photos to Data Export**. Marque os **Fields to include**, selecione **Export** e baixe o arquivo JSON quando aparecer **Ready**. Cada foto processada ganha uma entrada, inclusive as fotos sem número de peito.

O que a exportação entrega
----------------------------

O Photos to Data Export responde a uma pergunta para cada foto do seu evento: o que sabemos sobre ela? O arquivo tem uma entrada por foto processada, identificada pelo ID da foto, com os campos que você escolheu.

É a exportação certa quando você parte das fotos:

- **Ligar as marcações aos originais.** O nome e o caminho do arquivo mostram a qual arquivo da pasta do fotógrafo cada entrada corresponde.
- **Achar as fotos que ninguém encontra.** As fotos sem número de peito estão no arquivo com uma lista vazia, prontas para uma segunda olhada.
- **Manter o seu próprio registro.** Uma cópia das marcações do evento como estavam em um determinado dia, para o seu arquivo ou para outro sistema.


Se você parte dos corredores e quer cada número de peito com as suas fotos, use o [Bib to Data Export](/pt-br/blog/export-race-photos-by-bib-number/).

Passo 1: abra a ferramenta
--------------------------

No painel, abra o evento, vá em **Photo** e selecione a aba **Tools**. Escolha **Photos to Data Export**. Antes ela se chamava Photos to Bib Export, e os links antigos ainda abrem a ferramenta.

A página tem duas colunas. À esquerda ficam os campos e o botão **Export**. À direita fica o **Latest export** com uma prévia do arquivo. Antes da sua primeira exportação, o lado direito mostra um **Example file** para você ver o formato.

Passo 2: escolha os campos
--------------------------

**Bibs** e **Manual tags** já vêm marcados. Adicione os outros de que precisar. É preciso marcar pelo menos um.

| Campo | O que contém |
| --- | --- |
| **Bibs** | Os números de peito pelos quais os participantes encontram a foto: os detectados mais as suas marcações manuais, menos os que você removeu. |
| **Manual tags** | Números de peito que você adicionou à mão no Manual Tagging. |
| **Original file name** | O nome da foto quando ela foi importada. |
| **File path** | Onde a foto está na origem, incluindo o nome. Para um upload na 9Pic, a pasta dentro do upload. Para Google Drive, Dropbox, OneDrive, Box ou SharePoint, o caminho dentro da pasta compartilhada. Fica vazio para fotos de um link personalizado. |
| **Detected bibs** | Números de peito encontrados na foto, antes de qualquer remoção. |
| **Removed bibs** | Números de peito detectados que você removeu no Manual Tagging. |
| **Detected text** | Todo o texto lido na foto, como nomes de patrocinadores e placas. |

Cada campo extra deixa o arquivo maior. O Detected text é o que mais pesa, então deixe-o desmarcado se não for usá-lo.

As caixas começam com os campos da sua última exportação. Se você mudar a seleção, um aviso lembra de exportar de novo para que o arquivo corresponda.

Passo 3: exporte e baixe
------------------------

Selecione **Export**. A exportação roda em segundo plano e mostra quantas fotos já leu. Você pode sair da página e voltar depois. Um evento grande leva cerca de um minuto.

Quando aparecer **Ready**, o quadro **Latest export** mostra quando ela rodou, o tamanho do arquivo e três contagens: **Photos**, **Bibs** e **Photos without bibs**. Ele também lista os campos do arquivo. Selecione **Download JSON** para salvá-lo.

Cada evento guarda a última exportação de cada tipo, então uma nova exportação substitui a que aparece na página.

Passo 4: leia o arquivo
-----------------------

Todo arquivo começa com os mesmos dados: `event_id`, `export_type`, `generated_at`, `options` (os campos incluídos) e `counts`. As fotos ficam em `data`. Veja um arquivo com nome do arquivo, caminho, números de peito e marcações manuais:

    {
      "event_id": 6109,
      "export_type": "photos_to_bib",
      "generated_at": "2026-11-13T09:30:00+00:00",
      "options": ["file_name", "file_path", "bibs", "manual_tags"],
      "counts": {"photos": 30240, "bibs": 7374, "photos_without_bibs": 2086},
      "data": {
        "3f2a...c91e": {
          "file_name": "IMG_4821.jpg",
          "file_path": "Habit Run 2026/Finish line/IMG_4821.jpg",
          "bibs": ["1024", "2210"],
          "manual_tags": ["2210"]
        },
        "9d03...6b7f": {
          "file_name": "IMG_4822.jpg",
          "file_path": "Habit Run 2026/Finish line/IMG_4822.jpg",
          "bibs": [],
          "manual_tags": []
        }
      }
    }

Alguns pontos importantes na hora de ler:

- A chave de cada entrada é o ID da foto na 9Pic AI. Não é o nome do arquivo. Marque **Original file name** quando precisar dele.
- As fotos sem número de peito continuam no arquivo, com uma lista vazia. É assim que `photos_without_bibs` é contado.
- Uma foto de um link personalizado tem `null` como caminho do arquivo, porque não tem pasta.


Confira antes de baixar
-----------------------

Abaixo da última exportação, o **File preview** mostra o início do arquivo, com o mesmo formato. Selecione uma chave ou a sua seta para abrir ou recolher, ou use **Expand all** e **Collapse all**. **Raw** mostra texto simples com números de linha, e **Copy** copia a prévia.

A prévia traz as primeiras 20 fotos, e as listas longas são cortadas com uma linha como "… 5 more items in the download". As entradas recolhidas mostram quantas chaves ou itens têm no arquivo completo, então as contagens são reais mesmo quando a prévia é curta.

Três usos práticos
--------------------

### Ligue as marcações aos originais do fotógrafo

Marque **Original file name** e **File path**. Agora cada entrada informa de qual arquivo e de qual pasta veio, então um fotógrafo ou editor encontra o original de um número de peito sem procurar na galeria.

### Encontre as fotos sem número de peito

Procure as entradas com a lista `bibs` vazia. Muitas serão fotos de público, de paisagem ou da largada. Outras podem ser de corredores com o número escondido. Vale a pena revisá-las no Manual Tagging; veja [como marcar números de peito à mão depois da IA](/pt-br/blog/manual-bib-tagging-after-ai/).

### Confira o que foi corrigido

Marque **Detected bibs** e **Removed bibs** para ver o que a leitura de números de peito encontrou e o que a sua equipe removeu. É um jeito rápido de revisar uma rodada de marcação ou de explicar por que um corredor não encontra mais uma foto.

O que conta como número de peito
---------------------------------

Só as fotos **processadas** entram no arquivo. O campo **Bibs** segue as mesmas regras da busca dos participantes:

- Números de peito encontrados com as configurações de detecção do evento. Quando o evento usa a sua lista de números, só contam os números da lista.
- Menos os números detectados que você removeu.
- Mais as suas marcações manuais, mesmo antes de serem publicadas na busca dos participantes.


Assim, o arquivo corresponde ao que os participantes encontram, já com as suas marcações manuais mais recentes.

Perguntas frequentes
--------------------

### O arquivo é atualizado quando mudo as marcações?

Não. Um arquivo mostra as marcações do momento em que foi gerado. Depois de marcar, selecione **Export again**.

### Quais planos incluem essa exportação?

Todos os planos. Ela também continua funcionando depois que um plano termina, então você ainda pode levar os seus dados.

### A exportação falhou. E agora?

Selecione **Export again**. Se um download falhar, tente mais uma vez: cada clique prepara um novo link de download.

### Posso abrir o arquivo em uma planilha?

JSON é feito para software, então o caminho mais fácil é entregá-lo a quem cuida do seu sistema de resultados ou de inscrições. A maioria das ferramentas de dados e dos complementos de planilhas também importa JSON.

Próximos passos
----------------

Faça uma primeira exportação com os campos padrão e abra o File preview para ver o formato do seu evento. Depois adicione o nome e o caminho do arquivo se precisar ligar as fotos aos originais. Para uma lista de cada número de peito com as suas fotos, leia [como exportar fotos de corrida por número de peito](/pt-br/blog/export-race-photos-by-bib-number/). A leitura dos números de peito é explicada na página do [BibTrack](/pt-br/products/bibtrack/).

Pronto para começar?
---------------------

Junte-se aos organizadores de eventos que já entregaram 100M+ fotos a 5M+ participantes em 5k+ eventos com a 9Pic AI para hospedagem, busca com IA e entrega de mídia.

[Começar](https://admin.9pic.ai/sign-up) [Agendar demo](/pt-br/contact/)
