---
title: visityour.biz Developer Documentation & API Portal
description: Complete developer guides, OpenAPI 3.0 specifications, MCP server references, and SDK documentation for integrating with visityour.biz.
canonical: https://visityour.biz/developers.md
last-updated: 2026-08-30
---

# visityour.biz Developer Documentation & API Portal

Welcome to the **visityour.biz** Developer Documentation and API Portal. This guide provides comprehensive references for software engineers and autonomous AI agents integrating with our directory.

## Core Developer Resources
- **OpenAPI 3.0 Specification**: [`/openapi.json`](https://visityour.biz/openapi.json)
- **API Catalog (RFC 9727)**: [`/.well-known/api-catalog`](https://visityour.biz/.well-known/api-catalog)
- **Agent Authentication Guide**: [`/auth.md`](https://visityour.biz/auth.md)
- **Pricing & Free Tier Guide**: [`/pricing.md`](https://visityour.biz/pricing.md)
- **Agent Navigation Index**: [`/llms.txt`](https://visityour.biz/llms.txt)
- **API Specific LLMs Index**: [`/api/llms.txt`](https://visityour.biz/api/llms.txt)

## Agent Configurations & Manifests
- **Agent Plugins Manifest**: [`/plugin.json`](https://visityour.biz/plugin.json)
- **Agent Rules & Context**: [`AGENTS.md`](https://github.com/visityourbiz/visityour-biz/blob/main/AGENTS.md)
- **Skills Definition**: [`/SKILL.md`](https://visityour.biz/SKILL.md)

## REST API Overview
- **Base URL**: `https://visityour.biz/api/v1`
- **Sandbox URL**: `https://sandbox.visityour.biz/api/v1`
- **Authentication**: Bearer token via `Authorization` header
- **Versioning Policy**: URL prefix `/v1` with standard `Sunset` and `Deprecation` response headers

### Key Endpoints
1. `GET /api/v1/businesses` - List businesses with cursor pagination (`cursor`, `limit`).
2. `GET /api/v1/businesses/{id}` - Retrieve detailed business listing.
3. `POST /api/v1/businesses` - Create listing (supports `Idempotency-Key` header).
4. `POST /api/v1/batch` - Execute bulk requests in a single round-trip.
5. `POST /api/v1/businesses/bulk-export` - Trigger async export job (returns 202 Accepted).
6. `GET /api/v1/jobs/{job_id}` - Poll status of an async job.

## Model Context Protocol (MCP) Integration
Connect directly to our MCP servers:
- **Product Server**: `https://visityour.biz/mcp` (Server Card: `/.well-known/mcp/server-card.json`)
- **Documentation Server**: `https://visityour.biz/docs/mcp` (Server Card: `/.well-known/mcp/docs-server-card.json`)
- **SSE Stream**: `https://visityour.biz/api/mcp/sse`

## Official SDKs & CLI
- **NPM Package**: `@visityourbiz/sdk`
- **PyPI Package**: `visityourbiz`
- **CLI Tool**: `npx @visityourbiz/sdk` or `npm install -g visityour-biz`
- **GitHub Repository**: [`https://github.com/visityourbiz/visityour-biz`](https://github.com/visityourbiz/visityour-biz)