# Custom Search Client API

> Custom Search Client API on Apizie: 1 endpoint (The Custom Search API lets you send a search query to Bing and get back web pages found in your custom view…) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/dev-tools:microsoft-cognitiveservices-custom-search/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `dev-tools:microsoft-cognitiveservices-custom-search`
- Category: Dev Tools
- Status: byok
- Source: https://microsoft.com
- Page: https://apizie.tech/api/dev-tools/microsoft-cognitiveservices-custom-search
- OpenAPI: https://apizie.tech/api/dev-tools/microsoft-cognitiveservices-custom-search/openapi.json

The Bing Custom Search API lets you send a search query to Bing and get back search results customized to meet your custom search definition.

## Endpoints

### The Custom Search API lets you send a search query to Bing and get back web pages found in your custom view…
`GET https://apizie.tech/v1/dev-tools:microsoft-cognitiveservices-custom-search/custom-instance-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-BingApis-SDK | string | yes | Activate swagger compliance |
| Accept-Language | string | no | A comma-delimited list of one or more languages to use for user interface strings. The list is in decreasing order of preference. For… |
| X-MSEdge-ClientID | string | no | Bing uses this header to provide users with consistent behavior across Bing API calls. Bing often flights new features and improvements,… |
| X-MSEdge-ClientIP | string | no | The IPv4 or IPv6 address of the client device. The IP address is used to discover the user's location. Bing uses the location information… |
| X-Search-Location | string | no | A semicolon-delimited list of key/value pairs that describe the client's geographical location. Bing uses the location information to… |
| customConfig | string | yes | The identifier for the custom search configuration |
| cc | string | no | A 2-character country code of the country where the results come from. This API supports only the United States market. If you specify… |
| count | integer | no | The number of search results to return in the response. The default is 10 and the maximum value is 50. The actual number delivered may be… |
| mkt | string | no | The market where the results come from. Typically, mkt is the country where the user is making the request from. However, it could be a… |
| offset | integer | no | The zero-based offset that indicates the number of search results to skip before returning results. The default is 0. The offset should be… |
| q | string | yes | The user's search query term. The term may not be empty. The term may contain Bing Advanced Operators. For example, to limit results to a… |
| safeSearch | string | no | A filter used to filter adult content. Off: Return webpages with adult text, images, or videos. Moderate: Return webpages with adult text,… |
| setLang | string | no | The language to use for user interface strings. Specify the language using the ISO 639-1 2-letter language code. For example, the language… |
| textDecorations | boolean | no | A Boolean value that determines whether display strings should contain decoration markers such as hit highlighting characters. If true,… |
| textFormat | string | no | The type of markers to use for text decorations (see the textDecorations query parameter). Possible values are Raw—Use Unicode characters… |

## Example
```
curl "https://apizie.tech/v1/dev-tools:microsoft-cognitiveservices-custom-search/custom-instance-search" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Custom Search Client API?
Create a free Apizie key, then send GET https://apizie.tech/v1/dev-tools:microsoft-cognitiveservices-custom-search/custom-instance-search with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Custom Search Client API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Custom Search Client itself also needs your own key from microsoft.com.

### Can AI agents use the Custom Search Client API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key dev-tools:microsoft-cognitiveservices-custom-search.

### What is the status of the Custom Search Client API?
Needs your own provider key (bring your own key)