› Strain- Breeder ID

JSON API (beta) :: Breeder/Strain-IDs

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 standard-request without parameters will deliver all breeder-ids (including logo and the name) without adding the strain-ids. Additionally you can add the strains for every selected breeder if you set the parameter strains=1. If you dont need info about all breeders use the br-parameter to limit the breeder-output to the selected ones.

ParameterExampleDescription
br?br=Sensi_Seeds
?br=Sensi_Seeds|Dutch_Passion
?br=all
Selection of breeders. Add all to get a full list, or add the SeedFinder-Breeder-IDs for one ore more breeders. To get info about more than one breeder, seperate the ids with a "|".
Preset is all.
strains&strains=1Will add strain-ids and strain-names to the output.
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: http://en.seedfinder.eu/api/json/ids.json
Example: http://en.seedfinder.eu/api/json/ids.json?br=Sensi_Seeds|Dutch_Passion&strains=1

The Response

A valid query returns a JSON file with an object which contains an own object for every breeder (named with the Seedfinder-Breeder-ID). An invalid request provides an object with an error message. Here is an overview of the possible content.

Object -> [breeder-id]

NameValueDescription
nameStringThe name of the breeder.
logoStringThe logo of the breeder. Stored below: http://de.seedfinder.eu/pics/00breeder/
strainsObjectStrain by this breeder. This Object will only be existent if strains=1!

The object strains is only existent if the optional parameter strains=1 was added to the request-url. The object contains name/value pairs for every strain by the breeder, named with the Seedfinder-Strain-ID and with the strain-name as value.

Object -> [breeder-id] -> strains

ValueDescription
StringName of the Strain

Example

The Request http://de.seedfinder.eu/api/json/ids.json?br=Serious_Seeds|Cannabiogen&strains=1 will deliver a JSON like this:

{"Serious_Seeds": {
   "name": "Serious Seeds",
   "logo": "serious.gif",
   "strains": {
      "AK47": "AK47",
      "Bubble_Gum": "Bubble Gum",
      "Chronic": "Chronic",
      "Kali_Mist": "Kali Mist",
      "White_Russian": "White Russian"
      }
   },
"Cannabiogen": {
   "name": "Cannabiogen",
   "logo": "cannabiogen.jpg",
   "strains": {
      "Caribe": "Caribe",
      "Destroyer": "Destroyer",
      "Leshaze": "Leshaze",
      "Sand_Storm": "Sand Storm",
      "Sugar_Loaf": "Sugar Loaf",
      "Taskenti": "Taskenti"
      }
   }
}

Test it

We prepared a small test-widget for you. This example is full working and you can add it very easy to your page. This widget uses the StrainSearch API, the Strain/Breeder-ID API and also the StrainInfo-API to create a complete strain-browser with search-function for your page. Here you will find it. (open in a new window)

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!


Creative Commons BY-NC-SA 3.0 License 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