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

# Influship API

> Find the right creators for any campaign — search by natural language, explore profiles, discover lookalikes, and score campaign fit.

# Influship API

Describe the kind of creator you need, and the API finds them. Search returns ranked results with match scores and explanations, so you can build creator discovery into your product without training a model or managing data pipelines.

## Core Workflows

<CardGroup cols={2}>
  <Card title="AI Search" icon="magnifying-glass" href="/concepts/semantic-search">
    Pass a natural-language query — platform preferences, audience traits, content style — and get back ranked creators with match reasons.
  </Card>

  <Card title="Profile Lookup" icon="user" href="/concepts/creators-vs-profiles">
    Resolve a known social account by platform and username. Returns follower counts, engagement rates, content categories, and audience demographics.
  </Card>

  <Card title="Lookalikes" icon="users" href="/concepts/lookalikes">
    Start from a creator that fits and find more like them. Useful for expanding a shortlist or replacing a creator who declined.
  </Card>

  <Card title="Campaign Match" icon="bolt" href="/concepts/match-reasons">
    Score how well a set of creators fits a specific campaign brief. Each result includes a fit score and the reasoning behind it.
  </Card>
</CardGroup>

## Quick Example

<CodeGroup>
  ```typescript TypeScript SDK theme={null}
  import Influship from 'influship';

  const client = new Influship({
    apiKey: process.env.INFLUSHIP_API_KEY,
  });

  const response = await client.creators.search({
    query: 'travel content creators with strong YouTube presence',
    limit: 5,
  });

  console.log(response);
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.influship.com/v1/search \
    -H 'X-API-Key: YOUR_KEY' \
    -H 'Content-Type: application/json' \
    -d '{"query": "travel content creators with strong YouTube presence", "limit": 5}'
  ```
</CodeGroup>

Abbreviated response:

```json theme={null}
{
  "data": [
    {
      "creator": {
        "id": "b2d4f6a8-e1c3-4b7d-9f2a-8c6e0d4b3a1f",
        "name": "Priya Mehta"
      },
      "primary_profile": {
        "platform": "youtube",
        "username": "priyatravels"
      },
      "match": {
        "score": 0.94,
        "reasons": ["Consistent travel content with high audience retention on YouTube"]
      }
    }
  ],
  "search_id": "search_123",
  "total": 1,
  "has_more": false,
  "next_cursor": null
}
```

Search accepts natural language, but result quality depends on input quality. If your users are not marketers or developers, consider running their input through an LLM to tighten the query before sending it to the API.

## Get Started

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Make your first request and inspect the response shape.
  </Card>

  <Card title="API Reference" icon="book" href="/api-reference">
    Full endpoint specs with request examples for every SDK.
  </Card>

  <Card title="SDKs" icon="code" href="/sdks">
    Install the TypeScript SDK and start making typed requests.
  </Card>

  <Card title="Pricing" icon="dollar-sign" href="/concepts/pricing">
    Credit costs, billing tiers, and usage examples.
  </Card>
</CardGroup>

<Info>
  If you're an early-stage startup, check out the [startup program](mailto:elliot@influship.com) for discounted access.
</Info>

<Info>
  Need custom rate limits or volume pricing? Reach out at [elliot@influship.com](mailto:elliot@influship.com).
</Info>