# Unif API developer resources

UnifAPI developer resources for agents and builders: API docs, OpenAPI, auth.md, OAuth metadata, MCP server, registry manifest, and Skill source.

Unif API (UnifAPI) gives AI agents public-data Skills, an MCP server, and live public-data APIs for KOL pricing, creator research, social listening, and competitive intelligence.

## Predictable URLs

- [API docs](https://docs.unifapi.com) - Human-readable API guides, auth docs, rate limits, and generated endpoint pages.
- [OpenAPI spec](https://unifapi.com/openapi.json) - Public OpenAPI 3.1 contract generated from UnifAPI route metadata.
- [API base URL](https://api.unifapi.com) - Production HTTP API host for direct public-data calls.
- [MCP server](https://unifapi.com/mcp) - Hosted Streamable HTTP MCP server setup. Connector URL: https://mcp.unifapi.com.
- [NLWeb ask endpoint](https://unifapi.com/ask) - POST natural-language queries with NLWeb-style _meta/results JSON, or request SSE with prefer.streaming.
- [Streaming support](https://unifapi.com/streaming) - MCP Streamable HTTP, /ask SSE events, and direct REST JSON behavior.
- [Versioning and deprecation](https://unifapi.com/versioning.md) - Agent-readable REST API lifecycle, deprecation, and path-guessing policy.
- [Agent development and sandbox guidance](https://unifapi.com/sandbox.md) - Safe test paths, no-login demos, trial-credit guidance, and sandbox boundary.
- [auth.md](https://unifapi.com/auth.md) - Agent-readable credential handling guide for MCP OAuth and API-key fallback.
- [HTTP Message Signatures directory](https://unifapi.com/.well-known/http-message-signatures-directory) - Current machine-readable policy: not supported; use OAuth or API-key bearer auth.
- [OAuth protected resource metadata](https://mcp.unifapi.com/.well-known/oauth-protected-resource) - OAuth resource metadata for MCP clients.
- [MCP registry manifest](https://unifapi.com/server.json) - Name, icon, description, repository, and hosted remote for MCP registries.
- [MCP.so registry listing](https://mcp.so/zh/server/unifapi-%7C-give-your-agent-live-public-data/unifapi-agent) - Third-party MCP directory listing for UnifAPI with a backlink to unifapi.com.
- [Agent Skills index](https://unifapi.com/.well-known/agent-skills/index.json) - Discovery index for open-source UnifAPI Skill artifacts.
- [Open-source Skills](https://github.com/unifapi-agent/skills) - Public Skill source for Codex, Claude Code, and other agent environments.
- [TypeScript SDK package](https://unifapi.com/developers#typescript-sdk) - `@unifapi/sdk` npm package for direct HTTP integrations.
- [Create API key](https://api.unifapi.com/sign-in) - Sign in and create a workspace API key for direct HTTP access.

## Direct HTTP quick start

```http
GET /x/tweets/search/recent?q=unifapi HTTP/1.1
Host: api.unifapi.com
Authorization: Bearer $UNIFAPI_API_KEY
Accept: application/json
```

## MCP quick start

```txt
Connector URL: https://mcp.unifapi.com
OAuth scope: unifapi:mcp
Tools: list_operations, get_operation, call_api
```

## NLWeb ask quick start

```http
POST /ask HTTP/1.1
Host: unifapi.com
Content-Type: application/json

{"query":{"text":"Where is the UnifAPI OpenAPI spec?"}}
```

`/ask` returns `_meta.response_type`, `_meta.version`, and a `results` array. Set `prefer.streaming` to `true` or send `Accept: text/event-stream` to receive `start`, `result`, and `complete` SSE events.

## Streaming support

Streaming support is documented at https://unifapi.com/streaming and https://unifapi.com/streaming.md. Use Streamable HTTP MCP for agent-held tool sessions, /ask SSE for progressive discovery answers, and direct REST JSON for one-envelope product integrations.

## Versioning and sandbox policy

Versioning policy is documented at https://unifapi.com/versioning.md. Do not invent /v1 or /api/v1 prefixes unless they appear in the current OpenAPI document.

Sandbox guidance is documented at https://unifapi.com/sandbox.md. UnifAPI does not publish a separate fake-data sandbox origin today; use no-login demos, /ask, MCP operation inspection, and low-volume trial-credit validation.

## TypeScript SDK

`@unifapi/sdk` is the npm package for direct HTTP integration. Use it when the workflow is moving from an agent thread into product code, scheduled monitoring, or a backend integration.

```bash
pnpm add @unifapi/sdk
```

## Support

Contact support@unifapi.com for API, OpenAPI, MCP, OAuth, or registry questions.