Sources

Extract clean rows from a public web page

Send a public, logged-out page URL and the columns you want. A Bearer API key is required; create a free key instantly with POST /v1/keys. A sample comes back first for any new source, so the rows can be checked before anything else.

post/v1/extract

Request

  • Base URL: https://www.licium.ai
  • URL: https://www.licium.ai/v1/extract
  • Auth: HTTP bearer

Request body

urlstring required

Public, logged-out page URL to extract from.

fieldsstring[]

Column names you want back, e.g. ["title", "location", "url"].

Response

Rows extracted. An unverified empty result that is queued for coverage also includes the pot action or a machine-readable unavailability reason.

successtrue required
bounty_idstring uuid
pot_status'needs_fixtures' | 'open' | 'in_progress' | 'delivered'

The pot's own state. needs_fixtures: the pot is on the board but takes no money and no finals until its opener freezes the contract and its example answers; until then the answer has pot_waiting instead of pledge_url.

pot_contract_urlstring uri

Present only while the pot waits and only for the caller who can add its example answers without paying: the key that created the request.

pot_open_urlstring uri

Present while the pot waits when anyone can open it (a request sent without a key): POST it with amount_usd and contract; the pot opens with that contract when the payment goes through.

pledge_urlstring uri

Present once the pot takes money.

subscribe_urlstring uri
pot_unavailable_reason'request_not_found' | 'request_not_queued' | 'caller_cap_reached' | 'board_cap_reached' | 'temporarily_unavailable' | 'not_machine_checkable'

not_machine_checkable: no automatic check can decide the result (no named content fields, or the request text or field names ask for judgment), so no pot opens. Post a bounty with a fixed reward at post_bounty_url instead. This guard applies only to new pots; existing pots keep their original rules.

escalate_urlstring uri
post_bounty_urlstring uri

Changes

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