The elements picked on a site's pages

The elements picked on a site's pages.

# The elements picked on a site's pages

> tidekeeper's API reference: https://tidekeeper.eu/docs/api/get-sites-site-picks

`GET /api/v1/sites/{site}/picks`

The elements picked on a site's pages.

## Parameters

- `site` (in path, needed): A site's id or name

## The answer

200, `A list of PickedView`: An element picked on a stored copy of a page (the Picker board): a click on what its selector matches is an event.

- `attr` (string or null)
- `by` (string, needed)
- `event` (string, needed)
- `id` (string, needed)
- `made` (integer, needed)
- `path` (string or null): The one path it counts on. None: every page where it matches.
- `prop` (string or null): A property sent with it, and where its value comes from: one of the element's attributes, or a fixed text.
- `says` (string, needed): What it sends, in a line.
- `selector` (string, needed)
- `value` (string or null)

## Asking

```sh
curl https://tidekeeper.eu/api/v1/sites/example.org/picks \
    -H "Authorization: Bearer $TIDEKEEPER_TOKEN"
```

Parameters

sitein the address

neededA site's id or name

The answer

Status 200

A list of PickedView An element picked on a stored copy of a page (the Picker board): a click on what its selector matches is an event.

attr

string or null

by

stringneeded

event

stringneeded

id

stringneeded

made

integerneeded

path

string or nullThe one path it counts on. None: every page where it matches.

prop

string or nullA property sent with it, and where its value comes from: one of the element's attributes, or a fixed text.

says

stringneededWhat it sends, in a line.

selector

stringneeded

value

string or null

Asking

curl https://tidekeeper.eu/api/v1/sites/example.org/picks \
    -H "Authorization: Bearer $TIDEKEEPER_TOKEN"

const answer = await fetch("https://tidekeeper.eu/api/v1/sites/example.org/picks", {
  headers: {
    Authorization: `Bearer ${process.env.TIDEKEEPER_TOKEN}`,
  },
}).then((r) => r.json());