› Search-API

JSON API (beta) :: Strain Search

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 will deliver all strains, ordered by name. We search for the exact phrase (but not case sensitive) in the name and the breeders description.
Options: Use * in the search-string as wildcard. Examples:
Super Skunk: Find strains that contain the exact phrase "Super Skunk".
Super Skunk*: Find also strain like "Super Skunk x Haze".
super*skunk Find strains that contain "super skunk", "Superskunk" or "superhaze x skunk".
*skunk* find strains that contain skunky, superskunk or specialskunkhaze.

ParameterExampleDescription
q?q=Super%20Skunk
?q=Skunk%20%231
?q=%2ASuper%2ASkunk%2A
The search-string.
If you use GET, url-encode the special chars.
For example %20 for a space, %23 for # or %2A instead of *.
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/search.json
Example: http://en.seedfinder.eu/api/json/search.json?q=Super%20Skunk

The Response

A valid query returns a JSON file with IDs and Names for the matching strains. An invalid request provides an object with an error message. Here is an overview of the possible content.

Object ->

NameValueDescription
errorString | Booleanfalse if there was no error. Containing an error-description if there was one.
countIntegerAmout of strains.
infoStringShort infotext. Example: 5 strains was found for your search.
strainsObjectObject for the strains.

The object strains is only existent if there was at least one strain found.
It contains an own Object for every strain, named with a Strain-ID.

Object -> strains -> [strain-id]

NameValueDescription
nameStringName of the strain.
brnameStringName of the breeder.
idStringID of the strain.
bridStringID of the breeder.

Example

The Request http://de.seedfinder.eu/api/json/search.json?q=Lemon%20Skunk will deliver a JSON like this:

{
"error": false,
"count": 3,
"info": "3 strains was found for your search.",
"strains": {
 "Lowlife_Seeds_-_Automatic_Lemon_Skunk": {
  "name": "Automatic Lemon Skunk",
  "brname": "Lowlife Seeds",
  "id": "Automatic_Lemon_Skunk",
  "brid": "Lowlife_Seeds"
  },
 "DNA_Genetics_Seeds_-_Lemon_Skunk": {
  "name": "Lemon Skunk",
  "brname": "DNA Genetics Seeds",
  "id": "Lemon_Skunk",
  "brid": "DNA_Genetics_Seeds"
  },
 "Green_House_Seeds_-_Lemon_Skunk": {
  "name": "Lemon Skunk",
  "brname": "Green House Seeds",
  "id": "Lemon_Skunk",
  "brid": "Green_House_Seeds"
  }
 }
}

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