{"openapi":"3.1.0","info":{"title":"FPX public article reading API","version":"1.0.0","description":"Free, unauthenticated, read-only search and retrieval of public Hebrew editorial content. No account, payment or publishing operations. See /agent/ for citation and privacy guidance. Versioned routes use /agent-api/v1/; unversioned aliases remain compatible. The separate NLWeb list interface is documented at /agent/. Query endpoints enforce 300 requests per 60 seconds per Worker instance, with RateLimit headers and Retry-After on 429. This is not a global identity quota. Deprecation policy: v1 is active and has no announced deprecation or sunset. Breaking changes use a new major URL version. Deprecated operations will be marked deprecated in this specification and any scheduled retirement documented with Deprecation and Sunset headers. See /agent/#api-version-policy."},"servers":[{"url":"https://www.fpx.co.il"}],"security":[],"paths":{"/agent-api/v1/site/":{"get":{"operationId":"getSiteInfo","summary":"Read FPX identity and access policy","responses":{"200":{"description":"Successful read-only response","content":{"application/json":{"schema":{"type":"object","required":["name","url","description","language","access","documentation","instructions","openapi","sitemap","feed","limitations","apiVersion"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"description":{"type":"string"},"language":{"type":"string"},"access":{"type":"object","required":["authentication","price","operations"],"properties":{"authentication":{"const":"none"},"price":{"const":"free"},"operations":{"const":"read-only"}}},"documentation":{"type":"string","format":"uri"},"instructions":{"type":"string","format":"uri"},"openapi":{"type":"string","format":"uri"},"sitemap":{"type":"string","format":"uri"},"feed":{"type":"string","format":"uri"},"limitations":{"type":"array","items":{"type":"string"}},"apiVersion":{"const":"1"}}}}}},"429":{"description":"Per-Worker-instance read budget exhausted. Retry after Retry-After seconds.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agent-api/v1/search/":{"get":{"operationId":"searchArticles","summary":"Search published article text","description":"All query words must match article text. Results are text matches, not quality rankings. Continue with nextCursor until null.","parameters":[{"name":"q","in":"query","required":true,"description":"Hebrew or English words to match.","schema":{"type":"string","minLength":1,"maxLength":160}},{"name":"limit","in":"query","required":false,"description":"Maximum results per page.","schema":{"type":"integer","minimum":1,"maximum":20,"default":10}},{"name":"cursor","in":"query","description":"Opaque nextCursor from the previous response for the same query. Omit for the first page.","schema":{"type":"string","maxLength":1000}}],"responses":{"200":{"description":"Successful read-only response","content":{"application/json":{"schema":{"type":"object","required":["query","total","offset","limit","items","nextOffset","nextCursor"],"properties":{"query":{"type":"string"},"total":{"type":"integer"},"offset":{"type":"integer"},"limit":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/PageSummary"}},"nextOffset":{"type":["integer","null"]},"nextCursor":{"type":["string","null"]}},"description":"Continue with nextCursor until null; nextOffset is a backward-compatible field."}}}},"400":{"description":"Invalid input or missing public page. See the error code and documentation URL.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Per-Worker-instance read budget exhausted. Retry after Retry-After seconds.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agent-api/v1/article/":{"get":{"operationId":"getArticle","summary":"Read a public article or page","description":"Only public local paths are accepted. This endpoint never fetches external URLs. Preserve returned source metadata and disclosures.","parameters":[{"name":"path","in":"query","required":true,"description":"Local canonical path, e.g. /about/.","schema":{"type":"string","minLength":1,"maxLength":1200}}],"responses":{"200":{"description":"Successful read-only response","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/PageSummary"},{"type":"object","properties":{"markdown":{"type":"string"}},"required":["markdown"]}]}}}},"400":{"description":"Invalid input or missing public page. See the error code and documentation URL.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid input or missing public page. See the error code and documentation URL.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Per-Worker-instance read budget exhausted. Retry after Retry-After seconds.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"PageSummary":{"type":"object","required":["path","url","title","description","author","datePublished","dateModified","categories","markdownUrl"],"properties":{"path":{"type":"string"},"url":{"type":"string","format":"uri"},"title":{"type":"string"},"description":{"type":"string"},"author":{"type":["string","null"]},"datePublished":{"type":["string","null"]},"dateModified":{"type":["string","null"]},"categories":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["name","url"]}},"markdownUrl":{"type":"string","format":"uri"}}},"Error":{"type":"object","required":["error","documentation"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"documentation":{"type":"string","format":"uri"}}}}},"externalDocs":{"description":"API versioning, deprecation and sunset policy","url":"https://www.fpx.co.il/agent/#api-version-policy"}}