# Social signals: organisations' public posts, by link

Links to recent public posts by the official accounts of organisations (câmaras, public bodies, venues, organisers, news outlets, companies) on Bluesky and Mastodon, with metadata only: account, time, matched topics and places, language, media or not. No post text or media is stored.

Three layers: **the source** (who publishes it, the terms, when it was read), **the raw data** as the publisher served it, and **the processed data**, what this site makes of it. The processing is where the value is: named fields, places joined, gaps marked, every value kept with its source and time.

## 1. The source

## At a glance

| Field | Value |
|---|---|
| Publisher | The organisations themselves, through Bluesky (public AppView API) and Mastodon (public instance API) |
| Source | [https://public.api.bsky.app/xrpc/](https://public.api.bsky.app/xrpc/) |
| Reader page | [https://bsky.app/](https://bsky.app/) |
| Schedule | every 6 hours: the Pages workflow (.github/workflows/pages.yml) at 17 minutes past 00, 06, 12 and 18 UTC; every other hourly run keeps the last read, copied from the live site |
| Owner | data.b@PrompTugal.dinis |
| Collector | [sources/social/collect.mjs](https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/sources/social/collect.mjs) |
| Since | 2026-11-18 |
| Last read | 2026-11-18 19:17 UTC |
| Last run | partly failed: 5 requests ok, 5 failed |
| Now | 147 posts |
| Licence | The data: [the source's terms](https://bsky.social/about/support/tos) (each post's author (an organisation)). This page, the card and the records we add: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). |

## Reuse terms

Organisations only, official interfaces only, by link. Bluesky: robots.txt of the public API allows crawling it and asks for backoff on 429; the Terms of Service (14 Aug 2025) leave each post's content with its author, so we store link and metadata only and credit the organisation. Mastodon: mastodon.social's terms (effective 2026-08-31) say whoever owns the content retains ownership and allow API access; its robots.txt disallows only /media_proxy/, /interact/ and a domain-blocks path. Licence on each post: the platform's terms, holder the organisation. Not reviewed by a person. Reuse: links and metadata only, credited to the organisation, under the platform's terms; no post text or media republished.

> Crawling the public parts of the API is allowed. HTTP 429 ("backoff") status codes are used for rate-limiting. Up to a handful concurrent requests should be ok.
>
> The publisher's words (en), from [https://public.api.bsky.app/robots.txt](https://public.api.bsky.app/robots.txt), read on 2026-11-18.

**Open question:** Dinis to confirm the Bluesky terms (https://bsky.social/about/support/tos) are enough for links plus metadata, and which more organisation accounts to add (register/social-accounts.json notes).

## 2. The raw data

The raw answers hold the posts' text, which this site never stores: only each post's link and metadata are kept.

## 3. The processed data

The collector reads the public posts of the organisation accounts on the register through Bluesky's public API, matches topics and places in memory, and keeps the link, account, time, matches, language and whether there is media. The result: [latest.json](/api/v1/social/latest.json).

Posts per day by organisation, and the topics and places they match. The data: [/api/v1/social/latest.json](/api/v1/social/latest.json).

## More about this source

## What runs by code, by agents and by people

### Code

- the collector reads each listed account's recent posts and a keyword pass on Bluesky, keeps only links and metadata, and writes latest.json and reads.json
- collect/social-by-place.mjs derives data/social/by-place/<place>.json from latest.json
- GitHub Actions runs it and deploys the site

### Agents

- data.b.collector@PrompTugal.dinis (Sonnet) researched the platforms' terms and the accounts and wrote the collector and this card on 18 November 2026, for data.b@PrompTugal.dinis

### People

- Dinis Cruz decided the social signals on 18 November 2026 (board/guidance/2026-11-18-social-signals.md); no person has checked the accounts or values yet (not reviewed)

## Cost

| Field | Value |
|---|---|
| per run tokens | 0 |
| per run model cost usd | 0 |
| runner | GitHub Actions on a public repository: no charge; about 10 requests a run (measured locally, 18 November 2026) |
| build tokens | not measured |
| note | Code only: no model is called when the data is collected. |

## API addresses

These addresses stay for the life of v1 ([the contract](/api/v1/README.md)).

| File | Address |
|---|---|
| Latest read | [https://data.promptugal.news/api/v1/social/latest.json](https://data.promptugal.news/api/v1/social/latest.json) |
| Every read | [https://data.promptugal.news/api/v1/social/reads.json](https://data.promptugal.news/api/v1/social/reads.json) |
| Card | [https://data.promptugal.news/api/v1/social/card.json](https://data.promptugal.news/api/v1/social/card.json) |
| OpenAPI | [https://data.promptugal.news/api/v1/social/openapi.json](https://data.promptugal.news/api/v1/social/openapi.json) |

```
curl -s https://data.promptugal.news/api/v1/social/latest.json
curl -s https://data.promptugal.news/api/v1/social/reads.json | head -c 600
```

## Vault

Vault not yet created. The collector writes the bytes of each read to a vault copy; until the vault exists they are not kept.

## Last runs

| Time (UTC) | Requests ok | Requests failed | Reads with changed bytes |
|---|---|---|---|
| 2026-11-18 19:17 UTC | 5 | 5 | 1 of 10 |
| 2026-11-18 19:12 UTC | 5 | 5 | 0 of 10 |
| 2026-11-18 19:08 UTC | 5 | 5 | 0 of 10 |
| 2026-11-18 19:05 UTC | 5 | 5 | 2 of 10 |
| 2026-11-18 18:57 UTC | 5 | 5 | 0 of 10 |
| 2026-11-18 18:54 UTC | 5 | 5 | 2 of 10 |
| 2026-11-18 17:56 UTC | 5 | 5 | 2 of 10 |
| 2026-11-18 17:41 UTC | 5 | 5 | 3 of 10 |
| 2026-11-18 16:32 UTC | 5 | 5 | 3 of 10 |
| 2026-11-18 16:13 UTC | 5 | 5 | 0 of 10 |
| 2026-11-18 16:10 UTC | 5 | 5 | 2 of 10 |
| 2026-11-18 16:06 UTC | 5 | 5 | 2 of 10 |
| 2026-11-18 16:01 UTC | 5 | 5 | 2 of 10 |
| 2026-11-18 15:57 UTC | 5 | 5 | 0 of 10 |
| 2026-11-18 15:53 UTC | 5 | 5 | 1 of 10 |
| 2026-11-18 15:49 UTC | 5 | 5 | 2 of 10 |
| 2026-11-18 15:45 UTC | 5 | 5 | 1 of 10 |
| 2026-11-18 15:42 UTC | 5 | 5 | 0 of 10 |
| 2026-11-18 15:38 UTC | 5 | 5 | 1 of 10 |
| 2026-11-18 15:35 UTC | 5 | 5 | 3 of 10 |
| 2026-11-18 15:30 UTC | 5 | 5 | 2 of 10 |
| 2026-11-18 15:16 UTC | 5 | 5 | 0 of 10 |
| 2026-11-18 15:10 UTC | 5 | 5 | 1 of 10 |
| 2026-11-18 15:07 UTC | 5 | 5 | 10 of 10 |

Showing 24 of 24 runs kept. Full detail with sha256: [reads.json](https://data.promptugal.news/api/v1/social/reads.json).

## Preview of the values

The first 5 of 147 entries in `posts`, as read 2026-11-18 19:17 UTC. Source: [https://public.api.bsky.app/xrpc/](https://public.api.bsky.app/xrpc/). Long values are shortened here; the file has them whole.

| platform | url | account | organisation | kind | posted_at | Source |
|---|---|---|---|---|---|---|
| bluesky | https://bsky.app/profile/publico.pt/post/3n2mbdycphl2i | publico.pt | Público | news outlet | 2026-11-18T19:15:01.6892444Z | [source](author feed) |
| bluesky | https://bsky.app/profile/publico.pt/post/3n2mbdxahr32i | publico.pt | Público | news outlet | 2026-11-18T19:15:00.566859Z | [source](author feed) |
| bluesky | https://bsky.app/profile/publico.pt/post/3n2mbdwia7p2b | publico.pt | Público | news outlet | 2026-11-18T19:14:59.7727381Z | [source](author feed) |
| bluesky | https://bsky.app/profile/publico.pt/post/3n2mafkn2nj2v | publico.pt | Público | news outlet | 2026-11-18T18:58:00.7131574Z | [source](author feed) |
| bluesky | https://bsky.app/profile/publico.pt/post/3n2mafjdpzl2a | publico.pt | Público | news outlet | 2026-11-18T18:57:59.3600572Z | [source](author feed) |

---

Version v0.1.47 · data read 2026-11-18 19:18 UTC · Code Apache-2.0; our pages, records and visualisations CC BY 4.0; each source's data under its own licence or terms, linked · [Repository](https://github.com/PrompTugal/PrompTugal__News__Data) · [Pay for what you read](https://promptugal.news/account/) · https://data.promptugal.news/sources/social/
