openapi: 3.2.0 info: title: CONNSKILL Growth Services Directory API version: 3.0.0 description: 'Search research for AI agents: Local Market Check packages, domain ranking snapshots and keyword demand data.' termsOfService: https://agent.connskill.com/pricing contact: email: info@connskill.com x-logo: url: https://agent.connskill.com/icon.png altText: CONNSKILL logo: https://agent.connskill.com/icon.png icon: https://agent.connskill.com/icon.png x-guidance: Read the free discovery, input and quote routes first. Paid operations return an x402 challenge carrying the exact amount, asset, network and recipient. Prices can vary with selected tier, inputs or usage; use the actual challenge before approving payment. Support is free and uses a separate wallet ownership signature. Preserve the original request and payment proof for redelivery; never pay again for an unresolved purchase. x-trust: operator: CONNSKILL GmbH & Co. KG jurisdiction: Germany (EU) contact: info@connskill.com auth: No account or API key. Manual first purchases and private redelivery require a free Sign-In-With-X wallet proof from POST /v1/payments/challenge. payment: x402 v2, USDC on Base (eip155:8453), pay-per-call to 0x43B85AE58f0A2505c710Bc715d6f3EB16b1f63dE idempotency: A fresh wallet proof bound to the exact original request and payment references can retrieve its retained private result without another payment. redelivery: Private redelivery only reads a retained result. A missing result or uncertain purchase remains held for wallet support; it never starts another provider order. refund: On-chain settlement is technically final. This does not exclude statutory claims. Invalid input is rejected before settlement; failed delivery must be resolved through the delivery policy and support. unclearState: If a purchase times out and we cannot tell whether the provider charged us, you get HTTP 504 with stateUnclear — so you never blindly re-order. timeouts: No uptime SLA. Every outbound call has a timeout (provider 20s, DataForSEO 45s, purchase 60s); the gateway hard-caps at 90s and returns 504 rather than hanging. rateLimit: Paid service calls have no per-caller rate limit. Wallet challenges have bounded capacity and can return 429. Request size limits apply. We never log your IP; only technical metadata such as User-Agent and Referer. discovery: https://agent.connskill.com/openapi.json · https://agent.connskill.com/.well-known/x402 · https://agent.connskill.com/llms.txt · https://agent.connskill.com/pricing tags: - name: Directory paths: /v1/directory: get: operationId: directoryBoard summary: Curated DE/EU marketplace of external x402 services — the approved listings… tags: - Directory security: [] responses: '200': description: Approved partner listings, plus how to submit your own /v1/directory-submit: post: operationId: directorySubmit summary: Submit your x402 endpoint for listing in the curated directory (free) tags: - Directory security: [] requestBody: required: true content: application/json: schema: type: object required: - url - description properties: url: type: string description: Public https URL of your paid x402 endpoint — an unpaid request must answer HTTP 402 description: type: string maxLength: 500 description: What your endpoint delivers category: type: string maxLength: 50 description: e.g. seo, sms, llm, data price: type: string maxLength: 40 description: Price hint shown on the listing, e.g. "0.10" contact: type: string maxLength: 160 description: Optional — never shown publicly responses: '200': description: Stored as pending (human review). Keep the returned id — you need it for /v1/directory-status and /v1/directory-activate. /v1/directory-status: get: operationId: directoryStatus summary: Check the review status of a directory submission by id (free) tags: - Directory security: [] parameters: - name: id in: query required: true schema: type: string description: The id returned by directory-submit responses: '200': description: pending (in review), accepted (pay the listing fee to go live), approved (live) or rejected /v1/directory-activate: post: operationId: directoryActivate summary: Activate an accepted directory listing — one-time x402 listing fee, then your… tags: - Directory x-payment-info: price: mode: fixed currency: USD amount: '3.000000' protocols: - x402: {} requestBody: required: true content: application/json: schema: type: object required: - id properties: id: type: string description: Submission id returned by /v1/directory-submit; must be in status "accepted" (human review passed) — check GET /v1/directory-status?id=… responses: '200': description: Listing activated — live in /directory and /v1/directory content: application/json: schema: type: object properties: status: type: string id: type: string liveAt: type: string example: status: activated id: m1abc2def3gh liveAt: https://agent.connskill.com/directory '402': description: Payment Required components: securitySchemes: signInWithX: type: apiKey in: header name: Sign-In-With-X description: Base64 JSON containing the exact challenge fields, checksummed address, chainId eip155:8453, type eip191 and EIP-191 signature. Free authentication, not payment. One use, five minutes, bound to method, path and JSON body. x-discovery: ownershipProofs: - '0x4b92ee6ef3357beddfb6b0d39fbe8be660a934bde8a226539a16a0ea414768394cdc20d14f025c6bf5a630e99eafe177a742d81b4c16d2933cd1c2f85e708cbb1b' support: title: Wallet support url: /v1/support/policy authentication: sign-in-with-x network: eip155:8453 paid: false description: Free, private support for settled purchases. A short-lived wallet signature proves ownership; never pay again merely to open a case. endpoints: - url: /v1/support/policy method: GET - url: /v1/support/challenge method: POST - url: /v1/support/tickets method: GET - url: /v1/support/tickets method: POST - url: /v1/support/tickets/{ticketId} method: GET - url: /v1/support/tickets/{ticketId}/checkout method: POST - url: /v1/support/tickets/{ticketId}/discount method: POST serviceSearch: endpoint: /v1/service-search method: GET requiresPayment: false querySentToSources: false exhaustiveMarket: false sources: - connskill-directory - cdp-bazaar description: Free local search of bounded cached catalogues. Source coverage, age and failures are explicit; unknown units are not price-ranked. x-support: title: Wallet support url: /v1/support/policy authentication: sign-in-with-x network: eip155:8453 paid: false description: Free, private support for settled purchases. A short-lived wallet signature proves ownership; never pay again merely to open a case. endpoints: - url: /v1/support/policy method: GET - url: /v1/support/challenge method: POST - url: /v1/support/tickets method: GET - url: /v1/support/tickets method: POST - url: /v1/support/tickets/{ticketId} method: GET - url: /v1/support/tickets/{ticketId}/checkout method: POST - url: /v1/support/tickets/{ticketId}/discount method: POST