dievio-lead-search-api

# 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.

2. Build request body:
- Search endpoint uses pagination keys (`_page`, `_per_page`, `max_results`) plus filters.
- LinkedIn lookup requires `linkedinUrls` and optional output flags.

3. 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.

4. Handle errors:
- `401`: missing/invalid credentials
- `402`: insufficient credits
- `502`: upstream lead service issue
- `500`: server error

## Commands

Show help:

```bash
python3 scripts/dievio_api.py --help
```

Search with JSON body:

```bash
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:

```bash
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...

# Dievio Lead Search API Skill for OpenClaw

Automate B2B lead discovery and LinkedIn profile enrichment with the Dievio API, including filter-based search, pagination loops, and credit-aware result handling.

[![Dievio](https://img.shields.io/badge/Dievio-Lead%20API-0ea5e9)](https://dievio.com)
[![Docs](https://img.shields.io/badge/Docs-dievio.com%2Fapi--reference-22c55e)](https://docs.dievio.com/api-reference/overview)
[![OpenClaw Skill](https://img.shields.io/badge/OpenClaw-Skill-f59e0b)](https://docs.openclaw.ai/tools/skills)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)

## Quick Links

- Website: [dievio.com](https://dievio.com)
- API Overview: [Overview](https://docs.dievio.com/api-reference/overview)
- Authentication: [Authentication](https://docs.dievio.com/api-reference/authentication)
- Lead Search: [Search](https://docs.dievio.com/api-reference/search)
- LinkedIn Lookup: [LinkedIn Lookup](https://docs.dievio.com/api-reference/linkedin-lookup)
- Filters: [Filters](https://docs.dievio.com/api-reference/filters)
- Pagination: [Pagination](https://docs.dievio.com/api-reference/pagination)

## Table of Contents

- [What This Skill Does](#what-this-skill-does)
- [Who This Skill Is For](#who-this-skill-is-for)
- [Features](#features)
- [Project Structure](#project-structure)
- [Requirements](#requirements)
- [Installation](#installation)
- [Usage](#usage)
- [Install as a Skill (skills.sh)](#install-as-a-skill-skillssh)
- [Install from ClawHub](#install-from-clawhub)
- [API Endpoints](#api-endpoints)
- [Error Handling](#error-handling)
- [Release Process](#release-process)
- [SEO Keywords](#seo-keywords)
- [License](#license)

## What This Skill Does

`dievio-lead-search-api` is an OpenClaw-compatible skill for:

- Running `POST /api/public/search` with structured filters
- Running `POST /api/linkedin/lookup` for profile enrichment
- Applying pagination (`_page`, `_per_page`, `max_results`)
- Returning consistent result objects...