Command status: Active
Supported by OpenApps API: Yes
Supported by Internal/Reseller API: Yes
Possibly queued processing: n/a


This command submits URLs for our webcrawler to crawl. We cannot guarantee that every URL can be crawled.

Resources consumed

Resource Description


50 per queried item


Parameter Description


Required: must be set to: SubmitURLsToCrawl


Optional - defaults to historic
Either: "fresh" - to query against Fresh Index, or "historic" - to query against Historic Index.

item0, item1, item2, item3 ... item999

All items can belong to URL, subdomain or root domain levels.
Up to 1000 items can be added

Sample queries and response

XML response

<?xml version="1.0" encoding="UTF-8"?>
<Result Code="OK" ErrorMessage="" FullError="">
<GlobalVars IndexBuildDate="2013-02-24 21:47:24" IndexType="1" ServerBuild="2017-10-18 15:56:19" ServerName="XSTHEMACHINE" ServerVersion="1.0.6500.26889" UniqueIndexID="20130224214724-FRESH" URLsAdded="2" />

JSON response

  "Code": "OK",
  "ErrorMessage": "",
  "FullError": "",
  "IndexBuildDate": "2013-02-24 21:47:24",
  "IndexType": 1,
  "ServerBuild": "2017-10-18 15:56:19",
  "ServerName": "XSTHEMACHINE",
  "ServerVersion": "1.0.6500.26889",
  "UniqueIndexID": "20130224214724-FRESH",
  "URLsAdded": 2

Returned values

Return value Description
Code Code indicating if this command executed successfully.
ErrorMessage A message explaining the error. This will be blank if the code is "OK".
FullError Verbose explanation of error.
IndexBuildDate Date/time the index that was queried was last updated.
IndexType Indicates if the index was Historic (0) or Fresh (1).
ServerBuild Date/time the server was built.
ServerName Name of the server queried.
ServerVersion Version of the server queried.
UniqueIndexID Unique identifier for the index consisting of the date and index type.
URLsAdded Number of URLs submitted.