Notion API master series 14 - Analysis - Retrieve a page property Item
Notion API Master Series (Finished)
Reference API URL : Retrieve a page property item
Already mentioned partly from Analysis -Retrieve a page, but there's one more point.
notion.pages.properties.retrieve(page_id='1f217cc1-225f-4580-8e22-cd7eb8db3c5e',
property_id='%3EQQn')We know page_id, but what is property_id?
Let's find out properties.
'properties': {'상태': {'id': '%3EQQn',
'select': {'color': 'orange',
'id': 'ed26ef07-df97-4ced-9275-9aa0c71d5bb1',
'name': '★★'},
'type': 'select'},
'이름': {'id': 'title',
'title': [{'annotations': {'bold': False,
'code': False,
'color': 'default',
'italic': False,
'strikethrough': False,
'underline': False},
'href': None,
'plain_text': '옐로우피자',
'text': {'content': '옐로우피자',
'link': None},
'type': 'text'}],
'type': 'title'}}Here we can identify two ids. First is '%3EQQn' another is 'title'. These property ids are property_id.
It is the way how to call.
notion.pages.properties.retrieve(page_id='1f217cc1-225f-4580-8e22-cd7eb8db3c5e',
property_id='%3EQQn')Call like above, and response is as below.
{'id': '%3EQQn',
'object': 'property_item',
'select': {'color': 'red',
'id': '38c1a71b-fd4d-4353-858b-646d8305332a',
'name': '★★★★★★'},
'type': 'select'}Show the id of related property.
-
page_size (int32)
For paginated properties. The max number of property item objects on a page. The default size is 100
We can set the result size at once. If we skip, API brings 100 bunches of information as the default value.
-
start_cursor (string)
For paginated properties.
If the return value is has_more : True, and also return value gives next_cursor value together.
'has_more': True,
'next_cursor': 'XYVaKx',
'object': 'list',
'property_item': {'id': 'qgqA',
'next_url': ...
Input next_cursor value into start_cursor and call retrieve. Then we can bring more results.
