As matérias do JornalBox no blog do seu site
O JornalBox escreve, revisa e publica. No modo Só a API não existe site no JornalBox: cada matéria aparece no blog do seu site, com o seu layout, no seu domínio e somando SEO para você. Sem custo a mais, com kit pronto para PHP.
GET https://jornalbox.com.br/api/v1/posts?por_pagina=2
Authorization: Bearer jb_12345_••••••••
{
"total": 248,
"posts": [
{
"titulo": "Como escolher a hospedagem certa para a sua loja",
"resumo": "O que olhar antes de contratar: velocidade, backup e suporte.",
"capa": { "url": "https://jornalbox.com.br/uploads/.../capa.webp" },
"categoria": { "nome": "Dicas", "slug": "dicas" },
"publicado_em": "2026-10-25T09:00:00-03:00",
"url": "https://suaempresa.com.br/blog/como-escolher-a-hospedagem"
},
...
]
}O site continua seu. O conteúdo vem pronto.
Loja virtual, site institucional, sistema ou landing page: o site já existe, só falta matéria nova toda semana. Em vez de trocar de plataforma, você liga o blog dele ao JornalBox e ele volta a publicar sozinho.
- 01
O JornalBox produz
Matérias com IA, por RSS ou escritas por você, com capa, categoria, SEO e revisão, no ritmo da sua campanha.
- 02
A API entrega
O seu site pede as matérias publicadas e recebe tudo em JSON: título, texto em HTML, capa, autor, categoria e SEO.
- 03
O seu site mostra
Com o seu topo, menu, cores e rodapé. O leitor não sai do seu domínio e cada visita conta para você.
- 04
O Google vê um lugar só
Não há site no JornalBox: o endereço de lá manda para o seu blog (301) e o kit monta canonical, Open Graph, JSON-LD e sitemap.
Site do JornalBox ou só a API
Cada site da sua conta funciona de um jeito, e você escolhe em Configurações › Site ou só API. Dá para trocar quando quiser.
| Site do JornalBoxo padrão | Só a APIblog no seu site | |
|---|---|---|
| Onde o leitor lê | No site do JornalBox (subdomínio ou seu domínio) | No blog do seu site, em /blog ou num subdomínio |
| Visual | Um dos temas do JornalBox | O do seu site |
| Temas e Layout no painel | Ficam ocultos | |
| Matérias com IA, RSS e editor | ||
| Auto-post nas redes | ||
| Endereço do JornalBox | Mostra o site | Manda para o seu blog (301) |
| Custo | O do plano | O do plano, sem custo a mais |
O que vem em cada matéria
Tudo o que o portal do JornalBox mostra também sai pela API, já com os endereços apontando para o seu blog. Só saem matérias publicadas: rascunhos e agendadas ficam no painel.
Ver todos os campos| Campo | O que traz |
|---|---|
titulo, resumo | Título e linha fina da matéria |
conteudo_html | O texto completo em HTML, com imagens e links já ajustados |
capa, galeria | Imagem de capa (com texto alternativo, legenda e crédito) e carrossel |
categoria, tags | Categoria principal, categorias extras e tags |
autor | Nome, cargo, minibio e foto de quem assina |
seo | Título e descrição para o Google, imagem de compartilhamento e palavra-chave |
publicado_em, url | Data com fuso e o endereço da matéria no seu site |
relacionados | 3 matérias da mesma categoria, para o "Leia também" |
Uma escolha em Configurações
Em Configurações › Site ou só API, marque "Só a API, no blog do meu site", informe o endereço do blog e salve. A chave aparece na hora, a mesma tela testa a ligação e mostra quantas chamadas o seu site fez. Temas e Layout saem do painel, porque o visual passa a ser o do seu site.
- Sem custo a mais
- Chave por site
- Teste em 1 clique
- Volta ao site quando quiser

Kit PHP pronto, em 5 minutos
Envie a pasta blog para o seu site, cole a chave e coloque o topo e o rodapé do seu site. A lista, a matéria, as categorias, a busca e o sitemap já vêm prontos, com cache para o site continuar no ar mesmo se a API demorar.
- Baixe o kit
- Cole a chave
- Use o seu topo e rodapé
- Abra seusite.com.br/blog
<?php /* blog/config.php */
return [
'chave' => 'jb_12345_••••••••',
'url_blog' => 'https://suaempresa.com.br/blog',
'nome_site' => 'Sua Empresa',
];
// em qualquer página do seu site:
$ultimas = $jb->posts(['por_pagina' => 3]);
foreach ($ultimas['posts'] as $p) {
echo '<a href="' . $jb->link($p['slug']) . '">'
. $jb->e($p['titulo']) . '</a>';
}Documentação da API
Endereço base https://jornalbox.com.br/api/v1. Só leitura (GET), respostas em JSON UTF-8. Envie a chave no cabeçalho Authorization: Bearer SUA_CHAVE e um User-Agent com o nome do seu site.
| Endereço | O que devolve |
|---|---|
GET /posts | Lista paginada das matérias publicadas, da mais nova para a mais antiga. Filtros: pagina, por_pagina (até 50), categoria (slug), tag, busca e desde (data, para buscar só as novas). Traz total e total_paginas. |
GET /posts/{slug} | A matéria completa: conteudo_html, capa, galeria, video, tags, categorias_extras, seo, receita (em sites de receitas) e relacionados. |
GET /categorias | Nome, slug, descrição, categoria-mãe e total de matérias de cada categoria. |
GET /site | Nome, descrição, idioma e logo do site, endereço do blog, total de matérias e data da última publicação. |
GET /sitemap | Endereço e data de todas as matérias (até 5.000), para montar o sitemap do seu blog. |
// PHP puro, sem o kit
$ch = curl_init('https://jornalbox.com.br/api/v1/posts?por_pagina=6');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_USERAGENT => 'MeuSite/1.0',
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('JORNALBOX_CHAVE')],
]);
$r = json_decode(curl_exec($ch), true);
foreach ($r['posts'] as $p) {
echo '<a href="/blog/' . rawurlencode($p['slug']) . '">'
. htmlspecialchars($p['titulo']) . '</a>';
}// Node.js, Next.js, Nuxt... (no servidor, para o Google ler a matéria)
const r = await fetch('https://jornalbox.com.br/api/v1/posts/' + slug, {
headers: { Authorization: 'Bearer ' + process.env.JORNALBOX_CHAVE }
});
if (r.status === 404) return notFound();
const { post, relacionados } = await r.json();
// post.titulo, post.conteudo_html, post.capa.url, post.seo.descricaocurl -A "MeuSite/1.0" \ -H "Authorization: Bearer SUA_CHAVE" \ "https://jornalbox.com.br/api/v1/posts?categoria=dicas&por_pagina=5" # só as matérias novas desde a última sincronização curl -A "MeuSite/1.0" -H "Authorization: Bearer SUA_CHAVE" \ "https://jornalbox.com.br/api/v1/posts?desde=2026-10-25T08:00:00-03:00"
// erro = JSON com "erro" e "mensagem"
{ "erro": "chave_invalida", "mensagem": "Chave inválida ou API desligada neste site." }
401 sem_chave, chave_invalida falta a chave, chave trocada ou API desligada
403 site_inativo site suspenso ou cancelado no JornalBox
404 post_nao_encontrado matéria apagada, despublicada ou slug errado
429 limite mais de 300 chamadas por minuto (veja Retry-After)
// cada resposta vale 60 s: use cache no seu site (o kit guarda 5 min)
// ETag + If-None-Match devolvem 304 quando nada mudouPerguntas frequentes
Ficou com alguma dúvida que não respondemos aqui? Veja a Central de ajuda ou fale com a nossa equipe.
Fale com um consultorPara site em PHP, não: o kit traz as páginas prontas e você só cola a chave e põe o topo e o rodapé do seu site. Em outra linguagem, alguém da sua equipe chama a API, que é um GET que devolve JSON.
Sim. Elas ficam no seu domínio, com o canonical apontando para o seu endereço. No modo Só a API não há site no JornalBox: o endereço de lá manda leitor e Google para a mesma matéria no seu blog (301). O sitemap sai pronto em /blog/sitemap.xml.
No modo Só a API eles ficam ocultos no painel, junto com o Layout, as enquetes e as músicas da home: o visual é todo do seu site. Voltando para "Site do JornalBox" em Configurações, tudo reaparece como estava.
No mesmo site, não: ou o JornalBox mostra as matérias, ou o seu site mostra. Se quiser os dois, crie outro site na conta, cada um no seu modo.
Funciona em qualquer site que consiga ler um endereço da internet no servidor e mostrar o resultado. No WordPress, dá para usar o kit numa pasta /blog ou chamar a API num modelo do tema. Em plataformas fechadas, só com os recursos de código que elas oferecem: não temos plugin pronto para elas.
Com o kit, até uns 5 minutos depois de publicada (é o tempo do cache, que dá para mudar no config.php). A API em si atualiza a cada minuto.
O kit guarda a última resposta boa de cada página e continua mostrando o blog com ela até a API voltar.
Não. Capas e imagens continuam no JornalBox, entregues por CDN. O seu site só mostra.
Não. A API está em todos os planos, sem custo a mais. As matérias seguem contando no limite do plano, como sempre.
Sim. O card vai para as redes como antes e, no modo Só a API, quem clica no link cai na matéria do seu blog.
O blog do seu site publicando de novo
Crie o site no JornalBox, escolha "Só a API" em Configurações e mostre as matérias no seu domínio. Pronto para começar ou tem alguma dúvida? Fale com um consultor, sem compromisso.
Matérias com IA


