Curveybooru

Update 10/30: favoriting a post will now automatically upvote the post if you haven't already upvoted it.

« 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 100 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.

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.