ShortyShorty
API Reference

List your articles

Returns the authenticated account’s articles (summaries), newest first, cursor-paginated.

GET
/v1/articles

Returns the authenticated account’s articles (summaries), newest first, cursor-paginated. Pass the previous response’s next_cursor as ?cursor= to fetch the next page; a cursor is only valid against the SAME query it was minted under.

Authorization

BearerApiKey
AuthorizationBearer <token>

A Shorty API key, sent as Authorization: Bearer <key>. An OAuth 2.1 access token issued to a connected app is also accepted on the same header.

In: header

Query Parameters

cursor?string
limit?integer
Range1 <= value <= 100
Default20

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/articles"
{  "data": [    {      "id": "string",      "title": "string",      "description": "string",      "article_type": "string",      "source_url": "string",      "created_at": "string"    }  ],  "has_more": true,  "next_cursor": "string"}

Get plan, limits, and usage GET

Returns the authenticated account’s plan (Free / Premium / Pro), tier limits (upload sizes, real-time minutes, conversion caps), and current cloud-conversion usage against the…

Search your articles GET

Full-text search over the authenticated account’s own articles (matches title, description, source URL).