docs: add booru api references and held-post plans

1 files changed, 24 insertions, 0 deletions

diff --git a/docs/api/README.md b/docs/api/README.md
new file mode 100644
index 0000000..c6f3918
--- /dev/null
+++ b/docs/api/README.md
@@ -0,0 +1,24 @@
+# Supported Provider API Docs (Snapshot)
+
+These are local HTML snapshots of API documentation for providers currently supported by Sora.
+Fetched on 2026-02-23 (US/Pacific) using `curl -L` with a browser user agent.
+
+## Sources
+
+- Danbooru: https://danbooru.donmai.us/wiki_pages/help:api
+  - Local copy: `docs/api/danbooru-help-api.html`
+- Yande.re (Moebooru): https://yande.re/help/api
+  - Local copy: `docs/api/yandere-help-api.html`
+- Konachan (Moebooru): https://konachan.com/help/api
+  - Local copy: `docs/api/konachan-help-api.html`
+- Sakugabooru (Moebooru): https://sakugabooru.com/help/api
+  - Local copy: `docs/api/sakugabooru-help-api.html`
+- Gelbooru: https://gelbooru.com/index.php?id=18780&page=wiki&s=view
+  - Local copy: `docs/api/gelbooru-howto-api.html`
+- Safebooru (Gelbooru-family DAPI): https://safebooru.org/index.php?page=help&topic=dapi
+  - Local copy: `docs/api/safebooru-dapi-help.html`
+
+## Notes
+
+- These are point-in-time copies and may drift from live docs.
+- Re-fetch when changing provider request/auth/pagination/sort behavior.