Proposed application schema
These are recommended fields for your application, not universal vendor field names. Keep the original payload under its provider identity and apply a versioned adapter.
| Identity | provider, provider_id, release_id, version_id | Namespace identifiers by provider. |
| Organizations | issuer_name, issuer_id, distributor, api_provider | Do not label a wire as the issuer. |
| Time | published_at, updated_at, received_at | Store original offset or a stated timezone assumption. |
| Language | language, translated_from, original_url | Keep translations connected without merging their text. |
| Content | headline, summary, body, attachments | Track missing and unauthorized text separately. |
| Permission | rights_profile, allowed_audience, expires_at | Enforce use per source and contract. |
No matching records. Try a broader search.
A concrete difference in documented schemas
Finnhub’s PressRelease response contains a symbol and majorDevelopment items with a headline, datetime, description and URL. newsfilter instead uses article records with a source object and symbol arrays. Their similar subject matter does not mean an adapter can assume the same JSON envelope.
Do not invent time-zone precision
A string such as YYYY-MM-DD HH:MM:SS is not an absolute instant without a defined timezone. The Finnhub development schema describes that format; confirm its timezone for the entitled route rather than assuming UTC. An RSS date with an explicit offset can be normalized while keeping the original value.
Attachments and links need their own policy
A link to a photo, PDF or video is not the same as permission to download or republish it. Keep media type and source URL but fetch or expose the asset only under the relevant agreement. Never extract contacts or boilerplate into a different commercial product just because the API returned them.
Source notes
- Finnhub official API specification ↗
Major press releases endpoint, source names, Enterprise full-text statement and majorDevelopment schema.
- newsfilter request/response format ↗
Metadata schema and source-filtered queries; does not establish downstream full-text rights.
- PR Newswire terms of use ↗
Public-site reuse, scraping and AI restrictions; service-specific agreements may govern a licensed feed.
The Synoptic workflow
Evaluate a Synoptic release workflow
Start with the sources and fields the monitoring task requires.
Evaluate a Synoptic release workflow