The newest stories
GET /api/v1/stories
GET https://terminal.cloud.wavo.me/api/v1/storiesThe newest stories on the wire, newest first, as the front page lists them: headline, publisher, topic, summary, and links to the article and to its page here. topic keeps one topic's, and q those that say a word or a name; an empty list means none among the newest, not none on the wire.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
topic | query | one of recorded, rights, live, platforms, capital, policy | No | Only this topic's stories. |
q | query | string, 1–200 characters | No | A word or a name its headline, summary or publisher says, in any case: an artist, a label, a company. |
Request
curl 'https://terminal.cloud.wavo.me/api/v1/stories?topic=live'Response
200, application/json: the Stories schema in /openapi.json.
| Field | Type | Description |
|---|---|---|
readAt | string | When the front page's read was made; it is kept a minute. |
stories | array of objects | The newest stories, newest first. |
stories[].id | string | The story's id: GET /api/v1/stories/{id} opens it. |
stories[].headline | string | |
stories[].summary | string | The publisher's summary; empty when it gave none. |
stories[].topic | object | |
stories[].topic.id | one of recorded, rights, live, platforms, capital, policy | |
stories[].topic.label | string | |
stories[].publisher | object | |
stories[].publisher.id | string | |
stories[].publisher.name | string | |
stories[].author | string or null | |
stories[].publishedAt | string | An instant, ISO 8601 in UTC. |
stories[].url | string | The article, at its publisher. |
stories[].page | string | The story's page on Wavo Intelligence. |
stories[].imageUrl | string or null |
Statuses
Every answer carries RateLimit-Policy; a refusal is an RFC 9457 problem, whose codes Errors lists.
| Status | When |
|---|---|
200 | The newest stories. |
400 | A parameter its schema refuses: invalid_parameter, naming it. |
405 | Any method but GET: method_not_allowed. The API only reads. |
429 | The IP address spent its bucket: rate_limit_exceeded. |
503 | The read behind the answer failed: read_failed. Retry shortly. |