VerifyScience API

{
  "user_id": "user_abc123",
  "email": "[email protected]",
  "subscription": "professional",
  "verifications_left": 485,
  "verifications_limit": 499,
  "rate_limit": "60 requests/minute"
}

{
  "id": "job_dc2f5b45-73ac-420e-9eac-a78c2f9a0abe",
  "status": "processing",
  "message": "Verification started successfully"
}

{
  "id": "job_dc2f5b45-73ac-420e-9eac-a78c2f9a0abe",
  "status": "completed",
  "result": {
    "confidence": 78,
    "confidence_level": "High",
    "summary": "This research demonstrates strong methodology...",
    "domain_category": "Clinical trial methodology",
    "domain_detail": "Randomised controlled trial",
    "criteria": [
      {
        "name": "Analytical Dimension",
        "score": 85,
        "assessment": "Adequate sample size for statistical power"
      },
      {
        "name": "Methodology",
        "score": 82,
        "assessment": "Well-designed experimental approach"
      }
    ],
    "strengths": ["Large sample size", "Controlled variables"],
    "limitations": ["Limited follow-up period"],
    "created_at": "2026-03-25T00:30:00Z"
  }
}

{
  "verifications": [
    {
      "id": "job_dc2f5b45-73ac-420e-9eac-a78c2f9a0abe",
      "status": "completed",
      "confidence": 78,
      "created_at": "2026-03-25T00:30:00Z"
    },
    {
      "id": "job_e4a1b2c3-d4e5-f6g7-h8i9-j0k1l2m3n4o5",
      "status": "processing",
      "progress": 45,
      "created_at": "2026-03-24T22:15:00Z"
    }
  ],
  "total": 14,
  "limit": 50,
  "offset": 0
}

{
  "status": "error",
  "error": {
    "code": "BATCH_TOO_LARGE",
    "message": "Batch exceeds limit for professional tier",
    "details": {
      "papers_submitted": 25,
      "max_allowed": 20,
      "tier": "professional"
    },
    "next_steps": [
      "Reduce to 20 papers or less",
      "Enterprise plan supports up to 50 papers per batch"
    ]
  }
}

{
  "batch_id": "batch_550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "total_papers": 3,
  "completed_papers": 3,
  "failed_papers": 0,
  "progress_percent": 100,
  "success_rate": 100,
  "created_at": "2026-04-05T08:30:00Z",
  "started_at": "2026-04-05T08:30:05Z",
  "completed_at": "2026-04-05T08:32:18Z",
  "duration_seconds": 133,
  "should_poll": false,
  "verifications": [
    {
      "id": "job_dc2f5b45-73ac-420e-9eac-a78c2f9a0abe",
      "batch_index": 0,
      "status": "completed",
      "result": {
        "title": "Effects of Exercise on Cognitive Function in Older Adults",
        "confidence": 82,
        "summary": "Well-designed RCT with adequate statistical power...",
        "analysis": [
          { "criterion": "Analytical Dimension", "score": 85, "explanation": "..." },
          { "criterion": "Assessment Area", "score": 80, "explanation": "..." }
        ]
      },
      "completed_at": "2026-04-05T08:31:02Z"
    }
  ]
}

// Start a verification
const startVerification = async () => {
  const response = await fetch('https://www.verifyscience.co.uk/v1/verifications', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer vs_live_your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      text: 'Your research text here...',
      metadata: {
        title: 'Study Title',
        source: 'Journal Name'
      }
    })
  });

  const data = await response.json();
  console.log('Verification started:', data.id);
  
  // Poll for results
  return pollForResults(data.id);
};

// Check verification status
const pollForResults = async (jobId) => {
  const response = await fetch(`https://www.verifyscience.co.uk/v1/verifications/${jobId}`, {
    headers: {
      'Authorization': 'Bearer vs_live_your_api_key_here'
    }
  });

  const data = await response.json();
  
  if (data.status === 'completed') {
    console.log('Verification complete!', data.result);
    return data.result;
  } else {
    console.log('Still processing...', data.progress, '%');
    // Wait 2 seconds and check again
    await new Promise(resolve => setTimeout(resolve, 2000));
    return pollForResults(jobId);
  }
};

startVerification();

import requests
import time

API_KEY = 'vs_live_your_api_key_here'
BASE_URL = 'https://www.verifyscience.co.uk'

headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Content-Type': 'application/json'
}

# Start verification
response = requests.post(
    f'{BASE_URL}/v1/verifications',
    headers=headers,
    json={
        'text': 'Your research text here...',
        'metadata': {
            'title': 'Study Title',
            'source': 'Journal Name'
        }
    }
)

data = response.json()
job_id = data['id']
print(f'Verification started: {id}')

# Poll for results
while True:
    response = requests.get(
        f'{BASE_URL}/v1/verifications/{id}',
        headers=headers
    )
    data = response.json()
    
    if data['status'] == 'completed':
        print('Verification complete!')
        print(f"Confidence: {data['result']['confidence']}%")
        print(f"Summary: {data['result']['summary']}")
        break
    else:
        print(f"Still processing... {data.get('progress', 0)}%")
        time.sleep(2)

const axios = require('axios');

const API_KEY = 'vs_live_your_api_key_here';
const BASE_URL = 'https://www.verifyscience.co.uk';

const client = axios.create({
  baseURL: BASE_URL,
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  }
});

async function verifyResearch(text, metadata = {}) {
  try {
    // Start verification
    const { data: startData } = await client.post('/v1/verifications', {
      text,
      metadata
    });

    console.log('Verification started:', startData.id);

    // Poll for results
    while (true) {
      const { data: statusData } = await client.get(
        `/v1/verifications/${startData.id}`
      );

      if (statusData.status === 'completed') {
        console.log('Verification complete!');
        return statusData.result;
      }

      console.log(`Progress: ${statusData.progress}%`);
      await new Promise(resolve => setTimeout(resolve, 2000));
    }
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
    throw error;
  }
}

// Example usage
verifyResearch(
  'Your research text here...',
  { title: 'Study Title', source: 'Journal Name' }
).then(result => {
  console.log('Confidence:', result.confidence);
  console.log('Summary:', result.summary);
});