WebGo API

Your WebGo API Account

The public website stays open. Sign in only when you are ready to use your private account, API access and WebGo Credits.

Sign In

Email or Phone

Password

Create Your Account

All fields are required.

Full Name · required

Phone Number · required

Email · required

Password · minimum 8 characters

Verification: 1st option · 6-digit code sent to your phone. 2nd option · 6-digit code sent to your email.

Eligible plans include a monthly promotional bonus. The bonus is issued once at the start of each new monthly cycle. Additional purchases during the same active cycle add base credits only. Promotional credits are usage units, not dollars.

Customer Dashboard

Private account area

ACCOUNT

Active

Authenticated WebGo API customer

WEBGO CREDITS

—

Loading wallet…

ACTIVE API KEYS

—

Private keys are never shown again after creation

WebGo API Registration / API Key

Payment approval is required before your Registration / API Key is issued.

Recent Usage

Loading…

PLANS & BILLING

Activation Summary

Choose a plan from the Front Door to prepare activation.

Each monthly cycle lasts one month. The bonus is issued once at the start of a new monthly cycle. Additional purchases during the same cycle add base credits only and do not extend the cycle. Unused WebGo Credits expire when the cycle ends. Before checkout, review our Terms, Privacy Policy and Refund Policy.

No charge is created from this screen. Purchased credits and any promotional credits are credited only after a confirmed successful payment.

Billing and paid-credit purchases remain locked until the payment service is connected. Wallet, API-key management and usage history are now backed by Cloudflare D1.

WEBGO API CATALOG

Choose an API family

One WebGo account, one API-key system and one WebGo Credits wallet across the catalog. Availability is shown per family.

PLAYGROUND · SAFE PREVIEW

Business & Local

Build a request and preview the integration. Execution is not triggered from this playground yet.

State

Mateo LIVE

● Mateo LIVE · gpt-5.6

Ask Mateo about API integration, authentication, parameters, errors, cURL, Python, JavaScript or JSON. Mateo can explain and generate example code, but cannot change your account, credits, keys or production settings.

Sofía Guide: Welcome to your WebGo API Customer Center. I can present each section and answer questions about what you see.

Mateo: Estoy aquí para ayudarte con la integración de WebGo API. Puedes escribir o usar el micrófono.

Code examples are guidance only. Private API keys should never be pasted into chat.

DOCUMENTATION · PREPARING VERTICALS

Products & Commerce · Jobs, News & Trends

Integration contracts are available for planning. Execution remains disabled, and these examples do not start a search or charge WebGo Credits.

Products & Commerce PREPARING

POST /api/products-commerce-prepare Content-Type: application/json { "query": "wireless headphones", "quantity": 10 }

query / product	Required; up to 500 characters.
quantity	1–100; defaults to 10.
Access	Account, API key and WebGo Credits will be required for execution.
Credit cost	Pending measured-cost approval; not published yet.

400 · QUERY_OR_PRODUCT_REQUIRED

409 · PRODUCTS_COMMERCE_COMING_SOON · creditsCharged: 0

Jobs, News & Trends PREPARING

POST /api/jobs-news-trends-prepare Content-Type: application/json { "query": "software jobs Tampa", "quantity": 10 }

query	Required; up to 500 characters.
quantity	1–100; defaults to 10.
Access	Account, API key and WebGo Credits will be required for execution.
Credit cost	Pending measured-cost approval; not published yet.

400 · QUERY_REQUIRED

409 · JOBS_NEWS_TRENDS_COMING_SOON · creditsCharged: 0

Internal providers, routing and engine counts are intentionally excluded from customer-facing documentation.

DOCUMENTATION · PREPARING FAMILIES

Companies & Contacts · Search & Web

These contracts are documented for integration planning, but execution is not enabled here yet. No request from these examples starts a search or charges WebGo Credits.

Companies & Contacts PREPARING

POST /api/companies-contacts-prepare Content-Type: application/json { "query": "example company", "quantity": 10 }

query / company	Required; up to 500 characters.
quantity	1–500; defaults to 10.
Credit policy	Planned unit: delivered valid unique company/contact. Failed attempts and duplicates are not charged by this prepare contract.

400 · QUERY_OR_COMPANY_REQUIRED

400 · VALID_QUANTITY_REQUIRED

409 · COMPANIES_CONTACTS_NOT_READY

Search & Web PREPARING

POST /api/search-web-prepare Content-Type: application/json { "query": "example web search", "quantity": 10 }

query	Required; up to 500 characters.
quantity	1–100; defaults to 10.
Credit policy	Planned unit: delivered result. Failed attempts are not charged by this prepare contract.

400 · QUERY_REQUIRED

400 · VALID_QUANTITY_REQUIRED

409 · SEARCH_WEB_NOT_READY

Customer-facing documentation intentionally omits internal engine names, provider routes and engine counts.

DOCUMENTATION · BUSINESS & LOCAL

Business & Local Search STANDARD READY

Authenticated endpoint for requesting local business results. The API reserves up to the requested quantity in WebGo Credits before execution and settles only the number of results actually delivered.

Request

POST https://webgoapi.com/v1/business-local/search Authorization: Bearer YOUR_WEBGO_API_KEY Content-Type: application/json { "state": "FL", "category": "roofing contractors", "quantity": 10, "speed": "standard", "requestId": "optional-client-request-id" }

Response shape

{ "ok": true, "requestId": "...", "reservationId": "...", "family": "Business & Local", "speed": "standard", "requested": 10, "delivered": 10, "creditsCharged": 10, "wallet": { "...": "..." }, "elapsedSeconds": 0, "results": [ ... ] }

Parameters

Field	Required	Rule
state	Yes	Two-letter U.S. state code.
category	Yes	Business category; up to 160 characters.
quantity	Yes	Integer from 1 to 500.
speed	Yes	Currently `standard` for execution.
requestId	No	Client-supplied identifier up to 120 characters; generated automatically when omitted.

Credit behavior

The request reserves up to quantity credits before execution. Settlement uses the number actually delivered. If execution fails, the service attempts a zero-delivery settlement. If final credit settlement cannot be confirmed, results are withheld.

Common API errors

401 · INVALID_API_KEY

400 · CATEGORY_REQUIRED

400 · VALID_STATE_REQUIRED

400 · QUANTITY_1_TO_500_REQUIRED

409 · HIGH_SPEED_EXECUTION_NOT_READY · availableSpeed: standard

409 · BUSINESS_LOCAL_NOT_READY

502 · CREDIT_RESERVATION_FAILED / CREDIT_RESERVATION_INVALID

503 · BUSINESS_LOCAL_EXECUTION_FAILED · creditsCharged: 0

502 · CREDIT_SETTLEMENT_FAILED · resultsWithheld: true

BUSINESS & LOCAL · STANDARD SPEED

API Quick Start

Use your active WebGo API key as a Bearer token. The current Standard Speed request limit is 1–500 results per call.

POST https://webgoapi.com/v1/business-local/search

Request fields: state (2-letter code), category, quantity, speed="standard".
Credit rule: 1 WebGo Credit per valid unique result actually delivered. Failed attempts and duplicates are not charged.