LeadGo
Criar conta
Páginas da documentação

Desenvolvedores · Referência · v1.2.0

Mídias

Imagens e vídeos dos anúncios. Envie uma vez e use o id em quantas campanhas quiser.

https://leadgo.com.br/api/v1 Baixar arquivo para IA OpenAPI 3.1 Criar token
POST /media media:write

Enviar mídia

Envie o arquivo (multipart, campo file) e ele fica pronto na hora (201); ou informe a URL (JSON, campo url) e o download segue em segundo plano (202, status pending → ready ou failed, com o aviso media.ready). Imagens JPG/PNG até 30 MB; vídeos MP4/MOV até 200 MB; o tipo é conferido pelo conteúdo. A URL precisa ser https, pública e direta (links de compartilhamento do Drive e do Dropbox redirecionam e falham). Mídias sem uso somem depois de 7 dias; usadas, 30 dias depois do último uso.

Corpo

file file O arquivo (multipart/form-data). Obrigatório sem url.
url string URL https direta do arquivo (application/json). Obrigatório sem file.
filename string Nome de exibição.

Exemplo

cURL 
curl -X POST "https://leadgo.com.br/api/v1/media" \
  -H "Authorization: Bearer $LEADGO_TOKEN" \
  -H "Accept: application/json" \
  -F "[email protected]"

# Ou por URL (o download segue em segundo plano):
curl -X POST "https://leadgo.com.br/api/v1/media" \
  -H "Authorization: Bearer $LEADGO_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://cdn.loja.exemplo.com.br/banners/outubro.jpg"
}'

Resposta 201

HTTP 201 
{
    "data": {
        "id": "01jbx3m7k2q8f5v9w4n6c0r1ht",
        "status": "ready",
        "kind": "image",
        "filename": "outubro.jpg",
        "mime_type": "image/jpeg",
        "size": 482113,
        "source_url": null,
        "error": null,
        "ready_at": "2026-10-28T15:00:02+00:00",
        "last_used_at": null,
        "expires_at": "2026-11-04T15:00:02+00:00",
        "created_at": "2026-10-28T15:00:02+00:00"
    }
}

Erros: validation_failed, media_rejected, too_many_imports

GET /media media:write

Listar mídias

Mídias da conta, das mais novas para as mais antigas (paginado por cursor, 50 por página).

Parâmetros

cursor string Valor de meta.next_cursor da página anterior.

Exemplo

cURL 
curl -X GET "https://leadgo.com.br/api/v1/media" \
  -H "Authorization: Bearer $LEADGO_TOKEN" \
  -H "Accept: application/json"

Resposta 200

HTTP 200 
{
    "data": [
        {
            "id": "01jbx3m7k2q8f5v9w4n6c0r1ht",
            "status": "ready",
            "kind": "image",
            "filename": "outubro.jpg",
            "mime_type": "image/jpeg",
            "size": 482113,
            "source_url": null,
            "error": null,
            "ready_at": "2026-10-28T15:00:02+00:00",
            "last_used_at": null,
            "expires_at": "2026-11-04T15:00:02+00:00",
            "created_at": "2026-10-28T15:00:02+00:00"
        }
    ],
    "links": {
        "first": null,
        "last": null,
        "prev": null,
        "next": null
    },
    "meta": {
        "path": "/api/v1/media",
        "per_page": 50,
        "next_cursor": null,
        "prev_cursor": null
    }
}
GET /media/{id} media:write

Consultar mídia

Situação de uma mídia: use para acompanhar o download por URL (status pending → ready ou failed, com o motivo em error).

Exemplo

cURL 
curl -X GET "https://leadgo.com.br/api/v1/media/{id}" \
  -H "Authorization: Bearer $LEADGO_TOKEN" \
  -H "Accept: application/json"

Resposta 200

HTTP 200 
{
    "data": {
        "id": "01jbx3m7k2q8f5v9w4n6c0r1ht",
        "status": "ready",
        "kind": "image",
        "filename": "outubro.jpg",
        "mime_type": "image/jpeg",
        "size": 482113,
        "source_url": null,
        "error": null,
        "ready_at": "2026-10-28T15:00:02+00:00",
        "last_used_at": null,
        "expires_at": "2026-11-04T15:00:02+00:00",
        "created_at": "2026-10-28T15:00:02+00:00"
    }
}

Erros: not_found

DELETE /media/{id} media:write

Excluir mídia

Apaga a mídia da biblioteca. Campanhas já criadas com ela não são afetadas (cada uma tem a sua cópia).

Exemplo

cURL 
curl -X DELETE "https://leadgo.com.br/api/v1/media/{id}" \
  -H "Authorization: Bearer $LEADGO_TOKEN" \
  -H "Accept: application/json"

Resposta 204

Sem corpo.

Erros: not_found