Deskhero Developer Hub
Back to deskhero.com
Scrape domains

List

Returns every scrape domain of the workspace with its per domain scrape statistics, plus the workspace's scraped pages used this month against the plan limit (plan_pages_used and plan_pages_max, repeated identically on each domain). Not paginated, filterable or sortable.

GET /api/{tenant:minlength(2)}/v{version:apiVersion}/scrape_domains
Authorisation
Minimum role: USER

Request arguments

Name Type Source
Request body example
No input arguments

Response

Status
200 (OK)
Type
DTO_scrape_domain[]
Wrapper
DTO_response_wrap
Other statuses
400 (BadRequest), 403 (Forbidden)
Response body example
DTO_scrape_domain
NameTypeReadOnlyDescription
created_byDTO_reference_userReadOnlyCreated by
last_updated_byDTO_reference_userReadOnlyLast updated by
idInt32ReadOnlyLeave empty on input
domain_nameStringDomain name
statusENUM scrape_domain_statusReadOnlyStatus
createdDateTimeReadOnlyCreated
scraped_countInt32ReadOnlyScraped count
last_updatedDateTimeReadOnlyLast updated
verifiedDateTime (nullable)ReadOnlyVerified
sitemap_urlStringOptional custom sitemap location. Either a path ("/sitemap_index.xml") or a full URL. Empty = /sitemap.xml
include_pathsStringNewline-separated path patterns to focus the crawl on (e.g. "/legal*"). Empty = whole site
exclude_pathsStringNewline-separated path patterns to skip (e.g. "/sv/*"). Wins over include_paths
primary_languageStringPrimary content language to keep when a site publishes the same page in several languages. Empty = auto-detected from the site
detected_languageStringReadOnlyDetected language
last_scrapedDateTime (nullable)ReadOnlyMost recent successful page crawl on the domain
ignored_countInt32ReadOnlyPages ignored as language duplicates or by path rules
error_countInt32ReadOnlyError count
plan_pages_usedInt32ReadOnlyScraped pages counted against the tenant plan this month
plan_pages_maxInt32ReadOnlyThe tenant plan's monthly scraped-pages limit
pending_countInt32ReadOnlyPages waiting in the crawl queue
DTO_reference_user
NameTypeReadOnlyDescription
profile_picStringReadOnlyProfile pic
emailStringReadOnlyEmail
idInt32Id
labelObjectReadOnlyLabel
ENUM scrape_domain_status
ValueNameDescription
0UNKNOWNUNKNOWN
1PENDINGPENDING
2VERIFIEDVERIFIED

Generated Aug 4, 2026 18:37