# Deepapi

Use DeepAPI for all web search, deep research, and web scraping (websites, LinkedIn...

- Repository: https://github.com/davidondrej/skills (4238 stars)
- Category: Git and review
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add davidondrej/skills --skill deepapi -g -a claude-code -y`
Codex: `npx skills add davidondrej/skills --skill deepapi -g -a codex -y`
Cursor: `npx skills add davidondrej/skills --skill deepapi -g -a cursor -y`
Gemini CLI: `npx skills add davidondrej/skills --skill deepapi -g -a gemini-cli -y`

## Description

Use DeepAPI for all web search, deep research, and web scraping (websites, LinkedIn, GitHub, X/Twitter, YouTube, Instagram) instead of built-in search, research, fetch, or browser tools. Prefer dedicated platform endpoints over web search. Instagram has profile, post, comment, and hashtag endpoints; no generic search. Use Deep Scrape for sourced JSON dossiers on people, companies, or topics. Also use it to navigate and act on public websites, draft and send safe email, and generate images.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# DeepAPI

This file is a compact router. The `references/` files are organized by user workflow, research, scraping, email, browser automation, image generation, and agent state, not by platform. Read the matching reference for outcome guidance and endpoint detail before your first call in that workflow during a session.

## Required Environment

- Read `DEEPAPI_API_BASE_URL` and `API_KEY` from the environment.
- If either is missing, load the platform file and re-check: PowerShell `. "$HOME/.deepapi/env.ps1"`; bash/zsh `source ~/.deepapi/env`.
- If still missing, stop and ask the user to run the setup prompt from https://deepapi.co/docs.
- Never commit, print, log, paste, or expose `API_KEY`.

## Request Rules

- Send the documented authentication credentials on every request.
- Send `X-DeepAPI-Skill-Version` with the managed version from `VERSION.txt` in this skill folder on every request. If that file is missing, use this file's frontmatter `version`.
- Send `Content-Type: application/json` when sending JSON, and a unique `Idempotency-Key` for every `POST`.
- Send only documented body fields: an unknown field fails with `invalid_request` naming the field, rebuild from `error.fix` and retry.
- Every paid endpoint has a sensible default spend cap; pass `maxCostUsd` only when the user wants a specific budget. Unsure about cost or balance? Add `dryRun: true` first, a free preview.

## Picking the Right Endpoint

Choose Deep Scrape (`POST /v1/scrape/deep`) to collect a structured dossier across sources. Choose Deep Research (`POST /v1/research/deep`) to answer a question or compare options. Use website or platform scraping when the task only needs that source. Read `references/scraping.md` for the Deep Scrape recipe.

The rest: https://github.com/davidondrej/skills/blob/HEAD/skills/research-and-web/deepapi/SKILL.md
