Skip to main content
Endpoint
POST /search/v1/search
import Casedev from 'casedev';

const client = new Casedev({ apiKey: 'sk_case_YOUR_API_KEY' });

const results = await client.search.v1.search({
  query: 'medical malpractice statute of limitations California',
  numResults: 20,
  includeText: true
});

for (const result of results.results) {
  console.log(result.title, result.url);
}
Response
{
  "results": [
    {
      "title": "California Medical Malpractice Laws",
      "url": "https://law.cornell.edu/california/medical-malpractice",
      "publishedDate": "2024-03-15",
      "score": 0.95,
      "text": "California Code of Civil Procedure Section 340.5..."
    }
  ]
}

Parameters

ParameterTypeDefaultDescription
querystringRequiredSearch query
numResultsnumber10Number of results (max 100)
typestringautoauto, keyword, or neural
includeDomainsarrayOnly include these domains
excludeDomainsarrayExclude these domains
startPublishedDatestringPublished after (ISO date)
endPublishedDatestringPublished before (ISO date)
includeTextbooleanfalseInclude page text in results

Examples

TypeScript
const results = await client.search.v1.search({
  query: 'HIPAA compliance requirements',
  includeDomains: ['law.cornell.edu', 'hhs.gov', 'findlaw.com'],
  numResults: 20,
  includeText: true
});

News search with date range

TypeScript
const results = await client.search.v1.search({
  query: 'SEC cryptocurrency enforcement',
  startPublishedDate: '2024-01-01',
  excludeDomains: ['reddit.com', 'twitter.com'],
  type: 'keyword'
});

Company research

TypeScript
const results = await client.search.v1.search({
  query: 'Acme Corporation lawsuit settlement',
  includeDomains: ['reuters.com', 'bloomberg.com', 'wsj.com'],
  startPublishedDate: '2023-01-01',
  includeText: true
});
Tip: Use includeDomains to restrict results to authoritative sources.