Answer questions - Context.dev

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    mode: 'fast',
    task: 'Find the pricing page URL and plan names for context.dev.',
    json_format: {pricing_page_url: '', plans: [{name: ''}]}
  })
};

fetch('https://api.context.dev/v1/web/answers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "json_content": {},
  "sources": [
    "<string>"
  ],
  "partial": true,
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "INTERNAL_ERROR",
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "INTERNAL_ERROR",
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "INTERNAL_ERROR",
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "INTERNAL_ERROR",
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "INTERNAL_ERROR",
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "INTERNAL_ERROR",
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

POST

/

web

/

answers

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    mode: 'fast',
    task: 'Find the pricing page URL and plan names for context.dev.',
    json_format: {pricing_page_url: '', plans: [{name: ''}]}
  })
};

fetch('https://api.context.dev/v1/web/answers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "json_content": {},
  "sources": [
    "<string>"
  ],
  "partial": true,
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "INTERNAL_ERROR",
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "INTERNAL_ERROR",
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "INTERNAL_ERROR",
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "INTERNAL_ERROR",
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "INTERNAL_ERROR",
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "INTERNAL_ERROR",
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

10 or 100 credits See the guide for examples and usage.

Authorizations

Authorization

string

header

required

Send Authorization: Bearer <API_KEY>. Keys have full access unless restricted to scopes.

Body

application/json

task

string

required

Research task. The agent selects company/profile lookups, web searches, or page reads. Include domains or URLs to focus the research.

Required string length: 1 - 2000

mode

enum<string>

fast prioritizes speed, with extra verification for people and companies; ultra supports deeper research (default).

Available options:

fast,

ultra

json_format

object

Example answer object, not JSON Schema. Up to 8 levels, 500 values, and 16000 characters; unknowns may be null.

Show child attributes

timeoutOpts

object

Request deadline and what to return when it passes.

Show child attributes

tags

string[]

Labels for filtering usage in the dashboard.

Maximum array length: 20

Required string length: 1 - 50

Example:

["production", "team-alpha"]

zdr

enum<string>

enabled turns on zero data retention. Returns 403 ZDR_NOT_ENABLED unless your organization has ZDR.

Available options:

enabled,

disabled

Response

The requested JSON shape, plus the sources used

json_content

object

required

The answer, in the shape requested by json_format.

Show child attributes

sources

string[]

required

Public evidence URLs from searches, pages, or company/profile records, in first-seen order. A listed URL may identify a record without its page being read.

partial

boolean

True when the request deadline ended research and the answer uses the evidence collected so far.

key_metadata

object

Credits this request used and your remaining balance.

Show child attributes