Public API reference
Read public records, download alternate representations, and use the retained recommendation and radio adapters. Each operation documents its access and execution policy.
Generated from the website’s authoritative contracts using pinned Forge, astro-fern, and fern-forge. Canonical records preserve saved, liked, watched, attended, recommended, and inferred states; bounded results do not establish whole-collection claims.
API overview · OpenAPI · Reference index for agents
The optional TypeScript SDK and CLI use these HTTP contracts. Install the Node 26+ CLI with npm install --global @irvinebroque/public-api-cli, then run irvinebroque operations list --json. For agents, use npm exec --yes --package=@irvinebroque/public-api-cli -- irvinebroque operations list --json. npm installs the matching SDK dependency. Publication follows website deployment and deployed-contract verification; matching release downloads remain available.
activities
- activities list
GET - activities list-head
HEAD - activities list-options
OPTIONS
askBrendan
- askBrendan prepare
POST - askBrendan purchase
POST
blog
- blog list
GET - blog list-head
HEAD - blog list-options
OPTIONS
books
- books list
GET - books list-head
HEAD - books list-options
OPTIONS
calendars
- calendars all
GET - calendars concerts
GET - calendars sports
GET - calendars all-head
HEAD - calendars resolve-head
HEAD - calendars concerts-head
HEAD - calendars sports-head
HEAD - calendars all-options
OPTIONS - calendars concerts-options
OPTIONS - calendars sports-options
OPTIONS - calendars resolve
GET
code
- code list
GET - code list-head
HEAD - code list-options
OPTIONS
concerts
- concerts list
GET - concerts list-head
HEAD - concerts list-options
OPTIONS
discovery
- discovery agent-documentation
GET - discovery agents
GET - discovery ai-access
GET - discovery ai-catalog
GET - discovery api-catalog
GET - discovery authentication-guide
GET - discovery capnweb-declaration
GET - discovery capnweb-metadata
GET - discovery sitemap-content
GET - discovery gpc-policy
GET - discovery graphql-baseline
GET - discovery graphql-example-canonical-lookup
GET - discovery graphql-example-collections
GET - discovery graphql-example-github-projects
GET - discovery graphql-example-portable-and-music
GET - discovery graphql-example-radio-edition
GET - discovery graphql-example-service
GET - discovery graphql-introspection
GET - discovery graphql-parity
GET - discovery graphql-schema
GET - discovery skills-legacy
GET - discovery mcp
GET - discovery mcp-card
GET - discovery openapi
GET - discovery opensearch
GET - discovery resourcesync-capabilities
GET - discovery resourcesync-changes
GET - discovery resourcesync-resources
GET - discovery resourcesync-source
GET - discovery robots
GET - discovery schemamap
GET - discovery security
GET - discovery sitemap-index
GET - discovery sitemap-pages
GET - discovery skills
GET - discovery sql-profile
GET - discovery tdm-policy
GET - discovery traffic-advice
GET - discovery agent-documentation-head
HEAD - discovery agents-head
HEAD - discovery ai-access-head
HEAD - discovery ai-catalog-head
HEAD - discovery api-catalog-head
HEAD - discovery authentication-guide-head
HEAD - discovery capnweb-declaration-head
HEAD - discovery capnweb-metadata-head
HEAD - discovery sitemap-content-head
HEAD - discovery gpc-policy-head
HEAD - discovery graphql-baseline-head
HEAD - discovery graphql-example-canonical-lookup-head
HEAD - discovery graphql-example-collections-head
HEAD - discovery graphql-example-github-projects-head
HEAD - discovery graphql-example-portable-and-music-head
HEAD - discovery graphql-example-radio-edition-head
HEAD - discovery graphql-example-service-head
HEAD - discovery graphql-introspection-head
HEAD - discovery graphql-parity-head
HEAD - discovery graphql-schema-head
HEAD - discovery skills-legacy-head
HEAD - discovery mcp-head
HEAD - discovery mcp-card-head
HEAD - discovery openapi-head
HEAD - discovery opensearch-head
HEAD - discovery resourcesync-capabilities-head
HEAD - discovery resourcesync-changes-head
HEAD - discovery resourcesync-resources-head
HEAD - discovery resourcesync-source-head
HEAD - discovery robots-head
HEAD - discovery schemamap-head
HEAD - discovery security-head
HEAD - discovery sitemap-index-head
HEAD - discovery sitemap-pages-head
HEAD - discovery skills-head
HEAD - discovery sql-profile-head
HEAD - discovery tdm-policy-head
HEAD - discovery traffic-advice-head
HEAD - discovery ai-access-options
OPTIONS - discovery ai-catalog-options
OPTIONS - discovery api-catalog-options
OPTIONS - discovery authentication-guide-options
OPTIONS - discovery sitemap-content-options
OPTIONS - discovery graphql-schema-options
OPTIONS - discovery mcp-options
OPTIONS - discovery mcp-card-options
OPTIONS - discovery resourcesync-capabilities-options
OPTIONS - discovery resourcesync-changes-options
OPTIONS - discovery resourcesync-resources-options
OPTIONS - discovery resourcesync-source-options
OPTIONS - discovery schemamap-options
OPTIONS - discovery sitemap-index-options
OPTIONS - discovery sitemap-pages-options
OPTIONS
events
- events list
GET - events list-head
HEAD - events list-options
OPTIONS
feed
- feed list
GET - feed list-head
HEAD - feed list-options
OPTIONS
feedback
- feedback discovery
GET - feedback policy
GET - feedback receipt
GET - feedback discovery-head
HEAD - feedback policy-head
HEAD - feedback receipt-head
HEAD - feedback submit-options
OPTIONS - feedback discovery-options
OPTIONS - feedback attach-options
OPTIONS - feedback policy-options
OPTIONS - feedback receipt-options
OPTIONS - feedback observe-options
OPTIONS - feedback submit
POST - feedback attach
POST - feedback observe
POST
feeds
- feeds atom
GET - feeds json
GET - feeds podcasts
GET - feeds rss
GET - feeds atom-head
HEAD - feeds json-head
HEAD - feeds podcasts-head
HEAD - feeds rss-head
HEAD - feeds atom-options
OPTIONS - feeds json-options
OPTIONS - feeds podcasts-options
OPTIONS - feeds rss-options
OPTIONS
items
- items resolve-head
HEAD - items resolve
GET
movies
- movies list
GET - movies list-head
HEAD - movies list-options
OPTIONS
music
- music station
POST - music list
GET - music search-index
GET - music list-head
HEAD - music search-index-head
HEAD - music intersect
POST - music list-options
OPTIONS - music search-index-options
OPTIONS - music station-options
OPTIONS - music intersect-options
OPTIONS
photos
- photos list
GET - photos list-head
HEAD - photos list-options
OPTIONS
places
- places csv
GET - places geojson
GET - places gpx
GET - places kml
GET - places list
GET - places list-head
HEAD - places csv-head
HEAD - places geojson-head
HEAD - places gpx-head
HEAD - places kml-head
HEAD - places list-options
OPTIONS - places csv-options
OPTIONS - places geojson-options
OPTIONS - places gpx-options
OPTIONS - places kml-options
OPTIONS
podcasts
- podcasts list
GET - podcasts list-head
HEAD - podcasts list-options
OPTIONS
radio
- radio create-session
POST - radio create-session-options
OPTIONS - radio precise-context
POST - radio context
GET - radio editions
GET - radio program
GET - radio context-head
HEAD - radio editions-head
HEAD - radio import
POST - radio import-options
OPTIONS - radio presence-probe
GET - radio normalize
POST - radio normalize-options
OPTIONS - radio editions-options
OPTIONS - radio replenish
POST - radio replenish-options
OPTIONS
reading
- reading list
GET - reading list-head
HEAD - reading list-options
OPTIONS
recommendation
search
- search query
GET - search query-head
HEAD - search query-options
OPTIONS
service
- service meta
GET - service status
GET - service meta-head
HEAD - service status-head
HEAD - service meta-options
OPTIONS - service status-options
OPTIONS
site
skills
- skills archive
GET - skills markdown
GET - skills archive-head
HEAD - skills markdown-head
HEAD
sports
- sports list
GET - sports list-head
HEAD - sports list-options
OPTIONS
stars
- stars list
GET - stars list-head
HEAD - stars list-options
OPTIONS
taste
- taste profile
GET - taste summary-head
HEAD - taste profile-head
HEAD - taste summary-options
OPTIONS - taste profile-options
OPTIONS - taste summary
GET
tweets
- tweets list
GET - tweets list-head
HEAD - tweets list-options
OPTIONS
videos
- videos list
GET - videos list-head
HEAD - videos list-options
OPTIONS
work
- work list
GET - work list-head
HEAD - work list-options
OPTIONS
writing
- writing list
GET - writing list-head
HEAD - writing list-options
OPTIONS
Native protocols
These retain their existing clients and contracts. The HTTP SDK and CLI discover and download these artifacts; native execution belongs to the linked consumer.
mcp
32 native operations
collection.changesconcerts.listfeed.listmusic.intersectpicks.browsepicks.mentionspicks.openplaces.planplaces.refine_viewplaces.render_mapradio.editionresource:skill://irvinebroque/code-highlights/SKILL.mdresource:skill://irvinebroque/movie-recommendations/SKILL.mdresource:skill://irvinebroque/music-recommendations/SKILL.mdresource:skill://irvinebroque/picks-setup/SKILL.mdresource:skill://irvinebroque/place-recommendations/SKILL.mdresource:skill://irvinebroque/video-recommendations/SKILL.mdresource:ui://taste-explorer/v15/explorer.htmlshortlist.openskills/getskills/listsports.listsports.render_eventssubmit_feedbacktaste.findtaste.gettaste.get_detailtaste.interprettaste.profiletaste.recommendtaste.render_recommendationstaste.summarize
graphql
29 native operations
activitiesblogPostsbookscodeconcertscontentByIdcontentLookupeventsfeedItemsmoviesmusicmusicSearchIndexphotosplaceExportsplacespodcastsportablePlacesradioEditionreadingsearchservicesportingEventsstarsstatustasteProfiletweetsvideosworkTimelinewriting
capnweb
89 native operations
AnyContentCollection.allAnyContentCollection.descriptorAnyContentCollection.itemAnyContentCollection.matchingAnyContentItem.canonicalIdAnyContentItem.canonicalUrlAnyContentItem.citationsAnyContentItem.relatedAnyContentItem.snapshotAnyContentPage.infoAnyContentPage.itemsAnyContentPage.nextAnyContentPage.recordsAnyContentSelection.exportAnyContentSelection.facetsAnyContentSelection.firstAnyContentSelection.matchingAnyContentSelection.orderedByAnyContentSelection.pageAfterBrendanPublicApi.contentBrendanPublicApi.discoveryBrendanPublicApi.feedBrendanPublicApi.serviceBrendanPublicApi.tasteCandidateSet.candidateIdsContentCollection.allContentCollection.descriptorContentCollection.itemContentCollection.matchingContentItem.snapshotContentLibrary.activitiesContentLibrary.blogContentLibrary.booksContentLibrary.codeContentLibrary.concertsContentLibrary.eventsContentLibrary.itemContentLibrary.moviesContentLibrary.musicContentLibrary.photosContentLibrary.placesContentLibrary.podcastsContentLibrary.readingContentLibrary.sportsContentLibrary.starsContentLibrary.tweetsContentLibrary.videosContentLibrary.workContentLibrary.writingContentPage.infoContentPage.itemsContentPage.nextContentPage.recordsContentSelection.exportContentSelection.facetsContentSelection.firstContentSelection.matchingContentSelection.orderedByContentSelection.pageAfterDiscoveryCapability.recommendDiscoveryCapability.searchFeedCapability.latestFeedCapability.resumeFeedSelection.firstFeedSelection.streamMovieTaste.summaryMusicIntersection.matchesMusicIntersection.summaryMusicIntersection.tracksMusicStation.descriptionMusicStation.explainMusicStation.programMusicStation.tracksMusicTaste.editionMusicTaste.intersectMusicTaste.profileMusicTaste.searchMusicTaste.stationRecommendationSet.explainRecommendationSet.infoRecommendationSet.itemsRecommendationSet.recordsSearchResults.facetsSearchResults.firstServiceCapability.descriptionServiceCapability.healthTasteCapability.moviesTasteCapability.musicTasteCapability.recommend
sql
3 native operations
HEADOPTIONSQUERY