FeaturesTemplatesShowcaseTownie
AI
BlogDocsPricing
Log inSign up
Kymmsy
KymmsyTLDR
Users paste a URL, and the app returns a 3-sentence summary
Public
Like
1
TLDR
Home
Code
4
backend
2
frontend
1
shared
2
README.md
Branches
1
Pull requests
Remixes
History
Environment variables
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
Sign up now
Code
/
backend
/
README.md
Code
/
backend
/
README.md
Search
6/2/2025
Viewing readonly version of main branch: v6
View latest version
README.md

Backend - TLDR This API

The backend is built with Hono and provides API endpoints for article summarization.

Features

  • URL Content Extraction: Fetches and parses HTML content from URLs
  • Text Summarization: Uses OpenAI API to generate concise summaries
  • Error Handling: Comprehensive error handling for various failure scenarios
  • Static File Serving: Serves frontend assets and shared utilities

API Endpoints

POST /api/summarize

Summarizes article content or URL.

Request Body:

{ "content": "URL or article text", "isUrl": true/false }

Response:

{ "success": true, "summary": "Generated summary...", "title": "Article Title", "originalUrl": "https://example.com" // only for URLs }

Error Response:

{ "success": false, "error": "Error description" }

GET /api/health

Health check endpoint.

Response:

{ "status": "ok", "timestamp": "2024-01-01T00:00:00.000Z" }

Environment Variables

  • OPENAI_API_KEY - Required for AI summarization

Error Handling

The API handles various error scenarios:

  • Invalid URLs or unreachable content
  • OpenAI API failures
  • Malformed requests
  • Content too short to summarize
  • Network timeouts
Go to top
X (Twitter)
Discord community
GitHub discussions
YouTube channel
Bluesky
Product
FeaturesPricing
Developers
DocsStatusAPI ExamplesNPM Package Examples
Explore
ShowcaseTemplatesNewest ValsTrending ValsNewsletter
Company
AboutBlogCareersBrandhi@val.town
Terms of usePrivacy policyAbuse contact
© 2025 Val Town, Inc.