Skip to main content
POST
/
search
/
v1
/
search
Perform intelligent web search
curl --request POST \
  --url https://api.case.dev/search/v1/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "additionalQueries": [
    "<string>"
  ],
  "type": "auto",
  "category": "<string>",
  "userLocation": "<string>",
  "numResults": 10,
  "includeDomains": [
    "<string>"
  ],
  "excludeDomains": [
    "<string>"
  ],
  "startCrawlDate": "2023-12-25",
  "endCrawlDate": "2023-12-25",
  "startPublishedDate": "2023-12-25",
  "endPublishedDate": "2023-12-25",
  "includeText": true,
  "contents": "<string>"
}
'
{
  "results": [
    {
      "title": "<string>",
      "url": "<string>",
      "snippet": "<string>",
      "publishedDate": "2023-11-07T05:31:56Z",
      "domain": "<string>"
    }
  ],
  "query": "<string>",
  "totalResults": 123
}

Authorizations

Authorization
string
header
required

API key starting with sk_case_

Body

application/json

Search query and filtering options

query
string
required

Primary search query

additionalQueries
string[]

Additional related search queries to enhance results

type
enum<string>
default:auto

Type of search to perform

Available options:
auto,
search,
news
category
string

Category filter for search results

userLocation
string

Geographic location for localized results

numResults
integer
default:10

Number of search results to return

Required range: 1 <= x <= 100
includeDomains
string[]

Domains to include in search results

excludeDomains
string[]

Domains to exclude from search results

startCrawlDate
string<date>

Start date for crawl date filtering

endCrawlDate
string<date>

End date for crawl date filtering

startPublishedDate
string<date>

Start date for published date filtering

endPublishedDate
string<date>

End date for published date filtering

includeText
boolean

Whether to include full text content in results

contents
string

Specific content type to search for

Response

Search completed successfully

results
object[]

Array of search results

query
string

Original search query

totalResults
integer

Total number of results found