Xiaoman (OKKI)

OKKI Go Contacts API

The Contacts API from OKKI Go (go.okki.ai) — 1 retired operation (POST /api/v1/contacts/search returns 410 Gone; use company unlock + profileEmails).

GitHub OpenAPI

Documentation

📖
Documentation
https://go.okki.ai
📖
APIReference
https://github.com/okki-op/okki-go/blob/main/skill/references/api-reference.md
📖
GettingStarted
https://github.com/okki-op/okki-go#quick-start

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/xiaoman/refs/heads/main/openapi/xiaoman-contacts-api-openapi.yml

Other Resources

🔗
SourceCode
https://github.com/okki-op/okki-go
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/xiaoman/refs/heads/main/llms/xiaoman-okki-go-llms.txt

OpenAPI Specification

xiaoman-contacts-api-openapi.yml Raw ↑ 
openapi: 3.0.3
info:
  title: OKKI Go Contacts API
  description: OKKI Go is a B2B prospecting engine for AI agents and sales teams from Xiaoman (小满科技, an Alibaba company). Search global B2B companies, unlock company profiles and decision-maker contact emails, send batch or personalized cold outreach email (EDM), and track delivery — designed to be driven from AI agents via the provider-published OKKI Go Agent Skill. This OpenAPI was generated by API Evangelist from the provider's published API reference shipped inside the @okki-global/okki-go npm package (skill/references/api-reference.md, v1.3.4); endpoint paths, parameters, billing notes, and error semantics are taken verbatim from that document. Errors use RFC 7807 Problem Details. All authenticated endpoints share a 60 requests/minute rate limit.
  version: 1.0.0
  x-generated: '2026-07-21'
  x-method: generated
  x-source: npm @okki-global/okki-go 1.3.4 skill/references/api-reference.md
servers:
- url: https://go.okki.ai
  description: OKKI Go production
tags:
- name: Contacts
paths:
  /api/v1/contacts/search:
    post:
      operationId: searchContacts
      tags:
      - Contacts
      summary: Contact search (retired)
      deprecated: true
      description: 'Retired: returns 410 Gone with code contact_search_retired. Use /companies/unlock then /companies/{companyHashId}/profileEmails instead.'
      security:
      - apiKey: []
      responses:
        '410':
          description: Gone — endpoint retired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
components:
  schemas:
    Problem:
      type: object
      description: RFC 7807 Problem Details error envelope.
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
        detail:
          type: string
        instance:
          type: string
        code:
          type: string
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization
      description: 'Authorization: ApiKey sk-your-key-here — API keys issued at https://go.okki.ai after registration.'