# Yard Search
> Search through podcast transcripts with AI-powered search

This is a fan-made transcript search tool for the Yard Search podcast.
You can search for any topic, quote, or moment from the show.

## What This Site Does
- Full-text search across all podcast episode transcripts
- AI-powered semantic search to answer questions about the podcast
- Timestamp-accurate results that link directly to YouTube

## API Endpoints (Public, No Auth Required)

### Search Transcripts
GET https://yard-search.com/api/search?q={query}&pageSize={limit}

Returns matching transcript segments with timestamps.
- q: Search query (required, min 2 chars)
- pageSize: Results per page (default 50, max 100)
- page: Page number (default 1)

Example: https://yard-search.com/api/search?q=funny+story&pageSize=10

### Get Episode List  
GET https://yard-search.com/api/episodes?limit={n}

Returns list of episodes with metadata.

### Get Episode Details
GET https://yard-search.com/api/episodes/{videoId}

Returns episode metadata and full transcript.

## Response Format
All endpoints return JSON. Search results include:
- episodeId: YouTube video ID
- episodeTitle: Episode title
- text: Transcript segment text
- startTime: Timestamp in seconds
- thumbnailUrl: Episode thumbnail

## Rate Limits
- Search: No strict limit, be reasonable
- AI Search: Rate limited, requires human verification

## Contact
This is a fan project. For issues, see the site footer.

## See Also
- OpenAPI spec: https://yard-search.com/openapi.json
- Sitemap: https://yard-search.com/sitemap.xml