Dievio

Dievio API

Dievio API as documented publicly: 5 operations. Contract generated from the documentation by API Evangelist (2026-11-05); not the provider's own document.

Documentation GitHub OpenAPI

Operations 5

POST /api/linkedin/export Partial phone results in a direct export #

POST /api/linkedin/lookup Dievio’s API provides programmatic access to the same lead search engine used in the dashboard. #

POST /api/preview POST /api/preview #

POST /api/public/search POST /api/public/search #

POST /api/search Dievio’s API provides programmatic access to the same lead search engine used in the dashboard. #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/dievio-com/openapi/_ae-authored/dievio-com-openapi-generated.yml

Schemas & Data

📊

JSONSchema

https://artifacts.apis.io/dievio-com/json-schema/dievio-com-post-api-public-search-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/dievio-com/json-schema/dievio-com-post-api-linkedin-export-request-schema.json

📊

JSONSchema

https://artifacts.apis.io/dievio-com/json-schema/dievio-com-post-api-linkedin-export-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/dievio-com/json-schema/dievio-com-post-api-public-search-request-schema.json

📊

JSONSchema

https://artifacts.apis.io/dievio-com/json-schema/dievio-com-post-api-preview-request-schema.json

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/dievio-com:dievio-com-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

openapi: 3.1.0
info:
  title: Dievio API
  version: '2026-11-05'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-05: 5 operation(s) read from 5 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Dievio has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 2
    documentation: 3
    pages-with-code: 4
    pages-read: 5
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-05'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.dievio.com/api-reference/search
  - https://docs.dievio.com/api-reference/overview
  - https://docs.dievio.com/api-reference/pagination
  - https://docs.dievio.com/api-reference/linkedin-lookup
  - https://docs.dievio.com/getting-started/quickstart
servers:
- url: https://dievio.com
paths:
  /api/linkedin/export:
    post:
      operationId: post_api_linkedin_export
      tags:
      - Api
      summary: Partial phone results in a direct export
      x-source: https://docs.dievio.com/api-reference/linkedin-lookup
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiLinkedinExportRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiLinkedinExportResponse'
      x-evidence:
        kind: documentation
  /api/linkedin/lookup:
    post:
      operationId: post_api_linkedin_lookup
      tags:
      - Api
      summary: Dievio’s API provides programmatic access to the same lead search engine used in the dashboard.
      x-source: https://docs.dievio.com/api-reference/overview
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/preview:
    post:
      operationId: post_api_preview
      tags:
      - Api
      summary: POST /api/preview
      x-source: https://docs.dievio.com/getting-started/quickstart
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiPreviewRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://dievio.com/api/preview \\ -H \"Content-Type: application/json\" \\ -d '{ \"company_websites\": [\"stripe.com\"\
          ], \"job_titles\": [\"Founder\"], \"_count_only\": true }' \n Read total_count and check count_exact . If count_exact is false, the\
          \ count is an estimate. \n 2) Run a full search (dashboard)  \n Use the dashboard to run paid searches. Credits are deducted based\
          \ on the number of results"
  /api/public/search:
    post:
      operationId: post_api_public_search
      tags:
      - Api
      summary: POST /api/public/search
      x-source: https://docs.dievio.com/api-reference/search
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiPublicSearchRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiPublicSearchResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://dievio.com/api/public/search \\ -H \"Authorization: Bearer $DIEVIO_API_KEY\" \\ -H \"Idempotency-Key: $SEARCH_PAGE_KEY\"\
          \ \\ --json '{\"company_websites\":[\"example.com\"],\"_page\":1,\"_per_page\":10,\"max_results\":10}' \n A successful response can\
          \ be replayed for one hour after completion. Retrying with the same key and parameters returns the saved page, including after the available\
          \ balance reaches"
  /api/search:
    post:
      operationId: post_api_search
      tags:
      - Api
      summary: Dievio’s API provides programmatic access to the same lead search engine used in the dashboard.
      x-source: https://docs.dievio.com/api-reference/overview
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiLinkedinExportRequest:
      type: object
      properties:
        linkedinUrls:
          type: string
          description: up to 100,000 URLs
        includeWorkEmails:
          type: boolean
          description: default true
        includePersonalEmails:
          type: boolean
          description: default true
        onlyWithEmails:
          type: boolean
          description: default true
        includePhones:
          type: boolean
          description: default false
        _page:
          type: integer
          description: default 1
        _per_page:
          type: integer
          description: default 100
        max_results:
          type: integer
          description: default linkedinUrls length; fallback 500, max 100000
        format:
          type: string
          description: requested export format (e.g., csv, json)
      required:
      - linkedinUrls
    PostApiLinkedinExportResponse:
      type: object
      properties:
        file:
          type: string
          description: attachment in the requested format
        X-Dievio-Phone-Enrichment:
          type: string
          description: partial if phone enrichment did not complete
    PostApiPreviewRequest:
      type: object
      properties:
        company_websites:
          type: array
          items:
            type: string
        job_titles:
          type: array
          items:
            type: string
        _count_only:
          type: boolean
    PostApiPublicSearchRequest:
      type: object
      properties:
        company_websites:
          type: array
          items:
            type: string
        _page:
          type: integer
        _per_page:
          type: integer
        max_results:
          type: integer
    PostApiPublicSearchResponse:
      type: object
      properties:
        success:
          type: boolean
        count:
          type: integer
        total_count:
          type: integer
        preview_count:
          type: integer
        preview_data:
          type: array
          items:
            type: object
            properties:
              first_name:
                type: string
              last_name:
                type: string
              full_name:
                type: string
              email_status:
                type: string
              phone_status:
                type: string
              job_title:
                type: string
              company:
                type: string
              city:
                type: string
              state:
                type: string
              country:
                type: string
              work_email:
                type: string
              personal_emails:
                type: array
                items:
                  type: string
              mobile_phone:
                type:
                - string
                - 'null'
              linkedin_url:
                type: string
              linkedin_status:
                type: string
              facebook_status:
                type: string
              twitter_status:
                type: string
        message:
          type: string
        page:
          type: integer
        per_page:
          type: integer
        total_pages:
          type: integer
        has_more:
          type: boolean
        next_page:
          type: integer
        search_id:
          type:
          - string
          - 'null'
        counting:
          type: boolean
        max_results:
          type: integer
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api