{"openapi":"3.1.0","info":{"title":"Apizie","version":"2.0.0","description":"One API key, one envelope, many public data sources."},"servers":[{"url":"https://zieapi.vercel.app"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/web-tools:rss-reader/read":{"get":{"operationId":"web_tools_rss_reader_read","summary":"Read a feed","description":"Fetch one RSS/Atom/RDF feed URL and return its items as JSON (title, link, summary, date, author, categories, image).","tags":["web-tools"],"parameters":[{"name":"url","in":"query","required":true,"description":"Feed URL (http or https, public host)","schema":{"type":"string","description":"Feed URL (http or https, public host)"},"example":"https://feeds.npr.org/1001/rss.xml"},{"name":"limit","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":20,"minimum":1,"maximum":100,"description":"Number of results"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":300,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/web-tools:rss-reader/discover":{"get":{"operationId":"web_tools_rss_reader_discover","summary":"Discover feeds on a website","description":"Given a website or article URL, list the RSS/Atom feeds it advertises in its HTML (<link rel=\"alternate\">). If the URL is itself a feed, it is returned.","tags":["web-tools"],"parameters":[{"name":"url","in":"query","required":true,"description":"Website or page URL","schema":{"type":"string","description":"Website or page URL"},"example":"https://techcrunch.com"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/web-tools:rss-reader/merge":{"get":{"operationId":"web_tools_rss_reader_merge","summary":"Merge feeds into one timeline","description":"Fetch up to 10 feeds at once and return one list sorted newest first, with duplicates (same link) removed. Feeds that fail are reported, not fatal.","tags":["web-tools"],"parameters":[{"name":"urls","in":"query","required":true,"description":"Feed URLs (max 10), as an array or comma-separated","schema":{"type":"array","description":"Feed URLs (max 10), as an array or comma-separated"},"example":["https://feeds.npr.org/1004/rss.xml","https://www.aljazeera.com/xml/rss/all.xml"]},{"name":"limit","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":30,"minimum":1,"maximum":200,"description":"Number of results"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":300,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"RunEnvelope":{"type":"object","required":["project","data","timestamp"],"properties":{"project":{"type":"string","example":"dev-tools:hash"},"data":{},"timestamp":{"type":"string","format":"date-time"}}},"ErrorEnvelope":{"type":"object","properties":{"content":{},"message":{"type":"string"},"errors":{"type":"array","items":{}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"responses":{"Error":{"description":"Invalid key, plan gate, rate limit or upstream failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}