Add a Comic to Taddy’s Directory

When you add your comic to Taddy’s Directory, we notify all supported comic readers that a new comic has been released.

How to add a comic to Taddy

Use the REST endpoint: https://taddy.org/feeds/add/comicseries (POST)

Add your X-USER-ID and X-API-KEY values to the headers (see Intro Guide for instructions on how to get your API Key and User ID)


{
	"X-USER-ID": 7,
	"X-API-KEY": "96c5007c18858e86d..."
}

3. Add sssUrl (required) to the data being passed with the POST request.


{
	"sssUrl": "https://example.com/feeds/sss/comicseries/123",
}

You will get back one of the following responses:

Success: On a successful response you get back a status and the uuid for the added comic.


{
	"status": "success",
	"uuid":  "d682a935-ad2d-46ee-a0ac-139198b83bcc"
}

Error: When we encounter an error adding a new comic to Taddy. We send back a string with the error message.


`Could not add SSS Feed to Taddy`

Example:


curl -X POST \
https://taddy.org/feeds/add/comicseries \
-H "Content-Type: application/json" \
-H "X-USER-ID: 7" \
-H "X-API-KEY: 96c5007c18858e86d..." \
-d '{ "sssUrl": "https://example.com/feeds/sss/comicseries/123" }'

Notes:

Once you send a request: 1) We immediately add the comic to Taddy’s Directory and 2) Queue up a job to parse the comic feed, including all its issues. This second step may take up to 30 mins but is usually much sooner.

Trying to re-add a comic that has already been added to our directory will return a successful response and return the uuid for the already added comic series.

If you are run into any issues, please contact [email protected].

👋

If you are new to using Taddy’s API, Get Started with our 🤖 Intro to Taddy’s API.