Public read-only interface

API & Agent Resources

Search and retrieve SFW social-media image and playable video previews. All responses include canonical HTML source pages, stable item API URLs, same-origin image URLs, source-series metadata, and available descriptive context.

Endpoints

Search mediaGET /api/v1/search?q=stepsis&media=image

List playable clipsGET /api/v1/content?media=video&sort=newest

Get one itemGET /api/v1/content/{type}/{id}

OpenAPI descriptionGET /openapi.json

Service statusGET /api/v1/health

MCP transportPOST /mcp

A2A servicePOST /a2a/v1/message:send

Search filters

Use q, type, media, performer, category, sort, page, and limit. The maximum page size is 100. The q parameter searches titles, people, source series, descriptions, countries, and alt text. The category filter selects a source series. Search ranks exact, token, prefix, and substring matches, then recency.

curl "https://npnetworkofficial-com.swivvle.workers.dev/api/v1/search?q=Kitty%20Wild&type=model&limit=10"

curl "https://npnetworkofficial-com.swivvle.workers.dev/api/v1/search?q=stepsis&media=image&limit=10"

curl "https://npnetworkofficial-com.swivvle.workers.dev/api/v1/content?media=video&sort=newest"

Contextual metadata

Every result includes its title, publication date, people, source-series categories, image metadata, and optional playable video. The following fields appear when the upstream JSON feed supplies them:

categoriesSource series and site names; usable with the category filter.

descriptionAvailable model biography or series context.

sfwTitleAlternate safe-for-work title when supplied by the source.

countryModel country when supplied.

seasonNumber / episodeNumberPositive season and episode numbers.

totalPhotosReported photoset image count.

starRating / favoriteCountReported source popularity metadata.

age / height / figureModel facts exactly as reported by the source.

Descriptive context is searchable and agent-facing. It is not used for image alt text or rendered on public media cards.

MCP transport

Connect to https://npnetworkofficial-com.swivvle.workers.dev/mcp and use search_media, list_recent_media, or get_media_item. Call get_media_image for one result to return the actual preview bytes as native MCP image content, or show_media_gallery to render the bounded inline gallery in MCP Apps-compatible clients. Raw image-block display remains client dependent. This stateless endpoint accepts MCP JSON-RPC over POST; standalone GET event streams are not enabled.

Usage

No authentication is required. Read responses are cacheable and support cross-origin access. Keep requests bounded, reuse cached responses, and avoid high-frequency polling; the catalog refreshes twice daily.

OpenAPI JSON Browse previews