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¶

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.search¶

A unified search endpoint for places, projects, taxa, and/or users

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¶