> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gptproto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# claude-opus-4-7-thinking (Web Search)

## Authentication

1. Sign up for a GPTProto account at [https://gptproto.com](https://gptproto.com)
2. Navigate to the API Keys section in your dashboard
3. Generate a new API key (sk-xxxxx)
4. Copy and securely store your API key
   For authentication details, please refer to the [Authentication](https://docs.gptproto.com/authentication.md) section.

## Initiate Request

```bash cURL theme={null}
curl --location 'https://gptproto.com/v1/chat/completions' \
--header 'Authorization: GPTPROTO_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "model": "claude-opus-4-7-thinking",
  "messages": [
    {
      "role": "user",
      "content": "What'\''s the weather in NYC?"
    }
  ],
  "tools": [
    {
      "type": "web_search_20250305",
      "name": "web_search",
      "max_uses": 5
    }
  ],
  "stream": false
}'

```

```javascript JavaScript theme={null}
const axios = require('axios');
let data = JSON.stringify({
  "model": "claude-opus-4-7-thinking",
  "messages": [
    {
      "role": "user",
      "content": "What's the weather in NYC?"
    }
  ],
  "tools": [
    {
      "type": "web_search_20250305",
      "name": "web_search",
      "max_uses": 5
    }
  ],
  "stream": false
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://gptproto.com/v1/chat/completions',
  headers: { 
    'Authorization': 'GPTPROTO_API_KEY', 
    'Content-Type': 'application/json'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});


```

```python Python theme={null}
import requests
import json

url = "https://gptproto.com/v1/chat/completions"

payload = json.dumps({
  "model": "claude-opus-4-7-thinking",
  "messages": [
    {
      "role": "user",
      "content": "What's the weather in NYC?"
    }
  ],
  "tools": [
    {
      "type": "web_search_20250305",
      "name": "web_search",
      "max_uses": 5
    }
  ],
  "stream": False
})
headers = {
  'Authorization': 'GPTPROTO_API_KEY',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)


```

```go Go theme={null}
package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://gptproto.com/v1/chat/completions"
  method := "POST"

  payload := strings.NewReader(`{
  "model": "claude-opus-4-7-thinking",
  "messages": [
    {
      "role": "user",
      "content": "What's the weather in NYC?"
    }
  ],
  "tools": [
    {
      "type": "web_search_20250305",
      "name": "web_search",
      "max_uses": 5
    }
  ],
  "stream": false
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "GPTPROTO_API_KEY")
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

```

> [accordion] Response Example
>
> ```json theme={null}
> {
>   "id": "chatcmpl-abc123",
>   "object": "chat.completion",
>   "created": 1699896916,
>   "model": "claude-opus-4-6",
>   "choices": [
>     {
>       "index": 0,
>       "message": {
>         "role": "assistant",
>         "content": "# Document Analysis Summary\n\n## Key Information:\n- Document Type: Technical API Documentation\n- Total Pages: 35\n- Version: 2.0\n\n## Main Topics:\n1. **Authentication**: The API uses Bearer token authentication with API keys\n2. **Endpoints**: Contains 12 main API endpoints for different operations\n3. **Rate Limiting**: Implements tiered rate limiting based on subscription level\n4. **Error Handling**: Comprehensive error codes and handling strategies\n\n## Key Sections:\n\n### Getting Started\n- Quick start guide for new developers\n- Authentication setup instructions\n- First API call examples in multiple languages\n\n### API Reference\n- Detailed endpoint documentation\n- Request/response formats\n- Parameter descriptions and constraints\n\n### Best Practices\n- Recommended usage patterns\n- Performance optimization tips\n- Security considerations\n\n### Code Examples\n- Python, JavaScript, Go, and cURL examples\n- Common use case implementations\n- Error handling patterns\n\n## Important Notes:\n- All requests must include valid API key\n- Rate limits: 100 requests/minute for free tier, 1000/minute for premium\n- Support for both JSON and XML response formats\n- Webhook notifications available for asynchronous operations"
>       },
>       "finish_reason": "stop"
>     }
>   ],
>   "usage": {
>     "prompt_tokens": 3500,
>     "completion_tokens": 285,
>     "total_tokens": 3785
>   }
> }
> ```

## Parameters

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `model` | string | ✅ Yes | `claude-opus-4-6` | The model to use for the request |
| `messages` | array | ✅ Yes | `[{"role": "user", "content": "What's the weather in NYC?"}]` | Array of message objects for the conversation. Each message must have a role (user or assistant) and content. |
| `tools` | array | ✅ Yes | - | Array of tool objects. For web search, must include the web\_search tool configuration. |
| `stream` | boolean | ❌ No | `false` | Whether to stream the response |
| `temperature` | number | ❌ No | `1.0` | Amount of randomness injected into the response. Ranges from 0.0 to 1.0 |
| `top_p` | number | ❌ No | `1.0` | Use nucleus sampling. Ranges from 0.0 to 1.0 |
| `max_tokens` | integer | ❌ No | - | The maximum number of tokens to generate before stopping |
| `stop` | array | ❌ No | - | Custom text sequences that will cause the model to stop generating |

### Messages Array Structure

Each message object in the `messages` array should have the following structure:

| Field | Type | Required | Description |
| - | - | - | - |
| `role` | string | ✅ Yes | The role of the message. Can be: `user`, `assistant`, or `system` |
| `content` | array/string | ✅ Yes | The content of the message |

### Content Array Structure (when content is an array)

| Field | Type | Required | Example | Description |
| - | - | - | - | - |
| `type` | string | ✅ Yes | `text` | The type of content |
| `text` | string | ✅ Yes | `"What's the weather in NYC?"` | The text content when type is `text` |

### Tools Array Structure

For web search functionality, the `tools` array should contain a web search tool object:

| Field | Type | Required | Example | Description |
| - | - | - | - | - |
| `type` | string | ✅ Yes | `web_search` | The type of tool. Must be `web_search` for web search |
| `max_uses` | integer | ❌ No | `5` | Maximum number of times the web search tool can be used in a single request |
| `allowed_domains` | array | ❌ No | `["example.com", "trusteddomain.org"]` | Only include search results from these domains |
| `blocked_domains` | array | ❌ No | `["untrustedsource.com"]` | Never include search results from these domains |

#### Max Uses

The `max_uses` parameter limits the number of searches performed. If Claude attempts more searches than allowed, the web search result will be an error with the `max_uses_exceeded` error code.

#### Domain Filtering

When using domain filters:

* Domains should not include the HTTP/HTTPS scheme (use `example.com` instead of `https://example.com`)
* Subdomains are automatically included (`example.com` covers `docs.example.com`)
* Specific subdomains restrict results to only that subdomain (`docs.example.com` returns only results from that subdomain, not from `example.com` or `api.example.com`)
* Subpaths are supported (`example.com/blog`)
* You can use either `allowed_domains` or `blocked_domains`, but not both in the same request

#### Complete Tool Configuration Example

```json theme={null}
{
  "type": "web_search_20250305",
      "name": "web_search",
  "max_uses": 5,
  "allowed_domains": ["example.com", "trusteddomain.org"]
}
```

## Error Codes

### Common Error Codes

| Error Code | Error Name | Description |
| - | - | - |
| 401 | Unauthorized | API key is missing or invalid |
| 403 | Forbidden | Your API key doesn't have permission to access this resource, or insufficient balance for the requested operation |
| 429 | Too Many Requests | You've exceeded your rate limit |
| 500 | Internal server error | An internal server error occurred |
| 503 | Content policy violation | Content blocked due to safety concerns (actual status code is 400) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.