One feed: address, format, what it carries and where it was found.

The same record the HTML page at /feeds/<id> shows. 404 when the id is unknown. Returns: { id, kind, dominio, url, nome, descricao, tipo, audio, video, comunidade, comunidades, ano, recursos, densidade, itens, saude, pais, site_titulo, site_descricao, site_nome, site_og, site_og_alt, site_cor, site_idioma, idioma_bandeira, icone, imagem, ultimo_post, posts_24h, posts_7d, posts_30d, posts_dias, posts_no_feed, posts_parcial, atividade_em, pagina, api }

get/api/feeds/{id}

Request

Base URL: https://agentalog.com
URL: https://agentalog.com/api/feeds/{id}
Auth: none required

Path parameters

idstring required

Feed id, prefix fd_.

Headers

X-API-Passstring

MAT-only private pass: mat_<32 random hex>_<64 random hex>. Generate and save before buying.

Idempotency-Keystring

Optional retry key, up to 80 ASCII characters; same read for five minutes.

Response

{ id, kind, dominio, url, nome, descricao, tipo, audio, video, comunidade, comunidades, ano, recursos, densidade, itens, saude, pais, site_titulo, site_descricao, site_nome, site_og, site_og_alt, site_cor, site_idioma, idioma_bandeira, icone, imagem, ultimo_post, posts_24h, posts_7d, posts_30d, posts_dias, posts_no_feed, posts_parcial, atividade_em, pagina, api }

idstring required

Feed id, prefix fd_; it is the key across this collection.

kind'index' | 'blogroll' | 'bridge' required

What this record is.

dominiostring required

Domain that publishes it, lowercase and without www..

urlstring required

The feed address — or the site's, for a record of kind bridge.

nomestring required

Feed title as the source published it.

descricaostring required

Feed description; for a reading list, whoever curates it.

Feed format.

audioboolean required

true when the feed carries audio enclosures — a podcast.

videoboolean required

true when the feed carries video enclosures.

comunidadeinteger required

Bitmask of the communities the publisher belongs to; 0 when none is known.

comunidadesstring[] required

The same communities by name (wordpress, indieweb, fediverse, mastodon, friendica, funkwhale, blogroll), so nobody has to decode the bitmask.

anointeger required

Year of the newest item the source saw in this feed; 0 when it published no usable date. It is a freshness hint from discovery, not a live check.

recursosstring[] required

Namespaces seen in the feed, content first when the whole post travels in it.

densidadeinteger required

The source's own text score for the feed (t): how much item text discovery found. Bigger means more text travels in the feed — the scale is the source's, and the value is frozen at discovery, not a live metric.

itensinteger required

How many feeds an OPML list had when it was read; 0 for a feed.

saude'' | 'ok' | 'erro' | 'sumiu' required

What OUR own check saw: ok answered with an actual feed (an RSS/Atom/RDF root, a JSON Feed, or OPML for a list); sumiu returned 404/410 or its domain no longer resolves; erro any other failure. A failure only changes this after a second check hours later agrees, and a server that blocks robots (401/403, bot challenge) never turns into erro. Empty means not checked yet — which is not the same as failing.

paisstring required

ISO-3166 alpha-2 of the IP that serves the host, resolved during that same check. Empty when it could not be resolved.

site_titulostring required

Link preview of the publisher's home page, as WhatsApp or X would read it: og:title, then twitter:title, JSON-LD and <title>. Every site_* field is empty when the site declares nothing, was not visited yet, disallows our robot in robots.txt, or is confirmed gone (parked, suspended, default server page).

site_descricaostring required

Preview description: og:description, then twitter:description, JSON-LD and <meta name=description>.

site_nomestring required

Site name the page declares (og:site_name, application-name).

site_ogstring required

The preview image URL as declared by the site (og:image, then twitter:image); https only.

site_og_altstring required

Alternative text the site declares for that image (og:image:alt).

site_corstring required

The site's theme-color as #rrggbb; empty when absent or not a plain color.

site_idiomastring required

Language of the home page (<html lang>, then og:locale): two or three letters, plus the region when the site declares one (pt-br, en-us).

idioma_bandeirastring required

ISO-3166 alpha-2 (lowercase) of the flag that stands for that language: the declared region, otherwise the language's reference country (en → gb, pt → br). Empty for languages without one.

iconestring required

Absolute URL of the site icon served by us (the largest raster icon the home declares, up to 512 px; /favicon.ico otherwise), downloaded and checked on our index host. Empty when we have none stored.

imagemstring required

Absolute URL of the preview image served by us, up to 600 KB, downloaded and checked on our index host (PNG, JPEG, GIF, WebP, AVIF, ICO or BMP by its bytes). Empty when the site declares none or we have none stored.

ultimo_poststring required

ISO 8601 date of the newest post, read from the feed itself (RSS pubDate, Atom published/updated, RDF dc:date, JSON Feed date_published). Empty when not read yet, when the feed dates nothing, or for lists and bridges.

posts_24hinteger nullable required

Posts published in the last 24 hours, counted at request time over the dates we read. null when the feed was not read yet — not the same as zero.

posts_7dinteger nullable required

Posts in the last 7 days, same rules as posts_24h.

posts_30dinteger nullable required

Posts in the last 30 days, same rules as posts_24h.

posts_diasinteger[] nullable required

Posts per day over the last 30 days, oldest first and today last (24-hour windows counted from the request time). null when the feed was not read yet.

posts_no_feedinteger nullable required

Items the feed carried in what we read. 0 is an empty feed, which is not the same as a feed whose posts carry no date.

posts_parcialboolean required

The feed is longer than what we read (10 MB), so the counts are minimums.

atividade_emstring required

When we last read the feed's posts (ISO 8601). Active feeds are re-read daily.

paginastring required

Absolute URL of this record's HTML page.

apistring required

Absolute URL of this resource.

Changes

No recorded changes to this operation across all 1 revision of this API.