Conversion

Fetch one supported public source after explicit caller consent. Supports public HTML/text, Google Docs, Notion pages and bounded databases, GitHub text resources and discussions, Hacker News, and downloadable YouTube audio. No private/login-only sources, Tencent Docs account connection, browser rendering, generic binary downloads, or remote document images. Ordinary documents use URL fetch-time/word billing; YouTube uses audio-to-markdown duration billing (0.5 Credit/minute, minimum 0.3), at most one hour and 32 MB within the account upload limit. Anonymous estimates return job_token for the bounded guest-preview-session flow; authenticated callers confirm with JSON upload_id and a Credit ceiling at POST /v1/jobs. Guest downloads require sign-in, claim, and account settlement.

post/v1/url-estimates

Request

  • Base URL: https://markovo.net
  • URL: https://markovo.net/v1/url-estimates
  • Auth: one of:
    • HTTP bearer
    • none

Request body

urlstring required

A public HTTPS link. The server normalizes bare domains and HTTP links to HTTPS; use a full HTTPS URL for portable clients. Never include credentials.

accept_remote_fetchtrue required

Response

Bounded public-source estimate; YouTube adds source_kind=youtube_audio and duration_ms. Anonymous requests also receive job_token.

upload_idstring required
job_tokenstring

Anonymous estimate ownership token. Keep it private; URL guest previews submit it with upload_id to POST /v1/guest-preview-sessions.

capability_idstring
filenamestring
source_units_estimatedinteger
source_kind'youtube_audio'
duration_msinteger

Present for YouTube audio estimates; billing uses decoded duration.

expires_atstring date-time
credit_scaleunknown required
credit_model_versionstring required
rate_card_versionstring required
estimated_credit_unitsinteger required
estimated_creditsnumber
layout_fidelity'standard' | 'formula'
formula_candidate_pagesinteger[]
page_rangesstring

Normalized page selection echoed for pdf-to-markdown when the request included pages, e.g. "1-3,5,8-12".

pages_selectedinteger

Number of source pages the estimate prices when a page selection applies.

source_pages_totalinteger

Real document page count a page selection was validated against.

billing_metricsobject

Changes

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