Skip to main content

Search Endpoint Migration

Action Required — The /v1/deepsearch endpoint is being renamed to /v1/search. The old endpoint will be deprecated on April 30th, 2025.
We are migrating our search endpoint from /v1/deepsearch to /v1/search to better reflect its capabilities and simplify our API surface.

What’s Changing

Current EndpointNew EndpointDeprecation Date
POST /v1/deepsearchPOST /v1/searchApril 30th, 2025

Timeline

  • Now: Both /v1/deepsearch and /v1/search are fully operational and identical
  • Until April 30th, 2025: Both endpoints function identically
  • After April 30th, 2025: The /v1/deepsearch endpoint will be removed

How to Update

Simply replace deepsearch with search in your API calls: Before:
curl -X POST https://api.valyu.ai/v1/deepsearch \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "your search query"}'
After:
curl -X POST https://api.valyu.ai/v1/search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "your search query"}'

SDK Updates

Our official SDKs handle this automatically. Ensure you’re using the latest versions:
  • Python SDK: pip install --upgrade valyu
  • TypeScript SDK: npm update valyu-js
  • Rust SDK: cargo update -p valyu
The request and response formats remain unchanged. This is purely an endpoint rename.

API Domain Change

We have migrated our API endpoint from api.valyu.network to api.valyu.ai.

What This Means

  • New API endpoint: All API requests should now be directed to https://api.valyu.ai
  • Backward compatibility: The old endpoint https://api.valyu.network will continue to work and remain identical to api.valyu.ai until January 1st, 2026
  • Action required: Please update your integrations to use the new domain at your earliest convenience

Timeline

  • Now: api.valyu.ai is fully operational
  • Until January 1st, 2026: Both api.valyu.network and api.valyu.ai will function identically
  • After January 1st, 2026: The api.valyu.network endpoint will be deprecated

How to Update

Simply replace api.valyu.network with api.valyu.ai in your API calls: Before:
curl -X POST https://api.valyu.network/v1/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "your search query"}'
After:
curl -X POST https://api.valyu.ai/v1/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "your search query"}'

SDK Updates

If you’re using our official SDKs, make sure you’re using the latest version which already points to api.valyu.ai:

Questions?

If you have any questions or concerns about these migrations, please contact us at [email protected] or join our Discord community.