> ## Documentation Index
> Fetch the complete documentation index at: https://docs.influship.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cookbook

> Choose a runnable example or workflow for creator discovery, campaign comparison, and exports

Choose a recipe based on what you already have and what you want to build. Each recipe explains the API calls, the output, and the request costs.

## Start with a complete app

> [card] [Build a Creator Search App](https://docs.influship.com/cookbook/creator-search-nextjs.md)
>
> Enter a campaign brief, review up to five Instagram creators, and export a CSV. Includes a Next.js app, server-side TypeScript SDK integration, tests, and MIT-licensed source.

You need Node.js 22+, pnpm 10.32.1, and an [API key](https://developers.influship.com). A five-result search costs 35 credits (\$0.35). Download and run the source from the [setup guide](https://docs.influship.com/cookbook/creator-search-nextjs.md).

For search, supporting evidence, and saved API shortlists, run the [creator research app](https://docs.influship.com/cookbook/creator-research-app.md). It uses Node.js without a dependency installation.

## Choose your workflow

| You have | You want | Recipe |
| - | - | - |
| A campaign brief | An interface for evidence review and saved API shortlists | [Creator research app](https://docs.influship.com/cookbook/creator-research-app.md) |
| A campaign brief | A browser app with ranked results and CSV export | [Creator search app](https://docs.influship.com/cookbook/creator-search-nextjs.md) |
| A campaign brief | Discovery followed by campaign scoring and profile expansion | [Build a Creator Shortlist](https://docs.influship.com/cookbook/build-a-shortlist.md) |
| Known Instagram handles | A runnable script to compare campaign fit directly | [Compare Creators](https://docs.influship.com/cookbook/compare-creators.md) |
| An existing roster | Similar creators, using weighted seeds | [Expand with Lookalikes](https://docs.influship.com/concepts/lookalikes.md) |
| Handles requiring profile resolution | Profile lookup followed by campaign scoring | [Score Campaign Fit](https://docs.influship.com/cookbook/score-campaign-fit.md) |
| A campaign brief | A runnable script that writes a CSV from one search | [Export a Shortlist to CSV](https://docs.influship.com/cookbook/export-shortlist-csv.md) |

The comparison script accepts handles directly. Use the profile-resolution workflow when you also need creator IDs and profile data; the extra lookup is a separate API call.

## Before you run a recipe

* Follow the [quickstart](https://docs.influship.com/quickstart.md) to create a key and make your first request.
* Use the [SDK guide](https://docs.influship.com/sdks.md) for TypeScript installation or the [API reference](https://docs.influship.com/api-reference.md) for raw HTTP.
* Review [pricing](https://docs.influship.com/concepts/pricing.md) before increasing result counts or adding calls.
* Read [match reasons](https://docs.influship.com/concepts/match-reasons.md) to interpret scores, explanations, and confidence markers.
* Follow [error handling](https://docs.influship.com/guides/error-handling.md) for credentials, billing, rate limits, and temporary failures.

Example records are illustrative. Verify live access with your own key, review the returned creators, and measure whether a recipe meets your campaign requirements.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.