Search and Ask

OverviewCopy Anchor Link

Reprompt offers two small, complementary web endpoints:

• Search retrieves normalized web search results for a query. Use it when your application or agent needs the results themselves.
• Ask retrieves search results and produces a fast, single-hop narrative answer grounded in those results. Use it when your user needs a concise answer with sources.

Both endpoints accept the same minimal body. There are no filters, modes, or structured search inputs at launch.

Authentication and base URLCopy Anchor Link

Create an API key in Organization Settings → API Keys, then send it as a bearer token. Reprompt resolves the organization from the authenticated API key, so no organization identifier is required in the URL.

https://api.repromptai.com/v1

SearchCopy Anchor Link

Send a natural-language query to POST /search. The response is a stable, normalized result list; it intentionally does not expose the underlying search-provider response.

curl --request POST \
  --url 'https://api.repromptai.com/v1/search' \
  --header 'Authorization: Bearer {YOUR_API_KEY}' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "What is the difference between a web search API and a research agent?"
  }'

Search responseCopy Anchor Link

{
  "query": "What is the difference between a web search API and a research agent?",
  "answer_box": {
    "answer": "A web search API retrieves ranked web results.",
    "url": "https://example.com/search-apis"
  },
  "results": [
    {
      "title": "Example result title",
      "url": "https://example.com/search-vs-research",
      "snippet": "A short excerpt describing the result.",
      "position": 1,
      "date": "2026-07-25"
    }
  ]
}

Each item in results has a stable normalized shape:

The results array can be empty when no results match the query.

When the search provider supplies them, the response can also include:

• answer_box — a direct answer or featured snippet with its source URL.
• knowledge_graph — entity information such as a title, type, description, website, and scalar facts.

These objects are optional. Build agent logic around results unless it explicitly benefits from enriched search features.

AskCopy Anchor Link

Send the same query to POST /ask to receive a concise narrative answer plus the source objects used to ground it. Reprompt uses DeepSeek V4 Flash through OpenRouter for this endpoint.

curl --request POST \
  --url 'https://api.repromptai.com/v1/ask' \
  --header 'Authorization: Bearer {YOUR_API_KEY}' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "What is the difference between a web search API and a research agent?"
  }'

Ask responseCopy Anchor Link

{
  "query": "What is the difference between a web search API and a research agent?",
  "answer": "A web search API returns relevant documents for a query. A research agent typically uses search as one step in a larger, multi-step process that evaluates sources and synthesizes a response. [1]",
  "sources": [
    {
      "title": "Example result title",
      "url": "https://example.com/search-vs-research",
      "snippet": "A short excerpt describing the result.",
      "position": 1,
      "date": "2026-07-25"
    }
  ]
}

sources uses the same normalized source-object shape as Search results. Render the source URLs alongside the answer so people can inspect the evidence themselves.

Errors and retriesCopy Anchor Link

Both endpoints return JSON errors. Handle these status codes:

For authentication help, see Troubleshooting Authentication & 40x Errors.