---
type: "firecrawl-provider"
description: "Search indexed Instagram and TikTok profiles and posts through Oriane, including bios, follower counts and content engagement. Empty results do not trigger live scraping."
use_when: "Oriane instagram.\n\nOriane tiktok."
categories: "Social"
capabilities: 8
pricing: "30 credits per billed unit; see each capability for its unit and maximum."
---
# Oriane on Firecrawl Alexandria

Search indexed Instagram and TikTok profiles and posts through Oriane, including bios, follower counts and content engagement. Empty results do not trigger live scraping.

- Categories: Social
- Category index: [Social category](https://firecrawl.dev/alexandria/agents/categories/social)
- Provider key: `oriane`
- Access: Firecrawl credits
- Cost (Search Instagram profiles): 30 credits per nonempty call
- Cost (Search Instagram posts and reels): 30 credits per nonempty call
- Cost (Look up Instagram post or reel): 30 credits per nonempty call
- Cost (Look up Instagram profile): 30 credits per nonempty call
- Cost (Search TikTok profiles): 30 credits per nonempty call
- Cost (Search TikTok videos): 30 credits per nonempty call
- Cost (Look up TikTok video): 30 credits per nonempty call
- Cost (Look up TikTok profile): 30 credits per nonempty call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/oriane)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/oriane/openapi.json)

## Capabilities

- [Search Instagram profiles](https://firecrawl.dev/alexandria/agents/providers/oriane/instagram/profiles-search): Indexed Instagram profiles. Fields depend on projection: basic identity, default adds bio and account counts, full adds contact and location fields. Includes profileUrl.
- [Search Instagram posts and reels](https://firecrawl.dev/alexandria/agents/providers/oriane/instagram/posts-search): Indexed Instagram posts/videos. Fields depend on projection: basic identity, default adds engagement, full adds transcript and richer content fields. Includes profileUrl and postUrl when available.
- [Look up Instagram post or reel](https://firecrawl.dev/alexandria/agents/providers/oriane/instagram/post-lookup): Indexed Instagram posts/videos. Fields depend on projection: basic identity, default adds engagement, full adds transcript and richer content fields. Includes profileUrl and postUrl when available.
- [Look up Instagram profile](https://firecrawl.dev/alexandria/agents/providers/oriane/instagram/profile-lookup): Indexed Instagram profiles. Fields depend on projection: basic identity, default adds bio and account counts, full adds contact and location fields. Includes profileUrl.
- [Search TikTok profiles](https://firecrawl.dev/alexandria/agents/providers/oriane/tiktok/profiles-search): Indexed TikTok profiles. Fields depend on projection: basic identity, default adds bio and account counts, full adds contact and location fields. Includes profileUrl.
- [Search TikTok videos](https://firecrawl.dev/alexandria/agents/providers/oriane/tiktok/posts-search): Indexed TikTok posts/videos. Fields depend on projection: basic identity, default adds engagement, full adds transcript and richer content fields. Includes profileUrl and postUrl when available.
- [Look up TikTok video](https://firecrawl.dev/alexandria/agents/providers/oriane/tiktok/video-lookup): Indexed TikTok posts/videos. Fields depend on projection: basic identity, default adds engagement, full adds transcript and richer content fields. Includes profileUrl and postUrl when available.
- [Look up TikTok profile](https://firecrawl.dev/alexandria/agents/providers/oriane/tiktok/profile-lookup): Indexed TikTok profiles. Fields depend on projection: basic identity, default adds bio and account counts, full adds contact and location fields. Includes profileUrl.

## 1. Choose this provider when

Oriane instagram.

Oriane tiktok.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "oriane",
  "capability": "instagram/profiles-search",
  "options": {
    "handle": "mrbeast",
    "limit": 1,
    "projection": "default"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `handle` (string): Account username to match exactly, for example mrbeast. A leading @ is optional; usernames are matched without regard to case. Provide this or another search field; multiple fields must all match. Example: `<handle>`
- `displayName` (string): Text to match in the display name. Provide this or another search field; multiple fields must all match. Example: `<displayName>`
- `bio` (string): Text to match in the bio. Provide this or another search field; multiple fields must all match. Example: `<bio>`
- `limit` (number): Maximum results, default 20. Example: `10`
- `offset` (number): Result offset, default 0. Exact handle searches return at most one profile and require offset 0; paginate displayName or bio searches instead. Example: `10`
- `sort` (string): Comma-separated sort fields with optional :asc or :desc. Profiles: followersCount, createdAt, updatedAt. Posts: viewsCount, likesCount, sharesCount, commentsCount, interactionsCount, engagementRatePerViews, engagementRatePerFollowers, profileFollowersCount, publishedAt, visualSimilarity, transcriptRelevance. Example: `<sort>`
- `projection` (string): Response detail and fixed price per nonempty call: basic 20 credits, default 30 credits, full 40 credits. Empty results cost zero. Result limit does not change the tier price. Example: `default`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "oriane",
    capability: "instagram/profiles-search",
    options: {
      handle: "mrbeast",
      limit: 1,
      projection: "default",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "oriane",
  "capability": "instagram/profiles-search",
  "options": {
    "handle": "mrbeast",
    "limit": 1,
    "projection": "default"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "oriane",
    "capability": "instagram/profiles-search",
    "options": {
      "handle": "mrbeast",
      "limit": 1,
      "projection": "default"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'oriane/instagram/profiles-search' \
  --options '{"handle":"mrbeast","limit":1,"projection":"default"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "oriane",
  "capability": "instagram/profiles-search",
  "options": {
    "handle": "mrbeast",
    "limit": 1,
    "projection": "default"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "oriane",
  "capability": "instagram/profiles-search",
  "options": {
    "handle": "mrbeast",
    "limit": 1,
    "projection": "default"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "data": [
    {
      "id": "prf_b2caba553ecf8e7df48fd4ef010d",
      "platform": "instagram",
      "handle": "mrbeast",
      "displayName": "MrBeast",
      "bio": "Watch my latest video!! 👇",
      "bioLink": "https://youtu.be/gTKS8SAwUzE?is=ajfROi9qnNjV0jMh",
      "language": null,
      "isPrivate": false,
      "isVerified": true,
      "postsCount": 510,
      "likesCount": null,
      "followersCount": 89341084,
      "followingCount": 1005,
      "profileUrl": "https://www.instagram.com/mrbeast/"
    }
  ],
  "metadata": {
    "pagination": {
      "offset": 0,
      "limit": 1,
      "totalCount": 1
    },
    "requestId": "req_Z5nJQUk2qdwiroUNaowbeQ0toCBo",
    "executionTime": 46,
    "timestamp": 1790891507776
  }
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Search Instagram profiles

- Capability: `instagram/profiles-search`
- Description: Indexed Instagram profiles. Fields depend on projection: basic identity, default adds bio and account counts, full adds contact and location fields. Includes profileUrl.
- Instructions: Search Oriane's indexed Instagram profiles, bios and follower counts. Platform is fixed to Instagram. Coverage and freshness depend on the existing index; this is not a complete live feed. Results include profileUrl; an empty result does not trigger ingestion. Choose projection: basic 20 credits, default 30 credits, full 40 credits per nonempty call. Search limit is at most 100; URL lookup targets one record. Empty results cost zero.
- Cost: 30 credits per nonempty call
- Capability file: [Search Instagram profiles](https://firecrawl.dev/alexandria/agents/providers/oriane/instagram/profiles-search)

Accepted options:
- `handle` (string): Account username to match exactly, for example mrbeast. A leading @ is optional; usernames are matched without regard to case. Provide this or another search field; multiple fields must all match. Example: `<handle>`
- `displayName` (string): Text to match in the display name. Provide this or another search field; multiple fields must all match. Example: `<displayName>`
- `bio` (string): Text to match in the bio. Provide this or another search field; multiple fields must all match. Example: `<bio>`
- `limit` (number): Maximum results, default 20. Example: `10`
- `offset` (number): Result offset, default 0. Exact handle searches return at most one profile and require offset 0; paginate displayName or bio searches instead. Example: `10`
- `sort` (string): Comma-separated sort fields with optional :asc or :desc. Profiles: followersCount, createdAt, updatedAt. Posts: viewsCount, likesCount, sharesCount, commentsCount, interactionsCount, engagementRatePerViews, engagementRatePerFollowers, profileFollowersCount, publishedAt, visualSimilarity, transcriptRelevance. Example: `<sort>`
- `projection` (string): Response detail and fixed price per nonempty call: basic 20 credits, default 30 credits, full 40 credits. Empty results cost zero. Result limit does not change the tier price. Example: `default`

Response schema example:
```json
{
  "data": [
    {
      "id": "prf_b2caba553ecf8e7df48fd4ef010d",
      "platform": "instagram",
      "handle": "mrbeast",
      "displayName": "MrBeast",
      "bio": "Watch my latest video!! 👇",
      "bioLink": "https://youtu.be/gTKS8SAwUzE?is=ajfROi9qnNjV0jMh",
      "language": null,
      "isPrivate": false,
      "isVerified": true,
      "postsCount": 510,
      "likesCount": null,
      "followersCount": 89341084,
      "followingCount": 1005,
      "profileUrl": "https://www.instagram.com/mrbeast/"
    }
  ],
  "metadata": {
    "pagination": {
      "offset": 0,
      "limit": 1,
      "totalCount": 1
    },
    "requestId": "req_Z5nJQUk2qdwiroUNaowbeQ0toCBo",
    "executionTime": 46,
    "timestamp": 1790891507776
  }
}
```

### Search Instagram posts and reels

- Capability: `instagram/posts-search`
- Description: Indexed Instagram posts/videos. Fields depend on projection: basic identity, default adds engagement, full adds transcript and richer content fields. Includes profileUrl and postUrl when available.
- Instructions: Search Oriane's indexed Instagram posts, captions and engagement. Platform is fixed to Instagram. Coverage and freshness depend on the existing index; this is not a complete live feed. Results include profileUrl; an empty result does not trigger ingestion. Choose projection: basic 20 credits, default 30 credits, full 40 credits per nonempty call. Search limit is at most 100; URL lookup targets one record. Empty results cost zero.
- Cost: 30 credits per nonempty call
- Capability file: [Search Instagram posts and reels](https://firecrawl.dev/alexandria/agents/providers/oriane/instagram/posts-search)

Accepted options:
- `handle` (string): Account username to match exactly, for example mrbeast. A leading @ is optional; usernames are matched without regard to case. Provide this or another search field; multiple fields must all match. Example: `<handle>`
- `caption` (string): Text to match in the caption. Provide this or another search field; multiple fields must all match. Example: `<caption>`
- `limit` (number): Maximum results, default 20. Example: `10`
- `offset` (number): Result offset, default 0. Example: `10`
- `sort` (string): Comma-separated sort fields with optional :asc or :desc. Profiles: followersCount, createdAt, updatedAt. Posts: viewsCount, likesCount, sharesCount, commentsCount, interactionsCount, engagementRatePerViews, engagementRatePerFollowers, profileFollowersCount, publishedAt, visualSimilarity, transcriptRelevance. Example: `<sort>`
- `aiSearchAnchor` (string): Anchor from the first visual search page, required for subsequent pages. Example: `<aiSearchAnchor>`
- `projection` (string): Response detail and fixed price per nonempty call: basic 20 credits, default 30 credits, full 40 credits. Empty results cost zero. Result limit does not change the tier price. Example: `default`

Response schema example:
```json
{
  "data": {
    "aggregations": {
      "totalViewsCount": 1012525,
      "totalInteractionsCount": 40289
    },
    "results": [
      {
        "id": "cnt_cb7cc6d14074d29ef87ec9f70533",
        "matchedQueries": [],
        "platform": "instagram",
        "profileHandle": "sebastianhardy_",
        "profileDisplayName": "Sebastian Hardy | AI Marketing",
        "format": "video",
        "caption": "Out of the box Claude can talk about a website but it can’t open one. These five change what it can physically do.\n \nPlaywright hands it a real browser, so it fills in the form, clicks through the page, and uses any site that never built a proper way in. Blotato connects it to your social accounts, so it posts for you, chops one video into a week of content, and builds the graphic itself.\n \nPerplexity gives it live research, so instead of guessing from memory it reads the internet right now and shows you where every claim came from. Higgsfield opens the best video and image models up inside the chat. And Firecrawl reads any website end to end and pulls it back as clean text.\n \nTen minutes and it stops being a chatbot.\n \nComment SOCKET and I’ll send you the setup for all five.\n \n#claudeai #mcp #aitools #claudecode #aiautomation",
        "captionLanguage": "en",
        "thumbnailMediaId": "med_8d98403a55ce165510a2ee372968",
        "publishedAt": "2026-09-17T22:20:05.000Z",
        "profileId": "prf_e72634d504bd71694a3f7d798742",
        "thumbnailMediaUrl": "https://oriane-contents.s3.us-east-1.amazonaws.com/instagram/DdZ62eCxqzk/thumbnail.webp",
        "viewsCount": 2362,
        "likesCount": 20,
        "sharesCount": 13,
        "commentsCount": 36,
        "interactionsCount": 69,
        "engagementRatePerViews": 2.9212531752751905,
        "engagementRatePerFollowers": 0.21978021978021978,
        "profileFollowersCount": 31395,
        "profileFollowingCount": 356,
        "profilePostsCount": 482,
        "mediaCount": 1,
        "duration": 42.955,
        "hashtags": [
          "#claudeai",
          "#mcp",
          "#aitools",
          "#claudecode",
          "#aiautomation"
        ],
        "coAuthors": [],
        "mentions": [],
        "profileUrl": "https://www.instagram.com/sebastianhardy_/",
        "postUrl": null
      },
      {
        "id": "cnt_17d076ccc0ccce6b52ae2840e72e",
        "matchedQueries": [],
        "platform": "instagram",
        "profileHandle": "jackroberts___",
        "profileDisplayName": "Jack Roberts",
        "format": "video",
        "caption": "Comment \"MCP\" and I'll send you the prompt that installs all three.\n\nOut of the box, Claude is working blind.\n\nNo web, no browser, no current docs.\n\nThree MCPs fix all three gaps.\n\nFirecrawl gives it the open internet.\n\nPoint it at a competitor. Pull the whole site.\n\nPlaywright hands it your actual browser.\n\nSo it clicks through the app it just built.\n\nAnd it tests instead of assuming.\n\nContext7 pulls the live docs.\n\nNo more guessing at an API that already changed.\n\nLike hiring someone smart with no internet.\n\nThen giving them a laptop.\n\nSame model. Completely different output.\n\nInstall once. Use it forever.\n\n#claudecode #mcp #firecrawl #playwright #context7",
        "captionLanguage": "en",
        "thumbnailMediaId": "med_5c41a69645c37d4e050a9b963ae9",
        "publishedAt": "2026-09-09T15:42:34.000Z",
        "profileId": "prf_4fcd3e32da9ab1c1718b98cded0e",
        "thumbnailMediaUrl": "https://oriane-contents.s3.us-east-1.amazonaws.com/instagram/DdEmuBICW41/thumbnail.webp",
        "viewsCount": 10833,
        "likesCount": 229,
        "sharesCount": 171,
        "commentsCount": 229,
        "interactionsCount": 629,
        "engagementRatePerViews": 5.806332502538539,
        "engagementRatePerFollowers": 1.3135088855012844,
        "profileFollowersCount": 47887,
        "profileFollowingCount": 239,
        "profilePostsCount": 74,
        "mediaCount": 1,
        "duration": 38.784,
        "hashtags": [
          "#claudecode",
          "#mcp",
          "#firecrawl",
          "#playwright",
          "#context7"
        ],
        "coAuthors": [],
        "mentions": [],
        "profileUrl": "https://www.instagram.com/jackroberts___/",
        "postUrl": null
      },
      {
        "id": "cnt_554b595a7f1681ffa724ff37f67d",
        "matchedQueries": [],
        "platform": "instagram",
        "profileHandle": "erikammello",
        "profileDisplayName": "Erika Mello | Instagram e ChatGPT",
        "format": "video",
        "caption": "Skills 👇🏻:\n\nSkill Claude 1 - Humanizer\nSabe quando um texto parece que foi um robô que escreveu? Essa skill conserta isso. Pega o texto da IA e deixa com jeito de gente de verdade falando.\nNinguém percebe que foi a IA que escreveu.\n\nSkill Claude 2 - Firecrawl\nNormalmente o Claude não consegue entrar nos sites pra ler. Essa skill abre essa porta: ele entra, lê a página inteira e te traz o que importa.\nÉ como mandar alguém pesquisar tudo na internet por você.\n\nSkill Claude 3 - Superpower\nEm vez de fazer uma coisa de cada vez, o Claude vira um time.\nEle pensa no plano, faz o trabalho e ainda confere se ficou bom no final.\nComo ter vários ajudantes trabalhando juntos pra você.\n\nSkill Claude 4 - Skill Builder\nEssa é a skill que cria outras skills. Ela te faz umas perguntas e monta uma ferramenta do jeitinho que você precisa.\nSe você faz a mesma coisa toda semana, ela deixa no automático.\n\nSkill Claude 5 - MCP Builder\nEssa skill liga o Claude com os seus programas, tipo planilhas e ferramentas de trabalho. Ela monta a “ponte” entre eles.\nAí o Claude para de só conversar e começa a fazer as coisas por você.\n\nSkill Claude 6 - Marketing Skills by Corey Haines\nAqui o Claude aprende os truques de um dos maiores especialistas em vender pela internet. Ele te ajuda a saber pra quem vender e como.\nÉ estratégia pronta, não só um textinho.\n\n✨ Não use o Claude como um chatbot!!!\nTodas essas skills vão transformar o Claude num super-funcionário.\n\nAgora comenta “60” que envio todos os +60 comandos secretos do Claude 👇🏻",
        "captionLanguage": "pt",
        "thumbnailMediaId": "med_2292a072d53eec9c78f429cd6961",
        "publishedAt": "2026-09-04T20:00:05.000Z",
        "profileId": "prf_d1fee879e5717fc95885b801f244",
        "thumbnailMediaUrl": "https://oriane-contents.s3.us-east-1.amazonaws.com/instagram/Dc4MdbThoH1/thumbnail.webp",
        "viewsCount": 75791,
        "likesCount": 573,
        "sharesCount": 191,
        "commentsCount": 718,
        "interactionsCount": 1482,
        "engagementRatePerViews": 1.955377287540737,
        "engagementRatePerFollowers": 0.8606221798944257,
        "profileFollowersCount": 172201,
        "profileFollowingCount": 0,
        "profilePostsCount": 962,
        "mediaCount": 1,
        "duration": 5.732,
        "hashtags": [],
        "coAuthors": [],
        "mentions": [],
        "profileUrl": "https://www.instagram.com/erikammello/",
        "postUrl": null
      },
      {
        "id": "cnt_6fb3446ec5abe8f3e61b39523868",
        "matchedQueries": [],
        "platform": "instagram",
        "profileHandle": "sebastianhardy_",
        "profileDisplayName": "Sebastian Hardy | AI Marketing",
        "format": "video",
        "caption": "Three free tools that do what Apify, Firecrawl and ScrapingBee charge you monthly for.\n \nScrapeGraph AI is the one almost nobody names. You give it a link and a sentence describing what you want off the page, and it hands back clean structured data. No code, no selectors.\n \nAgent Reach gets into the places that lock you out, LinkedIn, Instagram, X and Reddit, with no paid keys. Scrapling fixes the thing that actually kills scraping projects, which is a site redesigning and breaking everything you built.\n \nOne rule before you start: stick to public business information and respect the site’s rules. Free tools do not make everything permitted, and that part is in the guide.\n \nComment SPIDER and I’ll send you the links.\n \n#scraping #leadgeneration #aitools #opensource #automation",
        "captionLanguage": "en",
        "thumbnailMediaId": "med_4d0c16c0c90685a7c6ea52f6df05",
        "publishedAt": "2026-08-29T18:55:09.000Z",
        "profileId": "prf_e72634d504bd71694a3f7d798742",
        "thumbnailMediaUrl": "https://oriane-contents.s3.us-east-1.amazonaws.com/instagram/DcooSi0IUZI/thumbnail.webp",
        "viewsCount": 3362,
        "likesCount": 45,
        "sharesCount": 53,
        "commentsCount": 108,
        "interactionsCount": 206,
        "engagementRatePerViews": 6.127305175490779,
        "engagementRatePerFollowers": 0.6561554387641344,
        "profileFollowersCount": 31395,
        "profileFollowingCount": 356,
        "profilePostsCount": 482,
        "mediaCount": 1,
        "duration": 36.847,
        "hashtags": [
          "#scraping",
          "#leadgeneration",
          "#aitools",
          "#opensource",
          "#automation"
        ],
        "coAuthors": [],
        "mentions": [],
        "profileUrl": "https://www.instagram.com/sebastianhardy_/",
        "postUrl": null
      },
      {
        "id": "cnt_8ac0ae5ff67a1f0739b919e16e9a",
        "matchedQueries": [],
        "platform": "instagram",
        "profileHandle": "andrew.today",
        "profileDisplayName": "andrew yeung",
        "format": "video",
        "caption": "I used Lovable for the first time last year, and today's product is night and day. And I just built an AI executive assistant with Lovable. Lovable just launched connectors, which let you pull from real live accounts like Gmail, Calendar, Firecrawl, and ElevenLabs. \n\nIt’s completely changed the way I build apps.\n\nTry it here! https://link.lovable.dev/5RgYUIi\n\n#LovablePartner",
        "captionLanguage": "en",
        "thumbnailMediaId": "med_6d6fe537c037fe98dd3e0b1b7a7c",
        "publishedAt": "2026-08-27T19:30:59.000Z",
        "profileId": "prf_22549a6b1fd8dceca03a897bea6c",
        "thumbnailMediaUrl": "https://oriane-contents.s3.us-east-1.amazonaws.com/instagram/Dcjg35sKMtM/thumbnail.webp",
        "viewsCount": 3136,
        "likesCount": 49,
        "sharesCount": 16,
        "commentsCount": 2,
        "interactionsCount": 67,
        "engagementRatePerViews": 2.1364795918367347,
        "engagementRatePerFollowers": 0.14575990949832485,
        "profileFollowersCount": 45966,
        "profileFollowingCount": 2778,
        "profilePostsCount": 238,
        "mediaCount": 1,
        "duration": 105.649,
        "hashtags": [
          "#lovablepartner"
        ],
        "coAuthors": [],
        "mentions": [],
        "profileUrl": "https://www.instagram.com/andrew.today/",
        "postUrl": null
      }
    ]
  },
  "metadata": {
    "pagination": {
      "offset": 0,
      "limit": 5,
      "totalCount": 10
    },
    "requestId": "req_CFlX1lEYmW8IDbugOhGHtJU5e8L8",
    "executionTime": 64,
    "timestamp": 1790891529594
  }
}
```

### Look up Instagram post or reel

- Capability: `instagram/post-lookup`
- Description: Indexed Instagram posts/videos. Fields depend on projection: basic identity, default adds engagement, full adds transcript and richer content fields. Includes profileUrl and postUrl when available.
- Instructions: Resolve a canonical Instagram post/video URL against Oriane's index. Instagram uses the post shortcode; TikTok uses the numeric video ID. Empty results do not trigger ingestion. Choose projection: basic 20 credits, default 30 credits, full 40 credits per nonempty call. Search limit is at most 100; URL lookup targets one record. Empty results cost zero.
- Cost: 30 credits per nonempty call
- Capability file: [Look up Instagram post or reel](https://firecrawl.dev/alexandria/agents/providers/oriane/instagram/post-lookup)

Accepted options:
- `url` (string, required): Canonical Instagram /p/ or /reel/ URL. Short links are unsupported. Example: `<url>`
- `projection` (string): Response detail and fixed price per nonempty call: basic 20 credits, default 30 credits, full 40 credits. Empty results cost zero. Result limit does not change the tier price. Example: `default`

Response schema example:
```json
{
  "data": {
    "aggregations": {
      "totalViewsCount": 2362,
      "totalInteractionsCount": 69
    },
    "results": [
      {
        "id": "cnt_cb7cc6d14074d29ef87ec9f70533",
        "matchedQueries": [],
        "platform": "instagram",
        "profileHandle": "sebastianhardy_",
        "profileDisplayName": "Sebastian Hardy | AI Marketing",
        "format": "video",
        "caption": "Out of the box Claude can talk about a website but it can’t open one. These five change what it can physically do.\n \nPlaywright hands it a real browser, so it fills in the form, clicks through the page, and uses any site that never built a proper way in. Blotato connects it to your social accounts, so it posts for you, chops one video into a week of content, and builds the graphic itself.\n \nPerplexity gives it live research, so instead of guessing from memory it reads the internet right now and shows you where every claim came from. Higgsfield opens the best video and image models up inside the chat. And Firecrawl reads any website end to end and pulls it back as clean text.\n \nTen minutes and it stops being a chatbot.\n \nComment SOCKET and I’ll send you the setup for all five.\n \n#claudeai #mcp #aitools #claudecode #aiautomation",
        "captionLanguage": "en",
        "thumbnailMediaId": "med_8d98403a55ce165510a2ee372968",
        "publishedAt": "2026-09-17T22:20:05.000Z",
        "profileId": "prf_e72634d504bd71694a3f7d798742",
        "thumbnailMediaUrl": "https://oriane-contents.s3.us-east-1.amazonaws.com/instagram/DdZ62eCxqzk/thumbnail.webp",
        "viewsCount": 2362,
        "likesCount": 20,
        "sharesCount": 13,
        "commentsCount": 36,
        "interactionsCount": 69,
        "engagementRatePerViews": 2.9212531752751905,
        "engagementRatePerFollowers": 0.21978021978021978,
        "profileFollowersCount": 31395,
        "profileFollowingCount": 356,
        "profilePostsCount": 482,
        "mediaCount": 1,
        "duration": 42.955,
        "hashtags": [
          "#claudeai",
          "#mcp",
          "#aitools",
          "#claudecode",
          "#aiautomation"
        ],
        "coAuthors": [],
        "mentions": [],
        "profileUrl": "https://www.instagram.com/sebastianhardy_/",
        "postUrl": null
      }
    ]
  },
  "metadata": {
    "pagination": {
      "offset": 0,
      "limit": 1,
      "totalCount": 1
    },
    "requestId": "req_bqp8Xhl1fLWTSLt65PWbTqTzxCNd",
    "executionTime": 69,
    "timestamp": 1790891540161
  }
}
```

### Look up Instagram profile

- Capability: `instagram/profile-lookup`
- Description: Indexed Instagram profiles. Fields depend on projection: basic identity, default adds bio and account counts, full adds contact and location fields. Includes profileUrl.
- Instructions: Pass a canonical Instagram profile URL to look up account details in Oriane's index. Returns profileUrl with each match. Short links and post URLs are unsupported; empty results do not trigger ingestion. Choose projection: basic 20 credits, default 30 credits, full 40 credits per nonempty call. Search limit is at most 100; URL lookup targets one record. Empty results cost zero.
- Cost: 30 credits per nonempty call
- Capability file: [Look up Instagram profile](https://firecrawl.dev/alexandria/agents/providers/oriane/instagram/profile-lookup)

Accepted options:
- `url` (string, required): Canonical Instagram profile URL. Example: `<url>`
- `projection` (string): Response detail and fixed price per nonempty call: basic 20 credits, default 30 credits, full 40 credits. Empty results cost zero. Result limit does not change the tier price. Example: `default`

Response schema example:
```json
{
  "data": [
    {
      "id": "prf_b2caba553ecf8e7df48fd4ef010d",
      "platform": "instagram",
      "handle": "mrbeast",
      "displayName": "MrBeast",
      "bio": "Watch my latest video!! 👇",
      "bioLink": "https://youtu.be/gTKS8SAwUzE?is=ajfROi9qnNjV0jMh",
      "language": null,
      "isPrivate": false,
      "isVerified": true,
      "postsCount": 510,
      "likesCount": null,
      "followersCount": 89341084,
      "followingCount": 1005,
      "profileUrl": "https://www.instagram.com/mrbeast/"
    }
  ],
  "metadata": {
    "pagination": {
      "offset": 0,
      "limit": 1,
      "totalCount": 1
    },
    "requestId": "req_9jI75IySGopgrYah358Mf6YdYE5u",
    "executionTime": 47,
    "timestamp": 1790891518077
  }
}
```

### Search TikTok profiles

- Capability: `tiktok/profiles-search`
- Description: Indexed TikTok profiles. Fields depend on projection: basic identity, default adds bio and account counts, full adds contact and location fields. Includes profileUrl.
- Instructions: Search Oriane's indexed TikTok profiles, bios and follower counts. Platform is fixed to TikTok. Coverage and freshness depend on the existing index; this is not a complete live feed. Results include profileUrl; an empty result does not trigger ingestion. Choose projection: basic 20 credits, default 30 credits, full 40 credits per nonempty call. Search limit is at most 100; URL lookup targets one record. Empty results cost zero.
- Cost: 30 credits per nonempty call
- Capability file: [Search TikTok profiles](https://firecrawl.dev/alexandria/agents/providers/oriane/tiktok/profiles-search)

Accepted options:
- `handle` (string): Account username to match exactly, for example mrbeast. A leading @ is optional; usernames are matched without regard to case. Provide this or another search field; multiple fields must all match. Example: `<handle>`
- `displayName` (string): Text to match in the display name. Provide this or another search field; multiple fields must all match. Example: `<displayName>`
- `bio` (string): Text to match in the bio. Provide this or another search field; multiple fields must all match. Example: `<bio>`
- `limit` (number): Maximum results, default 20. Example: `10`
- `offset` (number): Result offset, default 0. Exact handle searches return at most one profile and require offset 0; paginate displayName or bio searches instead. Example: `10`
- `sort` (string): Comma-separated sort fields with optional :asc or :desc. Profiles: followersCount, createdAt, updatedAt. Posts: viewsCount, likesCount, sharesCount, commentsCount, interactionsCount, engagementRatePerViews, engagementRatePerFollowers, profileFollowersCount, publishedAt, visualSimilarity, transcriptRelevance. Example: `<sort>`
- `projection` (string): Response detail and fixed price per nonempty call: basic 20 credits, default 30 credits, full 40 credits. Empty results cost zero. Result limit does not change the tier price. Example: `default`

Response schema example:
```json
{
  "data": [
    {
      "id": "prf_6ecc76267ab86ae0b3b76390ff6e",
      "platform": "tiktok",
      "handle": "mrbeast",
      "displayName": "MrBeast",
      "bio": "Checkout My New Book!👇",
      "bioLink": "http://themostdangerousgames.com",
      "language": "en",
      "isPrivate": false,
      "isVerified": true,
      "postsCount": 474,
      "likesCount": 1500000000,
      "followersCount": 141200000,
      "followingCount": 355,
      "profileUrl": "https://www.tiktok.com/@mrbeast"
    }
  ],
  "metadata": {
    "pagination": {
      "offset": 0,
      "limit": 1,
      "totalCount": 1
    },
    "requestId": "req_1JH09ZFWLQpm1cFKBUorMwxFR8X4",
    "executionTime": 46,
    "timestamp": 1790891550175
  }
}
```

### Search TikTok videos

- Capability: `tiktok/posts-search`
- Description: Indexed TikTok posts/videos. Fields depend on projection: basic identity, default adds engagement, full adds transcript and richer content fields. Includes profileUrl and postUrl when available.
- Instructions: Search Oriane's indexed TikTok posts, captions and engagement. Platform is fixed to TikTok. Coverage and freshness depend on the existing index; this is not a complete live feed. Results include profileUrl; an empty result does not trigger ingestion. Choose projection: basic 20 credits, default 30 credits, full 40 credits per nonempty call. Search limit is at most 100; URL lookup targets one record. Empty results cost zero.
- Cost: 30 credits per nonempty call
- Capability file: [Search TikTok videos](https://firecrawl.dev/alexandria/agents/providers/oriane/tiktok/posts-search)

Accepted options:
- `handle` (string): Account username to match exactly, for example mrbeast. A leading @ is optional; usernames are matched without regard to case. Provide this or another search field; multiple fields must all match. Example: `<handle>`
- `caption` (string): Text to match in the caption. Provide this or another search field; multiple fields must all match. Example: `<caption>`
- `limit` (number): Maximum results, default 20. Example: `10`
- `offset` (number): Result offset, default 0. Example: `10`
- `sort` (string): Comma-separated sort fields with optional :asc or :desc. Profiles: followersCount, createdAt, updatedAt. Posts: viewsCount, likesCount, sharesCount, commentsCount, interactionsCount, engagementRatePerViews, engagementRatePerFollowers, profileFollowersCount, publishedAt, visualSimilarity, transcriptRelevance. Example: `<sort>`
- `aiSearchAnchor` (string): Anchor from the first visual search page, required for subsequent pages. Example: `<aiSearchAnchor>`
- `projection` (string): Response detail and fixed price per nonempty call: basic 20 credits, default 30 credits, full 40 credits. Empty results cost zero. Result limit does not change the tier price. Example: `default`

Response schema example:
```json
{
  "data": {
    "aggregations": {
      "totalViewsCount": 85931,
      "totalInteractionsCount": 5675
    },
    "results": [
      {
        "id": "cnt_65e518990aaae5a19ece1ee7b7de",
        "matchedQueries": [],
        "platform": "tiktok",
        "profileHandle": "jackroberts____",
        "profileDisplayName": "jackroberts____",
        "format": "video",
        "caption": "Out of the box, Claude is working blind. No web, no browser, no current docs. Firecrawl gives it the open internet. Playwright hands it your actual browser. Context7 pulls the live docs. Same model. Completely different output. #claudecode #mcp #firecrawl #playwright #context7",
        "captionLanguage": "en",
        "thumbnailMediaId": "med_e019d7ae306688c33da646e41aaa",
        "publishedAt": "2026-09-09T15:43:42.000Z",
        "profileId": "prf_101529472b339e84efa2c879150a",
        "thumbnailMediaUrl": "https://oriane-contents.s3.us-east-1.amazonaws.com/tiktok/7683561834221145376/thumbnail.webp",
        "viewsCount": 36100,
        "likesCount": 1458,
        "sharesCount": 327,
        "commentsCount": 2,
        "interactionsCount": 1787,
        "engagementRatePerViews": 4.950138504155125,
        "engagementRatePerFollowers": 3.124125874125874,
        "profileFollowersCount": 57200,
        "profileFollowingCount": 49,
        "profilePostsCount": 276,
        "mediaCount": 1,
        "duration": 38,
        "hashtags": [
          "#claudecode",
          "#mcp",
          "#firecrawl",
          "#playwright",
          "#context7"
        ],
        "coAuthors": [],
        "mentions": [],
        "profileUrl": "https://www.tiktok.com/@jackroberts____",
        "postUrl": null
      },
      {
        "id": "cnt_ef91e04312d803cb5a77333ff4b1",
        "matchedQueries": [],
        "platform": "tiktok",
        "profileHandle": "pil_programacion",
        "profileDisplayName": "píldoras de programacion",
        "format": "video",
        "caption": "Firecrawl la herramienta que facilita el web scraping. #webscraping #claude #firecrawl #webcrawler ",
        "captionLanguage": "es",
        "thumbnailMediaId": null,
        "publishedAt": "2026-07-29T23:32:29.000Z",
        "profileId": "prf_b72e30d49c758b9dbd6f1885efcf",
        "thumbnailMediaUrl": null,
        "viewsCount": 48900,
        "likesCount": 3478,
        "sharesCount": 329,
        "commentsCount": 25,
        "interactionsCount": 3832,
        "engagementRatePerViews": 7.83640081799591,
        "engagementRatePerFollowers": 1.9989567031820552,
        "profileFollowersCount": 191700,
        "profileFollowingCount": 88,
        "profilePostsCount": 604,
        "mediaCount": 1,
        "duration": 28,
        "hashtags": [
          "#webscraping",
          "#claude",
          "#firecrawl",
          "#webcrawler"
        ],
        "coAuthors": [],
        "mentions": [],
        "profileUrl": "https://www.tiktok.com/@pil_programacion",
        "postUrl": null
      },
      {
        "id": "cnt_567ed12423617a0de05ac872307c",
        "matchedQueries": [],
        "platform": "tiktok",
        "profileHandle": "theaiimpact",
        "profileDisplayName": "The AI Impact | No BS Tips",
        "format": "video",
        "caption": "Claude Code gets way more powerful when you connect it to the right tools. Playwright gives Claude a browser so it can click, inspect, test and verify. Firecrawl turns websites into clean data for research, docs and competitor analysis. Perplexity adds live web research with sources. Nano Banana helps create images, mockups and product visuals. Kling AI helps generate UGC-style ads, product demos and short-form video assets. Claude Code + MCP tools + creative AI connectors = a full AI build workflow. Comment HELP and I’ll send the links. #claude #claudecode #claudecodetips #mcps #aitips ",
        "captionLanguage": "en",
        "thumbnailMediaId": "med_7ed6ade2af4d25e14b4e7ccb30e6",
        "publishedAt": "2026-07-09T09:42:36.000Z",
        "profileId": "prf_744b3742c617cf96130d8b007595",
        "thumbnailMediaUrl": "https://oriane-contents.s3.us-east-1.amazonaws.com/tiktok/7660461364036537620/thumbnail.webp",
        "viewsCount": 931,
        "likesCount": 34,
        "sharesCount": 7,
        "commentsCount": 15,
        "interactionsCount": 56,
        "engagementRatePerViews": 6.015037593984962,
        "engagementRatePerFollowers": 0.4274809160305344,
        "profileFollowersCount": 13100,
        "profileFollowingCount": 78,
        "profilePostsCount": 470,
        "mediaCount": 1,
        "duration": 63,
        "hashtags": [
          "#aitips",
          "#claude",
          "#mcps",
          "#claudecodetips",
          "#claudecode"
        ],
        "coAuthors": [],
        "mentions": [],
        "profileUrl": "https://www.tiktok.com/@theaiimpact",
        "postUrl": null
      }
    ]
  },
  "metadata": {
    "pagination": {
      "offset": 0,
      "limit": 5,
      "totalCount": 3
    },
    "requestId": "req_le7qLWeUnSoOOb4EdSbqSzYVFJuR",
    "executionTime": 63,
    "timestamp": 1790891570818
  }
}
```

### Look up TikTok video

- Capability: `tiktok/video-lookup`
- Description: Indexed TikTok posts/videos. Fields depend on projection: basic identity, default adds engagement, full adds transcript and richer content fields. Includes profileUrl and postUrl when available.
- Instructions: Resolve a canonical TikTok post/video URL against Oriane's index. Instagram uses the post shortcode; TikTok uses the numeric video ID. Empty results do not trigger ingestion. Choose projection: basic 20 credits, default 30 credits, full 40 credits per nonempty call. Search limit is at most 100; URL lookup targets one record. Empty results cost zero.
- Cost: 30 credits per nonempty call
- Capability file: [Look up TikTok video](https://firecrawl.dev/alexandria/agents/providers/oriane/tiktok/video-lookup)

Accepted options:
- `url` (string, required): Canonical TikTok /@handle/video/ URL. Short links are unsupported. Example: `<url>`
- `projection` (string): Response detail and fixed price per nonempty call: basic 20 credits, default 30 credits, full 40 credits. Empty results cost zero. Result limit does not change the tier price. Example: `default`

Response schema example:
```json
{
  "data": {
    "aggregations": {
      "totalViewsCount": 36100,
      "totalInteractionsCount": 1787
    },
    "results": [
      {
        "id": "cnt_65e518990aaae5a19ece1ee7b7de",
        "matchedQueries": [],
        "platform": "tiktok",
        "profileHandle": "jackroberts____",
        "profileDisplayName": "jackroberts____",
        "format": "video",
        "caption": "Out of the box, Claude is working blind. No web, no browser, no current docs. Firecrawl gives it the open internet. Playwright hands it your actual browser. Context7 pulls the live docs. Same model. Completely different output. #claudecode #mcp #firecrawl #playwright #context7",
        "captionLanguage": "en",
        "thumbnailMediaId": "med_e019d7ae306688c33da646e41aaa",
        "publishedAt": "2026-09-09T15:43:42.000Z",
        "profileId": "prf_101529472b339e84efa2c879150a",
        "thumbnailMediaUrl": "https://oriane-contents.s3.us-east-1.amazonaws.com/tiktok/7683561834221145376/thumbnail.webp",
        "viewsCount": 36100,
        "likesCount": 1458,
        "sharesCount": 327,
        "commentsCount": 2,
        "interactionsCount": 1787,
        "engagementRatePerViews": 4.950138504155125,
        "engagementRatePerFollowers": 3.124125874125874,
        "profileFollowersCount": 57200,
        "profileFollowingCount": 49,
        "profilePostsCount": 276,
        "mediaCount": 1,
        "duration": 38,
        "hashtags": [
          "#claudecode",
          "#mcp",
          "#firecrawl",
          "#playwright",
          "#context7"
        ],
        "coAuthors": [],
        "mentions": [],
        "profileUrl": "https://www.tiktok.com/@jackroberts____",
        "postUrl": null
      }
    ]
  },
  "metadata": {
    "pagination": {
      "offset": 0,
      "limit": 1,
      "totalCount": 1
    },
    "requestId": "req_bLeiAnP8lGBSmZfGVP1g5f0rrg6R",
    "executionTime": 86,
    "timestamp": 1790891581250
  }
}
```

### Look up TikTok profile

- Capability: `tiktok/profile-lookup`
- Description: Indexed TikTok profiles. Fields depend on projection: basic identity, default adds bio and account counts, full adds contact and location fields. Includes profileUrl.
- Instructions: Pass a canonical TikTok profile URL to look up account details in Oriane's index. Returns profileUrl with each match. Short links and post URLs are unsupported; empty results do not trigger ingestion. Choose projection: basic 20 credits, default 30 credits, full 40 credits per nonempty call. Search limit is at most 100; URL lookup targets one record. Empty results cost zero.
- Cost: 30 credits per nonempty call
- Capability file: [Look up TikTok profile](https://firecrawl.dev/alexandria/agents/providers/oriane/tiktok/profile-lookup)

Accepted options:
- `url` (string, required): Canonical TikTok profile URL. Example: `<url>`
- `projection` (string): Response detail and fixed price per nonempty call: basic 20 credits, default 30 credits, full 40 credits. Empty results cost zero. Result limit does not change the tier price. Example: `default`

Response schema example:
```json
{
  "data": [
    {
      "id": "prf_6ecc76267ab86ae0b3b76390ff6e",
      "platform": "tiktok",
      "handle": "mrbeast",
      "displayName": "MrBeast",
      "bio": "Checkout My New Book!👇",
      "bioLink": "http://themostdangerousgames.com",
      "language": "en",
      "isPrivate": false,
      "isVerified": true,
      "postsCount": 474,
      "likesCount": 1500000000,
      "followersCount": 141200000,
      "followingCount": 355,
      "profileUrl": "https://www.tiktok.com/@mrbeast"
    }
  ],
  "metadata": {
    "pagination": {
      "offset": 0,
      "limit": 1,
      "totalCount": 1
    },
    "requestId": "req_0UNYFLEaAxtpJPRA5FoIQqwtnk6U",
    "executionTime": 43,
    "timestamp": 1790891561842
  }
}
```
