Insect.id

Insect detail

This endpoint is alpha beta testing and can change!

Get entity details based on access token from Insect search endpoint.

One call cost 0.5 credits.

get/insect_id/kb/insect/{access_token}

Request

  • Base URL: https://agents.kindwise.com
  • URL: https://agents.kindwise.com/insect_id/kb/insect/{access_token}
  • Auth: none required

Query parameters

detailsstring
Example:common_names,url,description,image

comma separetad list of requested plant details (required) see detail description above

languagestring
Example:en

two-letter ISO 639-1 language code (optional, default en) - language of localized plant details can be multiple (up to 3), separated by comma - i.e. (en,de,sv)

Response

Basic / All details / Multilangual

entity_idstring
languagestring
gbif_idnumber
inaturalist_idnumber
rankstring
common_namesstring[] nullable
dangerstring[]
danger_descriptionstring
rolestring[]
urlstring nullable

Example response

{
  "entity_id": "7ff37dfa393e597b",
  "language": "en",
  "gbif_id": 5743122,
  "inaturalist_id": 61749,
  "rank": "species",
  "taxonomy": {
    "kingdom": "Animalia",
    "phylum": "Arthropoda",
    "class": "Insecta",
    "order": "Coleoptera",
    "family": "Lucanidae",
    "genus": "Lucanus"
  },
  "common_names": [
    "stag beetle",
    "European Stag Beetle"
  ],
  "description": {
    "value": "Lucanus cervus, known as the European stag beetle, is one of the best-known species in Western Europe...",
    "citation": "https://en.wikipedia.org/wiki/Lucanus_cervus",
    "license_name": "CC BY-SA 3.0",
    "license_url": "https://creativecommons.org/licenses/by-sa/3.0/"
  },
  "image": {
    "value": "Lucanus cervus, known as the European stag beetle, is one of the best-known species in Western Europe...",
    "citation": "https://en.wikipedia.org/wiki/Lucanus_cervus",
    "license_name": "CC BY-SA 3.0",
    "license_url": "https://creativecommons.org/licenses/by-sa/3.0/"
  },
  "images": [
    {
      "value": "Lucanus cervus, known as the European stag beetle, is one of the best-known species in Western Europe...",
      "citation": "https://en.wikipedia.org/wiki/Lucanus_cervus",
      "license_name": "CC BY-SA 3.0",
      "license_url": "https://creativecommons.org/licenses/by-sa/3.0/"
    }
  ],
  "danger": [
    "nonvenomous",
    "bites or stings"
  ],
  "danger_description": "This nonvenomous species poses minimal danger to human health. While it can deliver a bite, the bite is generally not harmful and typically results in only minor discomfort. Overall, it is not considered a significant threat to humans.",
  "role": [
    "pollinator"
  ],
  "url": "https://en.wikipedia.org/wiki/Lucanus_cervus"
}

Changes

No recorded changes to this operation across all 1 revision of this API.