Shared terms#
| Field | Meaning |
|---|---|
| id | Public retained-record identity; use the value returned |
| source_url | Retained provenance link, possibly null or a platform search URL |
| published_at | Publisher date where retained; not first collection |
| collected_at | Collection clock, with dataset-specific semantics |
| observed_at | Time a social list appearance was observed |
| period | Economic reference period |
| as_of | Query snapshot timestamp, not a query parameter |
| row_count | Count in this page, not a matching total |
| next_cursor | Opaque continuation for the same query; on /api/changes it equals next_since |
| next_since | Signed change-feed checkpoint from /api/changes or mode=changes; pass it back as since |
| first_seen / last_seen | First and latest collection of a document's source URL |
| observation_count | How many times that URL was collected; a repeat is not a new document |
| change_type / change_at | new, newly_discovered or revised, and when (UTC) on the change feed |
| unavailable_fields | Fields this deployment cannot fill yet; they are null, not empty |
| title_lang / is_translated | Presentation language and machine-translation flag |
Missing values#
Null means the field is not available or not applicable under that dataset's contract. It is not zero, an empty measurement, no revision, or permission to infer a fact. An omitted field may be excluded by your fields projection. Read the field list and coverage notes before normalizing.
Original and translated titles#
Preserve both when present. Use original wording for source verification and the translation for discovery. Translations are not publisher-authored English unless the source itself is English.