V1#

Functions#

pyinaturalist.v1.controlled_terms#

get_controlled_terms

List controlled terms and their possible values

get_controlled_terms_for_taxon

List controlled terms that are valid for the specified taxon.

pyinaturalist.v1.identifications#

get_identifications

Search identifications

get_identifications_by_id

Get one or more identification records by ID

pyinaturalist.v1.messages#

get_message_by_id

Get a message by ID

get_messages

Get messages from the user's inbox

get_unread_message_count

Get the number of unread messages in the user's inbox

pyinaturalist.v1.observation_fields#

delete_observation_field

Delete an observation field value from an observation

set_observation_field

Create or update an observation field value on an observation

pyinaturalist.v1.observations#

create_observation

Create or update an observation.

delete_observation

Delete an observation

get_observation

Get details about a single observation by ID

get_observation_histogram

Search observations and return histogram data for the given time interval

get_observation_identifiers

Get identifiers of observations matching the search criteria and the count of observations they have identified.

get_observation_observers

Get observers of observations matching the search criteria and the count of observations and distinct taxa of rank species they have observed.

get_observation_popular_field_values

Get controlled terms values and a monthly histogram of observations matching the search criteria.

get_observation_species_counts

Get all species (or other 'leaf taxa') associated with observations matching the search criteria, and the count of observations they are associated with.

get_observation_taxon_summary

Get information about an observation's taxon, within the context of the observation's location

get_observation_taxonomy

Get observation counts for all taxa in observations matching the search criteria.

get_observations

Search observations

get_observations_by_id

Get one or more observations by ID

update_observation

Update a single observation

upload

Upload one or more local photo and/or sound files, and add them to an existing observation.

pyinaturalist.v1.places#

get_places_autocomplete

Given a query string, get places with names starting with the search term

get_places_by_id

Get one or more places by ID

get_places_nearby

Search for places near a given location

pyinaturalist.v1.posts#

get_posts

Search posts

pyinaturalist.v1.projects#

add_project_observation

Add an observation to a project

add_project_users

Add users to project observation rules

delete_project_observation

Remove an observation from a project

delete_project_users

Remove users from project observation rules

get_projects

Search projects

get_projects_by_id

Get one or more projects by ID

update_project

Update a project

pyinaturalist.v1.taxa#

get_life_list_metadata

Get common names and default taxon photos for a user's life list

get_taxa

Search taxa

get_taxa_autocomplete

Given a query string, return taxa with names starting with the search term

get_taxa_by_id

Get one or more taxa by ID

get_taxa_map_layers

Get some additional taxon metadata, including: * GBIF taxon ID and URL * Whether the taxon has range data and/or listed places

pyinaturalist.v1.users#

get_current_user

Get your own user profile

get_user_by_id

Get a user by ID

get_users_autocomplete

Given a query string, return users with names or logins starting with the search term

Submodules#