JSON API (beta) :: ThreadFinder

Our JSON-based API provides an interface for client developers to interact with content stored on SeedFinder, and to build new applications on top of SeedFinder's infrastructure. The JSON-Files you can get and use very simple with a URL GET or POST request and a little bit JavaScript, PHP or something like that.

Please note:To use our JSON API you must verify your domain(s) here into the User-Area at first!If you do a request from a unregistered domain you will get an Error 403!

Parameters for the request

The request will deliver all strains for the selected thread, including name, breeder and - if available - all other connected threads for every strain in the same forum. The request needs a valid forum-id (see below) and a valid, numeric thread-id out of the selected forum. Info: Your forum have to be connected to the seedfinder before you can use this option, please contact us if you're interested to use this API.

The Response

A valid query returns a JSON file with an object which contains a short info about the status and - if there are strains - an own object for every variety. An invalid request provides an object with an error message. Here is an overview of the possible content.

Object

Name

Value

Description

info

String

A short Info. Example: This thread is connected to 3 strains.

count

Integer

Amount of the strains. Will be 0 if no strains are connected. Example: 3

strains

Object

Strain connected to the thread. This Object will only be existent if there are connected threads!

Object -> [strains]

The object strains contains an own object for every connected strain. The Object(s) are named with an unique breeder/strain-id.

Object -> [strains] -> [strain-id]

Name

Value

Description

id

String

The ID of the strain

brid

String

The ID of the breeder

name

String

Name of the strain

brname

String

Name of the breeder

morethreads

Object | Boolean

Are there more threads connected to this variety? If so, morethreads is an object - if not it's false.

Object -> [strains] -> [strain-id] -> [morethreads]

Name

Value

Description

info

String

Short Info about the threads: Example: 2 more threads about Afghan from Nirvana Seeds.

count

Integer

The amount of threads. Example: 2

threads

Object

This Object contains an own object for every connected thread.

Object -> [strains] -> [strain-id] -> [morethreads] -> [threads]

The object threads contains an own object for every connected thread. The Object(s) are named with a floating number beginning at 0 with an initiating th.

Example

Here you will find a small example (will open in a new window) for the ThreadFinder-Api. But do not expect too much, im not a javascript-expert, its more for your imagination than a ready widget ;) But it will show you whats possible, somehow like this it also could work onto your forum :)

The Upload-Link

You also can alleviate the strain/thread-connection for your forum very simle. If you will use the following Upload-Link you can prefill the form and the user only have to insert the captcha to add a new thread to a strain. (The upload-function do not need an extra SeedFinder-User-Account)
You can use our Breeder/Strain-ID API to grab all breeder- and strain-ids and add dynamic selection-boxes to create the upload-link, look at our small strain-info example to see how it could work...

Allowed Categories: growreport, smokereport, straintalk, misc
Allowed Languages: en, es, fr, de, nl, se
Thread-ID: have to be numeric (or 0 if not given) and a valid one out of the forum.
If you like to let something other empty (without the strain- and breeder-id): add a X.

IMPORTANT

Please note:To use our JSON API you must verify your domain(s) here into the User-Area at first!If you do a request from a unregistered domain you will get an Error 403!

With the help of the SeedFinder API you will be able to use our data for your own applications, widgets and integrate our info directly into your homepage. Use of the API is completely free if you follow the license terms. To stay informed about the API please connect an email to your user-account (so we can contact you if there are questions) and/or drop an eye to our Newsflash! If you don't like add backlinks or if you're running a commercial site, please contact us before using our api.
»» All content is licensed under a Creative Commons BY-NC-SA 3.0 License