# Go2Web API

> Go2Web (https://go2w.co) is a URL shortener. The Go2Web API is a JSON REST API over HTTPS for creating and managing short links, reading click stats, setting targeting rules and managing projects / custom domains. The Docs links below are the English API reference, generated from the same source as the API Docs at https://go2w.co/docs/api (human docs, in Thai).

- Base URL: `https://api.go2w.co` — every endpoint is under `/api/v1/…` (version 1; changes within it are additive only)
- Authentication: header `Authorization: Bearer glk_…` or `X-API-Key: glk_…` — create an API key at https://go2w.co/developers/keys
- MCP server: `https://api.go2w.co/api/v1/mcp` (Streamable HTTP, same API key) — tools `create_link`, `list_links`, `get_link`, `update_link`, `delete_link`, `get_link_stats`, `list_projects`, `create_project`, `list_domains` · setup in the "MCP server" section of the full reference
- Requires the Starter plan or higher · rate limit per account: 60 requests/minute on Starter, 300 requests/minute on Pro, 1,200 requests/minute on Business, 3,000 requests/minute on Enterprise (headers `X-RateLimit-Limit` / `-Remaining` / `-Reset`; over the limit: `429` + `Retry-After`)
- Requests / responses are JSON · every error is `{"error": "message", "code": "stable_code"}` — branch on `code`, show / log `error`

## Docs

- [Full API reference](https://go2w.co/llms-full.txt): every endpoint (31 endpoints) with parameters, request body, cURL example, response and errors in a single Markdown file
- [API reference (.md)](https://go2w.co/docs/api.md): the same content as llms-full.txt, as a .md file paired with the /docs/api page

## Tools

- [OpenAPI 3.1 spec](https://go2w.co/openapi.json): machine-readable spec of every endpoint — request / response schemas with examples, the error schema with every `code`, rate-limit headers (import into Postman / Insomnia, or feed to a code generator)
- [Postman collection](https://go2w.co/go2web-api.postman_collection.json): Postman Collection v2.1 covering every endpoint, with example responses and test scripts (Import → Link; descriptions in Thai)
- [Postman environment](https://go2w.co/go2web.postman_environment.json): "Go2Web" environment with `base_url` and `api_key` variables (fill in your own API key)
- [API Docs](https://go2w.co/docs/api): human-readable docs in Thai, with code examples in cURL, Go, Python, PHP, Node.js, JavaScript (requires JavaScript)

## Optional

- [API Keys](https://go2w.co/developers/keys): create / revoke API keys (sign-in required)
- [Go2Web](https://go2w.co): Go2Web home page