Giggal.ai

Giggal.ai API

Giggal.ai API as documented publicly: 8 operations. Contract generated from the documentation by API Evangelist (2026-11-10); not the provider's own document.

GitHub OpenAPI

Operations 8

POST /v1/catchall Email verification API with Catch-All Resolution #
GET /v1/catchall/{taskid} Get catch-all task status #
GET /v1/catchall/{taskid}/download Download catch-all results as CSV #
GET /v1/catchall/{taskid}/results Get catch-all task results #
GET /v1/credits Get current credit balance #
GET /v1/jobs Email verification API with Catch-All Resolution #
POST /v1/verify POST /v1/verify #
POST /v1/verify-batch POST /v1/verify-batch #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/giggal-ai/openapi/_ae-authored/giggal-ai-openapi-generated.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/giggal-ai/json-schema/giggal-ai-post-v1-catchall-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/giggal-ai/json-schema/giggal-ai-get-v1-credits-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/giggal-ai/json-schema/giggal-ai-get-v1-catchall-taskid-results-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/giggal-ai/json-schema/giggal-ai-post-v1-catchall-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/giggal-ai/json-schema/giggal-ai-get-v1-catchall-taskid-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/giggal-ai/json-schema/giggal-ai-get-v1-jobs-response-schema.json

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/giggal-ai/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/giggal-ai:giggal-ai-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

giggal-ai-openapi-generated.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Giggal.ai API
  version: '2026-11-10'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-10: 8 operation(s) read from 11 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Giggal.ai has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 3
    documentation: 5
    pages-with-code: 11
    pages-read: 11
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-10'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://giggal.ai/email-validation-api
  - https://giggal.ai/email-verification-api
  - https://giggal.ai/public/docs
  - https://giggal.ai/it/api-validazione-email
  - https://giggal.ai/de/e-mail-validierung-api
  - https://giggal.ai/es/api-de-validacion-de-correo
  - https://giggal.ai/pt-br/api-de-validacao-de-email
  - https://giggal.ai/fr/api-validation-email
  - https://giggal.ai/nl/e-mailvalidatie-api
  - https://giggal.ai/pl/api-walidacji-email
  - https://giggal.ai/id/api-validasi-email
servers:
- url: https://api.giggal.ai
paths:
  /v1/catchall:
    post:
      operationId: post_v1_catchall
      tags:
      - Catchall
      summary: Email verification API with Catch-All Resolution
      description: Bulk catch‑all resolution. Run deep catch‑all resolution across addresses flagged as catch‑all from a completed bulk job. Download
        results as a clean CSV.
      x-source: https://giggal.ai/email-verification-api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1CatchallRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1CatchallResponse'
      x-evidence:
        kind: documentation
  /v1/catchall/{taskid}:
    get:
      operationId: get_v1_catchall_taskid
      tags:
      - Catchall
      summary: Get catch-all task status
      x-source: https://giggal.ai/public/docs
      parameters:
      - name: taskid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1CatchallTaskidResponse'
      x-evidence:
        kind: documentation
  /v1/catchall/{taskid}/download:
    get:
      operationId: get_v1_catchall_taskid_download
      tags:
      - Catchall
      summary: Download catch-all results as CSV
      x-source: https://giggal.ai/public/docs
      parameters:
      - name: taskid
        in: path
        required: true
        schema:
          type: string
      - name: verdict
        in: query
        required: false
        schema:
          type: string
        description: 'Filter by verdict: valid | invalid.'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1CatchallTaskidDownloadResponse'
      x-evidence:
        kind: documentation
  /v1/catchall/{taskid}/results:
    get:
      operationId: get_v1_catchall_taskid_results
      tags:
      - Catchall
      summary: Get catch-all task results
      x-source: https://giggal.ai/public/docs
      parameters:
      - name: taskid
        in: path
        required: true
        schema:
          type: string
      - name: page
        in: query
        required: false
        schema:
          type: integer
        description: Page number, defaults to 1.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Results per page, defaults to 25, max 500.
      - name: verdict
        in: query
        required: false
        schema:
          type: string
        description: 'Filter by verdict: valid | invalid.'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1CatchallTaskidResultsResponse'
      x-evidence:
        kind: documentation
  /v1/credits:
    get:
      operationId: get_v1_credits
      tags:
      - Credits
      summary: Get current credit balance
      x-source: https://giggal.ai/public/docs
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1CreditsResponse'
      x-evidence:
        kind: documentation
  /v1/jobs:
    get:
      operationId: get_v1_jobs
      tags:
      - Jobs
      summary: Email verification API with Catch-All Resolution
      description: Retrieve a list of recent batch jobs.
      x-source: https://giggal.ai/email-verification-api
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1JobsResponse'
      x-evidence:
        kind: documentation
  /v1/verify:
    post:
      operationId: post_v1_verify
      tags:
      - Verify
      summary: POST /v1/verify
      x-source: https://giggal.ai/email-validation-api
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1VerifyResponse'
      x-evidence:
        kind: code-example
        language: python
        snippet: "requests.post(\n \"https://api.giggal.ai/v1/verify\",\n headers={\"Authorization\": f\"Bearer {os.environ['GIGGAL_API_KEY']}\"\
          },\n json={\"email\": email},\n timeout=timeout_seconds # fail open on timeout\n )"
  /v1/verify-batch:
    post:
      operationId: post_v1_verify_batch
      tags:
      - Verify Batch
      summary: POST /v1/verify-batch
      x-source: https://giggal.ai/email-verification-api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1VerifyBatchRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: javascript
        snippet: "fetch('https://api.giggal.ai/v1/verify-batch', {\n method: 'POST',\n headers: {\n 'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}`,\n\
          \ 'Content-Type': 'application/json',\n 'Idempotency-Key': 'batch-job-2026-10-01-01',\n },\n body: JSON.stringify({\n name: 'Q4 Sales\
          \ Leads',\n emails: ['alex.smith@example.com', 'maria.garcia@example.org'],\n })"
components:
  schemas:
    PostV1CatchallRequest:
      type: object
      properties:
        emails:
          type: array
          description: List of email addresses flagged as catch‑all from a completed bulk job
      required:
      - emails
    PostV1CatchallResponse:
      type: object
      properties:
        success:
          type: boolean
        data.csv_url:
          type: string
          description: URL to download the CSV with score and status columns
        meta.creditsUsed:
          type: integer
    GetV1CatchallTaskidResponse:
      type: object
      properties:
        taskId:
          type: string
          description: Task identifier.
        status:
          type: string
          description: Current task status.
    GetV1CatchallTaskidDownloadResponse:
      type: object
      properties:
        csv:
          type: string
          description: CSV content with Email,Score,Verdict columns.
    GetV1CatchallTaskidResultsResponse:
      type: object
      properties:
        results:
          type: array
          description: Array of per‑email catch‑all results.
        pagination:
          type: object
          description: Pagination info.
    GetV1CreditsResponse:
      type: object
      properties:
        balance:
          type: integer
          description: Current total credit balance.
        availableCredits:
          type: integer
          description: Credits available for new requests.
    GetV1JobsResponse:
      type: object
      properties:
        success:
          type: boolean
        data.jobs[]:
          type: array
          description: List of recent jobs with their IDs and statuses
    PostV1VerifyResponse:
      type: object
      properties:
        error:
          type: string
    PostV1VerifyBatchRequest:
      type: object
      properties:
        name:
          type: string
        emails:
          type: array
          items:
            type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Catchall
- name: Credits
- name: Jobs
- name: Verify
- name: Verify Batch