DEVELOPER DOCUMENTATION
One normalized contract.
Inspect the executable catalog, choose the smallest matching service, and call it with a private B2B key or an x402-capable client. Generated machine documentation is available in OpenAPI, llms.txt, and the agent guide.
B2B synchronous request
Authorization: Bearer rs_live_keyid_secret
Idempotency-Key: your-unique-request-key
Content-Type: application/json
POST /v1/services/instagram.profile/execute
{"input":{"url":"https://www.instagram.com/example/"}}Responses use schema version 1.0, normalization version v1, and never expose provider-specific payloads.
Asynchronous services
Submit long-running work to POST /v1/services/{service_id}/jobs. Anonymous callers receive a one-time job_token and poll GET /v1/jobs/{job_id} with X-Job-Token. Results expire after 24 hours.
Do not repeat a paid job submission while work is pending. Poll the returned status URL until a terminal state.
Error discipline
Errors contain a stable code, safe message, retryable flag, and request ID. Invalid input, unavailable private content, and not-found results are terminal.
{"error":{"code":"not_found",
"message":"The resource was not found.",
"retryable":false,
"request_id":"req_..."}}x402 public REST
Public available services return 402 Payment Required with a PAYMENT-REQUIRED header. An x402-compatible buyer verifies the exact amount, receiver, network, asset, and resource, signs the requirement, and retries once with PAYMENT-SIGNATURE. Base Sepolia is the current public test network; B2B Bearer calls bypass x402.
If an accepted paid job later fails because ReachSocial or its provider is unavailable, claim one replacement credit at POST /v1/jobs/{job_id}/credit. Present it once as X-Service-Credit for the same service. Never send a B2B API key or wallet private key to a browser or service input.