Live · v1

Public API

Read-only access to the Own A Sentence archive. Search by number, category, or keyword. Embed sentences on your site, power LLM integrations, or build developer showcases.

            Base URL: https://ownasentence.com/api/v1
        

Rate Limit

60 requests / 60 seconds per IP

Auth

None — fully open, read-only

Format

JSON — UTF-8, pretty-printed

Endpoints

GET

/api/v1/sentences

Paginated list of approved sentences

Parameter	Type	Default	Description
page	integer	1	Page number
limit	integer	20	Results per page (max 50)
category	string	—	Filter by category slug
sort	string	newest	newest · oldest · most_viewed · most_liked

{ "sentences": [ { "number": 1, "text": "My dog has been dead for three years...", "category": "society", "owner": "Founding Seed", "views": 11, "likes": 1, "approved_at": "2026-06-10 12:53:12", "public_url": "https://ownasentence.com/sentence/1" } ], "meta": { "total": 36, "page": 1, "limit": 20, "pages": 2, "sort": "newest" } }

↗ Try it live

GET

/api/v1/sentences/{number}

Single sentence by its public number

Replace {number} with the sentence's public archive number (e.g. 1, 27).

↗ Try /api/v1/sentences/1

GET

/api/v1/search

Keyword search across all sentences

Parameter	Type	Required	Description
q	string	Yes	Search query (max 200 chars)
category	string	No	Filter by category slug
page	integer	No	Page number
limit	integer	No	Results per page (max 50)

↗ Try /api/v1/search?q=internet

GET

/api/v1/random

Random approved sentence, optional category filter

Parameter	Type	Description
category	string	Limit random pick to one category

↗ Try it live

GET

/api/v1/categories

All categories with sentence counts

↗ Try it live

GET

/api/v1/stats

Archive statistics — total sentences, slots, percentage claimed

↗ Try it live

Example: Embed a random sentence

fetch('https://ownasentence.com/api/v1/random') .then(r => r.json()) .then(data => { const s = data.sentence; document.getElementById('oas').innerHTML = '<blockquote>"' + s.text + '"</blockquote>' + '<a href="' + s.public_url + '">#' + s.number + ' on Own A Sentence</a>'; });

Usage & Attribution

The API is free and open for personal projects, developer tools, LLM integrations, and research. Attribution is required — include a link back to ownasentence.com wherever sentences are displayed. Commercial use at scale requires prior written permission. See Terms.