Deskhero Developer Hub
Back to deskhero.com
Scrape parse configs

Create

Creates a parse configuration for a scrape domain, an XPath that says which part of a scraped page becomes knowledge, together with its sub configurations which are stored as children of it. All sub configurations must carry the same scrape_domain_id, every unique_key has to be distinct within the domain, and apply_on_url_pattern is only allowed on the top level configuration.

POST /api/{tenant:minlength(2)}/v{version:apiVersion}/scrape_parse_configs
Authorisation
Minimum role: ADMIN

Request arguments

Name Type Source
inputDTO_scrape_parse_configBody
Request body example

Response

Status
200 (OK)
Type
DTO_scrape_parse_config
Wrapper
DTO_response_wrap
Other statuses
400 (BadRequest), 403 (Forbidden)
Response body example
DTO_scrape_parse_config
NameTypeReadOnlyDescription
created_byDTO_reference_userReadOnlyCreated by
last_updated_byDTO_reference_userReadOnlyLast updated by
sub_configsDTO_scrape_parse_config[]Sub configs
idInt32ReadOnlyLeave empty on input
scrape_domain_idInt32Scrape domain id
apply_on_url_patternStringApply on url pattern
unique_keyStringUnique key
xpathStringXpath
is_collectionBooleanIs collection
extraction_modeENUM scraper_parse_extraction_modeExtraction mode
post_process_ruleENUM scraper_parse_post_processPost process rule
used_lastDateTime (nullable)Will update if it was more than 10 minutes (or similar) to avoid too many updates.
createdDateTimeReadOnlyCreated
last_updatedDateTimeReadOnlyLast updated
DTO_reference_user
NameTypeReadOnlyDescription
profile_picStringReadOnlyProfile pic
emailStringReadOnlyEmail
idInt32Id
labelObjectReadOnlyLabel
DTO_scrape_parse_config
NameTypeReadOnlyDescription
created_byDTO_reference_userReadOnlyCreated by
last_updated_byDTO_reference_userReadOnlyLast updated by
sub_configsDTO_scrape_parse_config[]Sub configs
idInt32ReadOnlyLeave empty on input
scrape_domain_idInt32Scrape domain id
apply_on_url_patternStringApply on url pattern
unique_keyStringUnique key
xpathStringXpath
is_collectionBooleanIs collection
extraction_modeENUM scraper_parse_extraction_modeExtraction mode
post_process_ruleENUM scraper_parse_post_processPost process rule
used_lastDateTime (nullable)Will update if it was more than 10 minutes (or similar) to avoid too many updates.
createdDateTimeReadOnlyCreated
last_updatedDateTimeReadOnlyLast updated
ENUM scraper_parse_extraction_mode
ValueNameDescription
0NOT_SETNOT_SET
1INNER_HTMLINNER_HTML
2INNER_TEXTINNER_TEXT
3ATTRIBUTE_HREFATTRIBUTE_HREF
4ATTRIBUTE_SRCATTRIBUTE_SRC
5DATETIMEDATETIME
6ARIA_LABELARIA_LABEL
ENUM scraper_parse_post_process
ValueNameDescription
0NOT_SETNOT_SET
1PATH_JOINPATH_JOIN

Generated Aug 4, 2026 18:37