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.
| Parameter | Example | Description |
|---|---|---|
| forum | ?forum=growerch | ID of the forum like in the list below. |
| thread | &thread=1001 | Numeric thread ID out of the selected forum. |
| output | &output=1 &output=2 | Alternative output-types. Preset is 0 (pure JSON output) Click here to read more about the possible output formats. |
StrainInfo JSON: https://en.seedfinder.eu/api/json/threadfinder.json
Example: https://en.seedfinder.eu/api/json/threadfinder.json?forum=growerch&thread=1001
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.
Object -> [strains] -> [strain-id] -> [morethreads] -> [threads] -> [th]
| Name | Value | Description |
|---|---|---|
| thr | Integer | Thread ID out of the Forum. |
| upd | Integer | Timecode for the last update of this thread in the seedfinder. Example: 1228562743 |
| lng | String | Language of the thread. Example: en |
| cat | String | Seedfinders threadfinder-category-id of this thread. Example: growreport |
| tit | String | Title of the thread out of the forum. |
List of available Forums for this API
Here a list of all forums who are connected to the seedfinder. If your forum is not connected but you like to use this api, please contact us.
| Forum | id |
|---|---|
| 420 Magazine | 420mag |
| Autoflower Network | autofnet |
| Cannabisanbauen.net | cannabau |
| CannabisCafe 2.0 | cannacafe |
| Cannabis.com Forums | cannacom |
| OZ Stoners Forums | cannanation |
| Cannaweed Forum | cannaweed |
| Chuckersparadise | chuckers |
| FCF Forums | fcf |
| Grasscity Forums | grasscity |
| GreenPassion.org | greenpass |
| Grower.ch Forum | growerch |
| Grower.cz Forum | growercz |
| Growery Message Board | growery |
| GrowKind Forums | growkind |
| IC Mag Forums | icmag |
| Jointjedraaien.nl | jointje |
| Lamarihuana Foros | lamarihuana |
| Marijuana Passion | marpassion |
| Marijuana Growing Forums | mjgrowing |
| Mr.Nice Forums | mrnice |
| Olkpiece.org | olkpeace |
| OpenGrow.com | opengrow |
| Overgrow.com | overgrowcom |
| phenohunter.org | phenohunter |
| Reddit.com | |
| Rollitup Forums | rollitup |
| Sensi Seeds Forums | sensi |
| Strain Hunters Forum | strhunters |
| Swecan Forum | swecan |
| The Green Circle | tgc |
| THCfarmer Forums | thcfarmer |
| THCtalk.com | thctalk |
| UK420 Forums | uk420 |
| Wiet Forum [NL] | wietforum |
The JSON
The Request https://de.seedfinder.eu/api/json/threadfinder.json?forum=hb&thread=231958 will deliver a JSON like this:
{
"info": "This thread is connected to 1 strain.",
"count": 1,
"strains": {
"Serious_Seeds_-_Chronic": {
"id": "Chronic",
"brid": "Serious_Seeds",
"name": "Chronic",
"brname": "Serious Seeds",
"morethreads": {
"info": "1 more thread about Chronic from Serious Seeds.",
"count": 1,
"threads": {
"th0": {
"thr": 257701,
"upd": 1220184984,
"lng": "de",
"cat": "growreport",
"tit": "**Chronic**MasterKush**Barney´s Crimea Blue** @ Double B.A.L"
}
}
}
}
}
}
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...
https://de.seedfinder.eu/database/upload/threadfinder/[BREEDER-ID]/[STRAIN-ID]/[FORUM-ID]/[CATEGORY]/[LANGUAGE]/[THREAD-ID]/
Example: https://de.seedfinder.eu/database/upload/threadfinder/Positronics/Caramelice/growerch/growreport/de/12345/
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.
WICHTIG
Bitte beachten: Um unsere JSON API zu nutzen musst du zuvor hier im User-Bereich deine Domain(s) verifizieren!
Kommt die Abfrage von einer unregistrierten Domain wird ein Error 403 ausgeliefert!
Mit Hilfe der SeedFinder API bist du in der Lage unsere Daten für deine eigenen Applikationen und Widgets zu benutzen und kannst unsere Informationen direkt in deine Homepage einbinden. Das Ganze ist im Rahmen unserer Lizenz völlig kostenlos, wir behalten uns aber das Recht vor, bei zu enormen Traffic oder sonstigem ausfallendem Verhalten den Zugriff zu beschränken oder zu blocken. Um informiert zu bleiben wirf bitte ein Auge auf unseren Newsflash und/oder verknüpfe eine Email-Adresse mit deinem User-Account, damit wir dich im Zweifel erreichen können. Falls du keine Links zu uns setzen möchtest, oder eine kommerzielle Seite betreibst, melde dich bitte vorher bei uns.
»» Alle Daten stehen unter einer Creative Commons BY-NC-SA 3.0 Lizenz
