ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

dievio-lead-search-api

Run Dievio lead search and LinkedIn lookup workflows through the public API with correct authentication, filters, pagination, and credit-aware handling. Use this skill when users need to find B2B leads, enrich LinkedIn URLs with emails/phones, apply Dievio filter fields, or iterate across paginated API results safely.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/hundevmode/dievio-lead-search-api
Or

Dievio Lead Search Api

Overview

Use this skill for end-to-end Dievio API execution: authenticate requests, submit lead searches, enrich LinkedIn profiles, and paginate results. Prefer the bundled script for deterministic request formatting and response handling.

Core Endpoints

  • Public lead search: POST https://dievio.com/api/public/search
  • LinkedIn lookup: POST https://dievio.com/api/linkedin/lookup

Authentication headers (use one):

  • Authorization: Bearer YOUR_API_KEY
  • X-API-Key: YOUR_API_KEY

Workflow

  1. Validate credentials:
  • Require DIEVIO_API_KEY for API-key flows.
  • Never print raw secrets.
  1. Build request body:
  • Search endpoint uses pagination keys (_page, _per_page, max_results) plus filters.
  • LinkedIn lookup requires linkedinUrls and optional output flags.
  1. Execute request and parse response:
  • Validate success, count, has_more, next_page, data arrays.
  • Respect credit behavior: low credits can return fewer rows than requested.
  1. Handle errors:
  • 401: missing/invalid credentials
  • 402: insufficient credits
  • 502: upstream lead service issue
  • 500: server error

Commands

Show help:

python3 scripts/dievio_api.py --help

Search with JSON body:

export DIEVIO_API_KEY="your_api_key"
python3 scripts/dievio_api.py search \
  --body-file ./search_body.json \
  --auto-paginate

By default the CLI prints a safe summary. Use --raw-output only when you explicitly need full rows (which may contain emails/phones).

LinkedIn lookup from URLs:

python3 scripts/dievio_api.py linkedin-lookup \
  --linkedin-url "https://www.linkedin.com/in/example-1" \
  --linkedin-url "https://www.linkedin.com/in/example-2" \
  --include-work-emails \
  --include-personal-emails \
  --only-with-emails

Decision Rules

  • Use search when query is filter-based lead discovery.
  • Use linkedin-lookup when input is explicit LinkedIn profile URLs.
  • For large pulls, enable pagination and stop on has_more=false.
  • Keep outputs structured and include paging fields for traceability.
  • If user asks for exact filter values, read references/filters-cheatsheet.md.

References

  • API contracts: references/api-reference.md
  • Filter fields and allowed values: references/filters-cheatsheet.md
  • Pagination behavior: references/pagination.md
  • Error handling guidance: references/errors.md
Read Full Documentation on GitHub

Metadata

Author@hundevmode
Stars2387
Views0
Updated2026-03-09
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-hundevmode-dievio-lead-search-api": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

Linkedin Email Phone Apify

Skill by hundevmode

hundevmode 2387

twitter-x-apify-actors

Use this skill when the user needs Twitter/X audience collection through Apify actors (followers/following/both) with optional email enrichment, username extraction from links, normalized row output, or webhook-ready payload building.

hundevmode 2387

boosta-long-to-shorts

Create, monitor, and troubleshoot Boosta API video-processing jobs from natural-language requests. Use this skill when a user asks to generate clips from a video URL via Boosta, check job status, fetch completed clip URLs, inspect usage/credits, choose the correct video_type, or handle Boosta API errors and retry logic.

hundevmode 2387

apollo-like-leads-apify

Use this skill when the user needs B2B lead collection via Apify actor LurATYM4hkEo78GVj (Apollo-like), including filter-based payload building, validated run execution, and JSON/CSV-ready lead output for outreach workflows.

hundevmode 2387