POST /v1/copilot
Copilot Search API
Get Microsoft Copilot Search, the AI answer on bing.com/copilotsearch, for any prompt and market: the answer, the sources it cites, the product cards beside it and your brand's mentions.
Updated
Overview
What the Copilot Search API does
POST /v1/copilot asks Microsoft Copilot Search (bing.com/copilotsearch), the AI answer Bing gives logged-out visitors, and returns it as text and markdown with [n](link) citations, the sources it cited and the sponsored products Bing shows beside the answer.
country and language set Bing's market, so you can ask the German market from anywhere. The consumer Copilot app (copilot.microsoft.com) asks logged-out visitors to sign in, so it isn't offered: this endpoint is the Copilot answer on Bing search, which needs no account.
Answers usually take 15–40 s. Add track for mentions of up to 20 brands and domains.
What you get
-
requestobject - The normalised request: endpoint, prompt, country, language (not chatgpt), web_search (chatgpt), include_html.
-
textstring - The answer as plain text.
-
markdownstring - The answer as Markdown. Citations are n, where n is the position of a source in sources.
-
htmlstring - The answer's HTML, only with include_html: true.
-
modelstring - The model the assistant reports to logged-out visitors, when it reports one.
-
sources[]array - position (the n in the citations), title, link, domain, snippet, date, cited (true: cited inline in the answer; false: only listed beside it).
-
search_queries[]array - The searches the assistant ran to answer (its fan-out), where it shows them.
-
products[]array - Product cards shown with the answer: position, title, brand, price (as shown), extracted_price, currency (ISO 4217 when unambiguous), rating, reviews, merchant, link, image, description.
-
places[]array - Local businesses the answer showed, same shape as /v1/maps results.
-
related_questions[]array - Follow-up questions the assistant suggested.
-
mentions[]array - Only with track, one per term: term, mentioned (the answer text names it), cited (a cited source matches it), sources (positions of matching sources, cited or listed), products (positions of matching products), text_position (where the text first names it, 0 = start to 1 = end; -1 when it doesn't). See AI visibility tracking.
-
metaobject - request_id, credits_used, cached, cached_at, engine (the assistant), latency_ms, parse_quality.
Request
curl https://api.serpkite.com/v1/copilot \
-H "Authorization: Bearer $SERPKITE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt":"best mattress for side sleepers","country":"us"}'Response (illustrative; answers vary from run to run)
{
"request": {
"endpoint": "copilot",
"prompt": "best mattress for side sleepers",
"country": "us",
"language": "en"
},
"text": "Side sleepers usually do best on a medium-soft to medium mattress that cushions the shoulders and hips…",
"markdown": "Side sleepers usually do best on a **medium-soft to medium** mattress that cushions the shoulders and hips [1](https://www.example.com/side-sleeper-mattress-guide)…",
"sources": [
{
"position": 1,
"title": "Best mattresses for side sleepers, tested",
"link": "https://www.example.com/side-sleeper-mattress-guide",
"domain": "example.com",
"cited": true
}
],
"search_queries": [],
"products": [
{
"position": 1,
"title": "Example Hybrid Mattress, Queen",
"price": "$899.00",
"extracted_price": 899,
"currency": "USD",
"merchant": "Example Sleep",
"link": "https://shop.example.com/hybrid-queen",
"image": "https://shop.example.com/img/hybrid-queen.jpg"
}
],
"meta": {
"request_id": "req_01J8ZK4M6Q2V7",
"credits_used": 3,
"cached": false,
"engine": "copilot",
"latency_ms": 22400,
"parse_quality": "ok"
}
}
Every response also carries X-Credits-Used, X-Credits-Remaining,
X-Cache and X-Tokens-Estimate headers.
Full endpoint reference
Measured Oct 28, 2026
How Copilot Search API behaves on this endpoint
Logged-out Copilot Search prompts (shopping, informational and how-to) in several markets.
- Answered
- Reliably; an empty answer is an error and costs nothing
- Time to full answer
- Usually 15–40 s
- Market
countryandlanguageset Bing's market: ask the German market from anywhere- Products
- Bing's sponsored product cards, with price and retailer
Filters and limits
-
promptup to 4,000 characters; one turn per request. - The Copilot app at copilot.microsoft.com needs a sign-in and is not offered.
- Products are ads (sponsored cards): treat them as paid placements, not recommendations.
AI visibility
Is your brand in the answer?
tracktakes up to 20 brands ("Pipedrive") and domains ("hubspot.com", subdomains match).- Each comes back in
mentions: named in the text, cited, the matching sources and products, and how early it's named (text_position, 0 to 1). - A monitor asks the prompt hourly, daily or weekly and reports every answer with its mentions and
new_sources, to a signed webhook. Each run costs 3 credits. - Answers vary between runs: ask each prompt several times and track how often you're named. AI visibility guide
{
"mentions": [
{"term": "hubspot.com", "mentioned": true, "cited": true, "sources": [2,5], "products": [], "text_position": 0.08},
{"term": "Pipedrive", "mentioned": true, "cited": false, "sources": [], "products": [], "text_position": 0.41},
{"term": "Acme CRM", "mentioned": false, "cited": false, "sources": [], "products": [], "text_position": -1}
]
}curl https://api.serpkite.com/v1/monitors \
-H "Authorization: Bearer $SERPKITE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"endpoint":"copilot","prompt":"What are the best CRMs for a 10-person startup?","track":["hubspot.com","Pipedrive","Acme CRM"],"interval":"daily","webhook_url":"https://example.com/hooks/serpkite"}'Reference
Parameters
The fields /v1/copilot accepts in its JSON body.
| Name | Type | Default | Description |
|---|---|---|---|
prompt
required
|
string | – | The message to the assistant, up to 4,000 characters. Required. (q is not accepted here.) |
country
|
string | – | Bing's market (ISO 3166-1 alpha-2), with language: the answer, sources and products follow it, wherever the visitor is. |
language
|
string | en | Interface language (e.g. en, de). The answer follows the prompt's language. |
track
|
string[] | – | Up to 20 brands ("Acme") or domains ("acme.com", subdomains match), 100 characters each, to check the answer for. Each comes back in mentions. A term with a dot is a domain: it matches sources and product links on that domain; other terms match whole words, case-insensitively. |
include_html
|
boolean | false | Also return the answer's HTML in html. |
format
|
string | json | markdown returns the answer, its sources, searches, products and a Mentions section as one Markdown document; compact keeps text, sources (n, title, link), search_queries, products and places. Values: json, markdown, compact. |
fields
|
string | – | Comma-separated projection, e.g. results.title,results.link,knowledge_graph. Cuts tokens. |
max_age
|
integer | – | Accept a cached answer up to this many seconds old, at half price. Answers are cached for at most 1 hour, and only a request with max_age reads the cache. |
Full reference, error codes and headers are in the /v1/copilot reference. Queue up to 100 prompts with POST /v1/batches, at the same price per answer.
Use cases
What people build with the Copilot Search API
AI visibility (GEO) tracking
Ask the prompts your buyers ask and see whether the answer names you, cites your domain or lists your product.
Share of answer over time
A monitor asks the same prompt hourly, daily or weekly and reports every answer with its mentions and new sources.
Citation research
Find which pages and domains the assistant cites for your category, then fix or pitch the ones that matter.
Agent tool
Give an agent a second opinion from a public assistant through the MCP tool or one SDK call.
Pricing
Copilot Search API pricing
Cost per call
3 credits
per answer (15–40 s), the same in batches
- From $1.80 per 1,000 answers at volume.
- Credits never expire. No subscription.
- Failed, empty and blocked calls are refunded.
- 2,500 free credits = 833 answers, then 1,000 credits a month.
| Pack | Price | Per 1k credits | Per 1k answers | Answers per pack |
|---|---|---|---|---|
| Starter | $10 | $1.00 | $3.00 | 3,333 |
| Growth | $50 | $0.80 | $2.40 | 20,833 |
| Pro | $300 | $0.60 | $1.80 | 166,666 |
Copilot Search answers cost 3 credits: $3.00 → $1.80 per 1,000 answers, from packs whose credits never expire. For reference, cloro.dev lists Copilot at 5 credits per request on plans from $0.31 to $0.80 per 1,000 credits (checked 2026-10-28).
FAQ
Copilot Search API: common questions
Keep exploring
Related APIs and integrations
Start building
Start with the Copilot Search API
2,500 free credits, then 1,000 every month. No credit card.