apione-store API

openapi: 3.1.0
info:
  title: apione-store API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 16 operation(s) read from 35 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; apione-store has published no machine-readable contract
    that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 16
    documentation: 0
    pages-with-code: 33
    pages-read: 35
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-30'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://apione.store/endpoints/email-finder
  - https://apione.store/endpoints/people-search
  - https://apione.store/endpoints/company-search
  - https://apione.store/endpoints/hiring-signals
  - https://apione.store/endpoints/business-signals
  - https://apione.store/endpoints/people-enrichment
  - https://apione.store/endpoints/company-enrichment
  - https://apione.store/endpoints/email-verification
  - https://apione.store/endpoints/tech-stack-detection
  - https://apione.store/endpoints/company-name-normalization
  - https://apione.store/endpoints/arabic-english-name-matching
  - https://apione.store/docs/api-reference
  - https://apione.store/docs
  - https://apione.store/docs/quickstart
  - https://apione.store
  - https://api.apione.store
  - https://apione.store/docs/mcp
  - https://apione.store/docs/crm-enrichment
  - https://apione.store/docs/signal-watch
  - https://apione.store/docs/authentication
  - https://apione.store/docs/curl-examples
  - https://apione.store/docs/enrich-from-domain
  - https://apione.store/docs/gtm-workflow
  - https://apione.store/docs/async-webhooks
  - https://api.apione.store/docs
  - https://api.apione.store/docs/mcp
  - https://api.apione.store/docs/crm-enrichment
  - https://api.apione.store/docs/signal-watch
  - https://api.apione.store/docs/authentication
  - https://api.apione.store/docs/quickstart
  - https://api.apione.store/docs/api-reference
  - https://api.apione.store/docs/curl-examples
  - https://api.apione.store/docs/enrich-from-domain
  - https://api.apione.store/docs/gtm-workflow
  - https://api.apione.store/docs/async-webhooks
paths:
  /api/v1/companies/enrich:
    post:
      operationId: post_api_v1_companies_enrich
      tags:
      - Api
      summary: POST /api/v1/companies/enrich
      x-source: https://apione.store/endpoints/company-enrichment
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1CompaniesEnrichRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.apione.store/api/v1/companies/enrich  -H \"X-API-Key: YOUR_KEY\" -H \"Content-Type: application/json\"\
          \  -d '{\"domain\":\"foodics.com\"}' \n Parameter Required Description domain yes Company website domain, for example foodics.com \n\
          \ Response \n Field Description name, description, industry, industry_vertical Who the company is business_model B2B, B2C, B2B2C or\
          \ Marketplace company_si"
  /api/v1/companies/hiring:
    post:
      operationId: post_api_v1_companies_hiring
      tags:
      - Api
      summary: POST /api/v1/companies/hiring
      x-source: https://apione.store/endpoints/hiring-signals
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1CompaniesHiringRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.apione.store/api/v1/companies/hiring  -H \"X-API-Key: YOUR_KEY\" -H \"Content-Type: application/json\"\
          \  -d '{\"domain\":\"tamara.co\"}' \n Parameter Required Description domain yes Company domain \n Response \n Field Description found,\
          \ open_roles Whether roles were found and how many by_department, by_location Counts, for example Riyadh 10, Dubai 9 roles[] title,\
          \ department, location"
  /api/v1/companies/match:
    post:
      operationId: post_api_v1_companies_match
      tags:
      - Api
      summary: POST /api/v1/companies/match
      x-source: https://apione.store/endpoints/arabic-english-name-matching
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1CompaniesMatchRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.apione.store/api/v1/companies/match  -H \"X-API-Key: YOUR_KEY\" -H \"Content-Type: application/json\"\
          \  -d '{\"name_a\":\"شركة قيود لتقنية المعلومات\",\"name_b\":\"Qoyod LLC\"}' \n Parameter Required Description name_a yes First name,\
          \ Arabic or English name_b yes Second name, Arabic or English \n Response \n Field Description score 0 to 1 verdict same, likely_same,\
          \ possible or different m"
  /api/v1/companies/normalize-name:
    post:
      operationId: post_api_v1_companies_normalize_name
      tags:
      - Api
      summary: POST /api/v1/companies/normalize-name
      x-source: https://apione.store/endpoints/company-name-normalization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1CompaniesNormalizeNameRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.apione.store/api/v1/companies/normalize-name  -H \"X-API-Key: YOUR_KEY\" -H \"Content-Type: application/json\"\
          \  -d '{\"name\":\"مؤسسة رواء للتجارة ذ.م.م\"}' \n Parameter Required Description name yes Company name, Arabic or English \n Response\
          \ \n Field Description script arabic, latin or mixed core_name, legal_forms_removed Normalised name match_key Use it to group duplicates\
          \ variant"
  /api/v1/companies/search:
    post:
      operationId: post_api_v1_companies_search
      tags:
      - Api
      summary: POST /api/v1/companies/search
      x-source: https://apione.store/endpoints/company-search
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1CompaniesSearchRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.apione.store/api/v1/companies/search  -H \"X-API-Key: YOUR_KEY\" -H \"Content-Type: application/json\"\
          \  -d '{\"country\":\"SA\",\"keyword\":\"accounting software\",\"count\":10}' \n Parameter Required Description country no ISO-2 code\
          \ (SA, AE, QA, KW, BH, OM, EG...) or a list city no City name, for example Riyadh industry no Industry text keyword no Free-text keyword\
          \ employee_range no 1-"
  /api/v1/emails/find:
    post:
      operationId: post_api_v1_emails_find
      tags:
      - Api
      summary: POST /api/v1/emails/find
      x-source: https://apione.store/endpoints/email-finder
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1EmailsFindRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.apione.store/api/v1/emails/find  -H \"X-API-Key: YOUR_KEY\" -H \"Content-Type: application/json\" \
          \ -d '{\"first_name\":\"Jane\",\"last_name\":\"Doe\",\"domain\":\"example.com\"}' \n Parameter Required Description first_name yes First\
          \ name (or full_name) last_name yes Last name (or full_name) domain yes Company domain \n Response \n Field Description email Work email\
          \ or null verified, deliver"
  /api/v1/emails/verify:
    post:
      operationId: post_api_v1_emails_verify
      tags:
      - Api
      summary: POST /api/v1/emails/verify
      x-source: https://apione.store/endpoints/email-verification
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1EmailsVerifyRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.apione.store/api/v1/emails/verify  -H \"X-API-Key: YOUR_KEY\" -H \"Content-Type: application/json\"\
          \  -d '{\"email\":\"jane@example.com\"}' \n Parameter Required Description email yes Address to verify \n Response \n Field Description\
          \ syntax_valid, is_deliverable, reachability Deliverability is_catch_all, mailbox_exists Mailbox checks is_role_address, is_disposable,\
          \ is_free_provider A"
  /api/v1/people/enrich:
    post:
      operationId: post_api_v1_people_enrich
      tags:
      - Api
      summary: POST /api/v1/people/enrich
      x-source: https://apione.store/endpoints/people-enrichment
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1PeopleEnrichRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.apione.store/api/v1/people/enrich  -H \"X-API-Key: YOUR_KEY\" -H \"Content-Type: application/json\"\
          \  -d '{\"name\":\"Jane Doe\",\"domain\":\"example.com\"}' \n Parameter Required Description name yes Full name domain no Company domain\
          \ company no Company name, when no domain \n Response \n Field Description found Whether a matching person was found title, seniority,\
          \ department, career_sta"
  /api/v1/people/search:
    post:
      operationId: post_api_v1_people_search
      tags:
      - Api
      summary: POST /api/v1/people/search
      x-source: https://apione.store/endpoints/people-search
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1PeopleSearchRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.apione.store/api/v1/people/search  -H \"X-API-Key: YOUR_KEY\" -H \"Content-Type: application/json\"\
          \  -d '{\"company\":\"Foodics\",\"title\":\"Head of Sales\",\"count\":5}' \n Parameter Required Description company no Current company\
          \ name title no Current title text country no ISO-2 code location no Location text keyword no Free-text keyword count no 1 to 25, default\
          \ 10 \n Response \n Field"
  /api/v1/signals:
    post:
      operationId: post_api_v1_signals
      tags:
      - Api
      summary: POST /api/v1/signals
      x-source: https://apione.store/endpoints/business-signals
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1SignalsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.apione.store/api/v1/signals  -H \"X-API-Key: YOUR_KEY\" -H \"Content-Type: application/json\"  -d '{\"\
          domain\":\"lean.sa\"}' \n Parameter Required Description domain no Company domain content no Or a text to analyse instead of a domain\
          \ \n Response \n Field Description entity Company analysed signals[] type, title, description, strength, confidence, detected_at, source_hint\
          \ overall_in"
  /api/v1/tech/detect:
    post:
      operationId: post_api_v1_tech_detect
      tags:
      - Api
      summary: POST /api/v1/tech/detect
      x-source: https://apione.store/endpoints/tech-stack-detection
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1TechDetectRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.apione.store/api/v1/tech/detect  -H \"X-API-Key: YOUR_KEY\" -H \"Content-Type: application/json\" \
          \ -d '{\"domain\":\"tamara.co\"}' \n Parameter Required Description domain yes Company domain \n Response \n Field Description technologies[]\
          \ name, category, confidence, evidence fetched, final_url What was actually read detection_confidence Overall confidence \n Cost \n\
          \ 4 credits. Free whe"
  /api/v1/watch:
    post:
      operationId: post_api_v1_watch
      tags:
      - Api
      summary: POST /api/v1/watch
      x-source: https://apione.store/docs/api-reference
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1WatchRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://apione.store/api/v1/watch  -H \"X-API-Key: ak_live_YOUR_KEY\"  -H \"Content-Type: application/json\"  -d\
          \ '{\n \"entity_type\": \"company\",\n \"entity_domain\": \"stripe.com\",\n \"signal_types\": [\"hiring_surge\", \"funding_event\",\
          \ \"tech_stack_change\"],\n \"webhook_url\": \"https://your.app/signals\",\n \"check_frequency\": \"daily\",\n \"label\": \"Stripe —\
          \ target account\"\n }'\njson\nCopy\n{\n \"id\": 42,\n \"webho"
  /v1/company:
    post:
      operationId: post_v1_company
      tags:
      - Company
      summary: POST /v1/company
      x-source: https://apione.store/docs/api-reference
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1CompanyRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1CompanyResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.apione.store/v1/company  -H \"Authorization: Bearer YOUR_API_KEY\"  -H \"Content-Type: application/json\"\
          \  -d '{\"domain\": \"stripe.com\"}'\n3. Parse the response\njson\nCopy\n{\n \"name\": \"Stripe\",\n \"domain\": \"stripe.com\",\n \"\
          confidence\": \"94%\",\n \"industry\": \"Financial Technology\",\n \"business_model\": \"B2B SaaS + Payments\",\n \"company_size\":\
          \ \"5,001–10,000\",\n \"headquarters\": \"San Francisc"
  /v1/email/find:
    post:
      operationId: post_v1_email_find
      tags:
      - Email
      summary: POST /v1/email/find
      x-source: https://apione.store/docs/api-reference
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1EmailFindRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1EmailFindResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.apione.store/v1/email/find  -H \"Authorization: Bearer YOUR_API_KEY\"  -H \"Content-Type: application/json\"\
          \  -d '{\"first_name\": \"David\", \"last_name\": \"Chen\", \"domain\": \"stripe.com\"}'\nResponse\njson\nCopy\n{\n \"candidates\":\
          \ [\n {\"email\": \"david.chen@stripe.com\", \"confidence\": 89},\n {\"email\": \"d.chen@stripe.com\", \"confidence\": 71},\n {\"email\"\
          : \"davidchen@stripe.com\", \"confidence\": 43"
  /v1/email/verify:
    post:
      operationId: post_v1_email_verify
      tags:
      - Email
      summary: POST /v1/email/verify
      x-source: https://apione.store/docs/api-reference
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1EmailVerifyRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1EmailVerifyResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.apione.store/v1/email/verify  -H \"Authorization: Bearer YOUR_API_KEY\"  -H \"Content-Type: application/json\"\
          \  -d '{\"email\": \"david.chen@stripe.com\"}'\nResponse\njson\nCopy\n{\n \"status\": \"deliverable\",\n \"mx_valid\": true,\n \"mailbox_exists\"\
          : true,\n \"is_role_address\": false,\n \"is_disposable\": false,\n \"is_catch_all\": false,\n \"recommended_action\": \"send\"\n}\n\
          People Enrichment\nEnrich a p"
  /v1/people:
    post:
      operationId: post_v1_people
      tags:
      - People
      summary: POST /v1/people
      x-source: https://apione.store/docs/api-reference
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1PeopleRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1PeopleResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.apione.store/v1/people  -H \"Authorization: Bearer YOUR_API_KEY\"  -H \"Content-Type: application/json\"\
          \  -d '{\"name\": \"Sarah Kim\", \"domain\": \"notion.so\"}'\nResponse\njson\nCopy\n{\n \"title\": \"Director of Product\",\n \"seniority\"\
          : \"Director\",\n \"department\": \"Product\",\n \"career_stage\": \"Mid-senior\",\n \"years_experience\": \"8 years\",\n \"manages_team\"\
          : true,\n \"skills\": [\"Product strategy\","
components:
  schemas:
    PostApiV1CompaniesEnrichRequest:
      type: object
      properties:
        domain:
          type: string
    PostApiV1CompaniesHiringRequest:
      type: object
      properties:
        domain:
          type: string
    PostApiV1CompaniesMatchRequest:
      type: object
      properties:
        name_a:
          type: string
        name_b:
          type: string
    PostApiV1CompaniesNormalizeNameRequest:
      type: object
      properties:
        name:
          type: string
    PostApiV1CompaniesSearchRequest:
      type: object
      properties:
        country:
          type: string
        keyword:
          type: string
        count:
          type: integer
    PostApiV1EmailsFindRequest:
      type: object
      properties:
        first_name:
          type: string
        last_name:
          type: string
        domain:
          type: string
    PostApiV1EmailsVerifyRequest:
      type: object
      properties:
        email:
          type: string
    PostApiV1PeopleEnrichRequest:
      type: object
      properties:
        name:
          type: string
        domain:
          type: string
    PostApiV1PeopleSearchRequest:
      type: object
      properties:
        company:
          type: string
        title:
          type: string
        count:
          type: integer
    PostApiV1SignalsRequest:
      type: object
      properties:
        domain:
          type: string
    PostApiV1TechDetectRequest:
      type: object
      properties:
        domain:
          type: string
    PostApiV1WatchRequest:
      type: object
      properties:
        entity_type:
          type: string
        entity_domain:
          type: string
        signal_types:
          type: array
          items:
            type: string
        webhook_url:
          type: string
        check_frequency:
          type: string
        label:
          type: string
    PostV1CompanyRequest:
      type: object
      properties:
        domain:
          type: string
    PostV1CompanyResponse:
      type: object
      properties:
        name:
          type: string
        domain:
          type: string
        confidence:
          type: string
        industry:
          type: string
        business_model:
          type: string
        company_size:
          type: string
        headquarters:
          type: string
        tech_stack:
          type: array
          items:
            type: string
        growth_signals:
          type: array
          items:
            type: string
    PostV1EmailFindRequest:
      type: object
      properties:
        first_name:
          type: string
        last_name:
          type: string
        domain:
          type: string
    PostV1EmailFindResponse:
      type: object
      properties:
        candidates:
          type: array
          items:
            type: object
            properties:
              email:
                type: string
              confidence:
                type: integer
    PostV1EmailVerifyRequest:
      type: object
      properties:
        email:
          type: string
    PostV1EmailVerifyResponse:
      type: object
      properties:
        status:
          type: string
        mx_valid:
          type: boolean
        mailbox_exists:
          type: boolean
        is_role_address:
          type: boolean
        is_disposable:
          type: boolean
        is_catch_all:
          type: boolean
        recommended_action:
          type: string
    PostV1PeopleRequest:
      type: object
      properties:
        name:
          type: string
        domain:
          type: string
    PostV1PeopleResponse:
      type: object
      properties:
        title:
          type: string
        seniority:
          type: string
        department:
          type: string
        career_stage:
          type: string
        years_experience:
          type: string
        manages_team:
          type: boolean
        skills:
          type: array
          items:
            type: string
        confidence:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Company
- name: Email
- name: People