Discover the pages of a site. Free 5 times a day per client address (at most 50 pages each) when the request carries no credential or key; then 0.05 USD per call. The page list is the response itself: nothing is recorded, so a lost response cannot be recovered and the charge stands.

post/discover

Request

  • Base URL: https://app.difficat.com/api/v1
  • URL: https://app.difficat.com/api/v1/discover
  • Auth: one of:
    • HTTP payment
    • HTTP bearer

Request body

sourceUrlstring uri required
targetUrlstring uri
sitemapUrlstring uri
maxPagesinteger

Stop after this many pages (default and at most 5000).

Response

OK

strategystring
truncatedboolean

The page ceiling cut the list.

sampleboolean

Present and true when the call ran under the free daily allowance; payment is then absent.

allowanceRemaininginteger

Free run: the units of this kind left for the address today.

Example response

{
  "payment": {
    "amount": "0.50"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.