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.
| Parameter | Example | Description |
|---|---|---|
| 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: https://en.seedfinder.eu/api/json/search.json
Example: https://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 ->
| Name | Value | Description |
|---|---|---|
| error | String | Boolean | false if there was no error. Containing an error-description if there was one. |
| count | Integer | Amout of strains. |
| info | String | Short infotext. Example: 5 strains was found for your search. |
| strains | Object | Object 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]
| Name | Value | Description |
|---|---|---|
| name | String | Name of the strain. |
| brname | String | Name of the breeder. |
| id | String | ID of the strain. |
| brid | String | ID of the breeder. |
Example
The Request https://fr.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)
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
