From 25cf910f7bf26179ea337c95df060e6a99cc42ae Mon Sep 17 00:00:00 2001 From: Fuwn Date: Mon, 23 Feb 2026 09:51:17 -0800 Subject: docs: add booru api references and held-post plans --- docs/api/safebooru-dapi-help.html | 159 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 159 insertions(+) create mode 100644 docs/api/safebooru-dapi-help.html (limited to 'docs/api/safebooru-dapi-help.html') diff --git a/docs/api/safebooru-dapi-help.html b/docs/api/safebooru-dapi-help.html new file mode 100644 index 0000000..bf4554e --- /dev/null +++ b/docs/api/safebooru-dapi-help.html @@ -0,0 +1,159 @@ + + + + + + + + + + + + + + + + + + + + Safebooru + + + + + + + + + + + + + + + + +
+
+
+

API Basics

+ You should never receive an error unless the server is overloaded or the search dies. In cases of the searcher breaking, you will receive a response success of "false" and a message stating "search down" or similiar.

+
+

Posts

+

List

+Url for API access: index.php?page=dapi&s=post&q=index

+
    +
  • limit How many posts you want to retrieve. There is a hard limit of 1000 posts per request.
    • +
  • pid The page number.
    • +
  • tags The tags to search for. Any tag combination that works on the web site will work here. This includes all the meta-tags. See cheatsheet for more information.
    • +
  • cid Change ID of the post. This is in Unix time so there are likely others with the same value if updated at the same time.
    • +
  • id The post id.
    • +
  • json Set to 1 for JSON formatted response.
    • +
+ +

Deleted Images

+Url for API access: index.php?page=dapi&s=post&q=index&deleted=show

+
    +
  • last_id A numerical value. Will return everything above this number.
    • +
+
+
+

Comments

+

List

+Url for API access: ndex.php?page=dapi&s=comment&q=index

+
    +
  • post_id The id number of the comment to retrieve.
    • +
+ +
+ +
+

Tags

+

List

+Url for API access: index.php?page=dapi&s=tag&q=index
+
+
    +
  • id The tag's id in the database. This is useful to grab a specific tag if you already know this value.
    • +
  • limit How many tags you want to retrieve. There is a default limit of 100 per request.
    +
    • +
+ +
\ No newline at end of file -- cgit v1.2.3