API Documentation

Submitted by admin on Fri, 07/13/2007 - 17:39.
::

We have a RESTful implementation of our service at http://www.captchakiller.com/api.php
Your API key can be found on this page.

The API has 2 simple HTTP POST operations.

  • upload_captcha
  • get_result
  • rate_result

upload_captcha
You must POST with "Content-Type: multipart/form-data".
There are 5 required parameters:

  • method - upload_captcha
  • api_key - string representing the API key
  • file - transmit the CAPTCHA image
  • expire - number of seconds after which CAPTCHA has expired (usually 60 or 300)
  • rights - true or false

Possible results:

  • FAILURE: access denied - get API key from website
  • FAILURE: file_size=0
  • SUCCESS: captcha_id=<string GUID>

get_result
You must POST.
There are 3 required parameters:

  • method - get_result
  • api_key - string representing the API key
  • captcha_id - returned from upload_captcha

Possible results:

  • FAILURE: access denied - get API key from website
  • FAILURE: captcha_id not found
  • FAILURE: expired
  • WAIT: check back later
  • SUCCESS: captcha_result=<textual representation of CAPTCHA>

rate_result
You must POST.
There are 3 required parameters:

  • method - rate_result
  • api_key - string representing the API key
  • captcha_id - returned from upload_captcha
  • success - 1 if captcha was correct, 0 if captcha was not correct

Possible results:

  • FAILURE: access denied - get API key from website
  • FAILURE: captcha_id not found
  • SUCCESS: thanks
Submitted by zackwiny on Mon, 06/30/2008 - 21:49.

I'm getting FAILURE: file_size= and then not even 0

My Post code is:

<form action="http://www.captchakiller.com/api.php" method="post" name="captcha">
<input type="hidden" name="method" value="upload_captcha" id="method" />
<input type="hidden" name="api_key" value="0C1FAC3F-B4FA-89CE-5123-18BA2F151E8F" id="api_key" />
<input type="hidden" name="captcha_url" value="https://www.gamersfirst.com/captcha/?PHPSESSID=irv0jt9cdcp3a734fp065viuo4" id="captcha_url" />
<input type="file" name="file" id="file" /><br>
<input type="submit" name="submit" value="Submit" action="submit" />
</form>

Any ideas?

Submitted by zackwiny on Tue, 07/01/2008 - 10:31.

I decided to use the example perl script and it's working great...
so im going to just embed that into my html page.

Submitted by jonty on Sun, 06/29/2008 - 08:19.

i uploaded a image but no results?

Submitted by KEEPITREAL on Mon, 04/14/2008 - 19:20.

WHAT IS A API CODE AND HOW DO I GET ONE?????

Submitted by sambarider on Wed, 03/19/2008 - 10:07.

I use perl and I'm getting the same error as You :(

Submitted by drew010 on Tue, 01/29/2008 - 15:07.

Is the rate_result method implemented yet? When I attempt to use it I always get back a "FAILURE: unknown method".

I have written a class in PHP5 with some simple usage examples, I'd be happy to post on the site or give it to anyone that requests it.

-Drew

Submitted by KEEPITREAL on Mon, 04/14/2008 - 19:21.

HOW DO I GET A API CODE...CAN YOU HELP ME PLEASE????

Submitted by 619loans on Sat, 02/09/2008 - 17:14.

619Loans - Diego

By George I think I 've got it!!!
ACtually I know I have it. cause it works. So far has been 99% accurate but slow.

I love catcha killer!!!
You only have 30 caotchas per day so test your app carefully

Greg - I am not SPAMMING - 619loans@gmail.com

Submitted by 619loans on Sat, 02/09/2008 - 06:39.

619Loans - Diego USING MS EXCEL VBA

'******************* upload - begin
'Upload file using input type=file
Sub UploadFile(DestURL As String, FileName As String, Optional ByVal FieldName As String = "File")
Dim sFormData As String, d As String

'Boundary of fields.
'Be sure this string is Not In the source file
Const Boundary As String = "---------------------------7d822dd270cd0"

'Get source file As a string.
sFormData = GetFile(FileName)

'Build source form with file contents
d = "--" + Boundary + vbCrLf
d = d + "Content-Disposition: form-data; name=""api_key""" + vbCrLf + vbCrLf
d = d + "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" + vbCrLf
d = d + "--" + Boundary + vbCrLf
d = d + "Content-Disposition: form-data; name=""captcha_url""" + vbCrLf + vbCrLf
d = d + "http://captchacornerhole.com" + vbCrLf
d = d + "--" + Boundary + vbCrLf
d = d + "Content-Disposition: form-data; name=""expire""" + vbCrLf + vbCrLf
d = d + "60" + vbCrLf
d = d + "--" + Boundary + vbCrLf
d = d + "Content-Disposition: form-data; name=""rights""" + vbCrLf + vbCrLf
d = d + "false" + vbCrLf
d = d + "--" + Boundary + vbCrLf
d = d + "Content-Disposition: form-data; name=""files[file_upload]"";"
d = d + " filename=""" + FileName + """" + vbCrLf
d = d + "Content-Type: image/bmp" + vbCrLf + vbCrLf
d = d + sFormData

'Post the data To the destination URL
IEPostStringRequest DestURL, d, Boundary

End Sub

'sends URL encoded form data To the URL using IE
Sub IEPostStringRequest(URL As String, FormData As String, Boundary As String)
'Create InternetExplorer
Dim WebBrowser: Set WebBrowser = CreateObject("InternetExplorer.Application")

'You can uncoment Next line To see form results
WebBrowser.Visible = True

'Send the form data To URL As POST request
Dim bFormData() As Byte
ReDim bFormData(Len(FormData) - 1)
bFormData = StrConv(FormData, vbFromUnicode)

WebBrowser.Navigate URL, , , bFormData, _
"Content-Type: multipart/form-data; boundary=" + Boundary + vbCrLf

Do While WebBrowser.busy
' Sleep 100
DoEvents
Loop
'WebBrowser.Quit
End Sub

'read binary file As a string value
Function GetFile(FileName As String) As String
Dim FileContents() As Byte, FileNumber As Integer
ReDim FileContents(FileLen(FileName) - 1)
FileNumber = FreeFile
Open FileName For Binary As FileNumber
Get FileNumber, , FileContents
Close FileNumber
GetFile = StrConv(FileContents, vbUnicode)
End Function
'******************* upload - end
'use this to get the VBA to work if ya canfigure out how to
'get past the APIRESULT:FAILURE: unknow method ERROR
Sub GetCaptchadNow()
UploadFile "http://www.captchakiller.com/api.php", "E:\Pictures\untitled.bmp", "File"

End Sub

Submitted by lazirus on Sun, 01/13/2008 - 17:02.

hey im just starting to learn this stuff, can anyone hit me up on aim and explain how exactly to use the API code the right way?

aim= itsbiglaz

appreciate it a lot

Submitted by TheIceMan on Sun, 12/23/2007 - 13:50.

How can i find the URL's Captcha Image?

I don't understand how it works.

What do i have to do to use correcly the API code?

Submitted by captsro on Wed, 12/12/2007 - 07:41.

Could it be that u disabled case sensitive? All I now get are small letters... Its important to me to get the gesult case sensitive. Will there be an option to activate it manually or is it disabled just temporarily?

Submitted by captsro on Wed, 12/12/2007 - 08:33.

Ok, all works fine again.. Seems I was too complaining early ^^

Submitted by 619loans on Sat, 02/09/2008 - 06:40.

619Loans - Diego..thnx G-

Submitted by captsro on Wed, 12/12/2007 - 13:59.

Sometimes it returns only small characters and sometimes not o_O

However, great site guys!

Submitted by s2k on Wed, 12/12/2007 - 10:00.

mine is also returning only small letters sometimes. dont know what the problem is. :(

Submitted by MarkE7 on Tue, 12/11/2007 - 18:03.

Encountering an issue starting this morning where CAPTCHAs being sent in for reading are not matching the CAPTCHAs I am looking at on the screen. Any issues going on?

Submitted by Anonymous on Tue, 11/13/2007 - 12:39.

maybe a problem with your server, my captcha alway processing ?

Submitted by phelix on Sat, 07/21/2007 - 17:16.

Ive been trying to run this and for the past 4 hours or so I haven't been able to get it to return anything other than "check back later" Am I doing something wrong or are you guys having problems? IS there a way to make this work more quickly or anything that I can do to help?

Submitted by admin on Sat, 07/21/2007 - 18:15.

We are still in BETA mode, busily adding more servers and staff. Right now you won't get 100% response 24 hours/day.

Smart people are using this service by sleeping on the failure, and trying again in 5 minutes. Then when the service is not so busy, they are able to solve many CAPTCHAs.

Submitted by ozatomic on Mon, 07/16/2007 - 19:30.

How long after posting the capture does it normally take on average? i keep getting the check back latter.

Submitted by admin on Mon, 07/16/2007 - 22:18.

We are growing very rapidly -- please bear with us in this beta phase.
We should be able to get it locked into a sub-60 seconds response.

Submitted by ozatomic on Tue, 07/17/2007 - 01:07.

If one is submitted from the same page url will it remember settings used to decrypt and therefore decrypt it faster?

Submitted by admin on Tue, 07/17/2007 - 09:55.

lol - i think thats the point

Submitted by Anonymous on Thu, 09/13/2007 - 16:31.

im new to the techy world. i commend you guys and gals. amazing work here. but im really trying to figure out is this stuff working with myspace? please dont hate. i run an indie band promotions company on myspace....yeah its been good to me.....yet those damn captchas. i know myspace and the bots were in court for a while. i never did hear how the battle ended up. however i did notice captcha codes as an option in the personal/security settings on myspace. you can choose to have them, or disable them.

is your add on supposed to bypass captcha, or does it just make it more readable?

Submitted by chriswildrq on Fri, 01/18/2008 - 15:21.

did you hear anything back with your request? i'm in the same boat you're in now.

thanks,
-Chris