Programmatic API

Searchee provides programmatic access for external AI agents and applications that need web search and crawling workflows.

1) API Access Overview

Programmatic access includes:

• Search endpoints for structured search results.
• Crawler and tool endpoints for retrieval workflows.
• Agent search endpoints for enriched AI-assisted search pipelines.

API access is account-based and key-based. Each request is associated with an API key and evaluated against plan entitlements, scopes, and usage controls.

2) Getting Started

1. Create an account at /auth/register.
2. Sign in at /auth/login.
3. Create an API key by calling POST /auth/api-keys (authenticated via the HttpOnly searchee_session cookie set by /auth/login).
4. Store the returned API key secret securely (it is shown only once).
5. (Optional) List/revoke keys via GET /auth/api-keys and DELETE /auth/api-keys/{keyId}.
6. Send requests using your API key in the x-api-key header.

3) Basic Request Pattern

Use your API key in request headers:

x-api-key: <your_api_key>

Example search query:

GET /search?q=privacy+search&format=json

4) Scopes, Limits, and Billing

• API keys can be scoped to specific products.
• Rate limits and quotas are enforced by plan and policy.
• Enterprise prepaid usage debits wallet units from billable events.
• Subscription and prepaid pricing details are documented on the pricing page.

5) Security Best Practices

• Never embed API keys in client-side code.
• Rotate keys when exposure is suspected.
• Use separate keys per environment/application.
• Monitor usage to detect anomalies early.

6) Legal and policy

• API Privacy Notice — how API requests, keys, metering, and logs are handled.
• API Terms of Use — rules for key-based access, quotas, and acceptable use of the APIs.
• Privacy Policy and Terms of Use — general product and account terms.

7) Need help?

If you need onboarding support for enterprise or integration guidance, please contact us through the channels listed on the About page.