# PoachSearch

> Localized brand-ad observations for verified business accounts.

- Developer guide: https://poachsearch.com/developers
- REST base: https://poachsearch.com/api/v1
- Remote MCP: https://poachsearch.com/mcp (Streamable HTTP, Bearer API key)
- Metadata: https://poachsearch.com/.well-known/mcp/server.json
- Get a key: POST /api/v1/keys with {"email":"owner@example.com"}; verify the inbox link. The key is shown once.
- Auth: Authorization: Bearer ps_live_...; never put keys in URLs.
- Pricing: USD 2 per 1,000 searches. First 100 once per verified email, shared with web. PayPal prepaid packs USD 10/25/100. Credits valid for 12 months.
- get_balance: free; includes a private buy_url for browser checkout. Do not publish this link.
- estimate_brand_check: free; brand, matching website, 1–5 countries, depth 12/24/48.
- start_brand_check: reserves countries × depth; business_confirm=true and terms=true required. Actual searches performed are charged; unused reservations are released.
- get_brand_check: free status/results by check id. Non-domain email requests require manual review.
- live_search: query + country; one successful observation costs 1 search, even with no ads. Failures release the credit.
- get_live_search: free status/results as structured data (screenshots are not available through the API yet).
- No automatic purchase via tools. Insufficient credit errors include a private buy_url for the account's existing PayPal checkout.
- Avoid duplicate starts after uncertain responses. Poll known IDs for progress. Respect HTTP 429 limits.
- MCP legacy protocol 2025-11-25: initialize, notifications/initialized, tools/list, tools/call. Send Accept: application/json, text/event-stream and MCP-Protocol-Version after initialization.
- Terms: https://poachsearch.com/check/web/terms.html
- Privacy: https://poachsearch.com/check/web/privacy.html