Datasets API endpoint
Searches public Instagram user profiles stored in a search index. Sort enum: `relevance`, `followers_desc`, `followers_asc`, `crawled_at_desc`, `crawled_at_asc`, `created_at_desc`, `created_at_asc`. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).
/datasets/instagram-users/searchSearches public Instagram user profiles stored in a search index. Profiles are crawled from public web pages without credentials, OAuth, or session cookies.
Dataset id enum:
instagram-usersQuery parameters:
q: optional full-text query over username, full_name, and biography, max 256 characters.username: optional exact username filter (case-insensitive, leading @ stripped), max 128 characters.category_name: optional exact category filter (case-insensitive, e.g. Digital Creator), max 128 characters.source_tier: optional exact filter for seed tier, e.g. crossref, vertical-hashtags, mention-graph, head-directory.is_verified: optional filter for the Instagram verification checkmark.is_business_account: optional filter for business or creator accounts.has_bio: optional filter for a non-empty profile biography.has_external_url: optional filter for a linked external URL.min_followers: optional minimum follower count.max_followers: optional maximum follower count.min_ratio: optional minimum follower-to-following ratio, 0 or greater.max_ratio: optional maximum follower-to-following ratio, 0 or greater.created_after: optional filter for accounts created on or after this date (RFC3339 or YYYY-MM-DD).created_before: optional filter for accounts created on or before this date (RFC3339 or YYYY-MM-DD).crawled_after: optional filter for records last refreshed on or after this date (RFC3339 or YYYY-MM-DD).crawled_before: optional filter for records last refreshed on or before this date (RFC3339 or YYYY-MM-DD).sort: optional sort enum: relevance, followers_desc, followers_asc, crawled_at_desc, crawled_at_asc, created_at_desc, created_at_asc.page: optional page number, defaults to 1.page_size: optional page size, defaults to 20 and maxes at 100.Response behavior:
relevance sort when q is supplied, otherwise followers_desc.min_followers must not exceed max_followers, and min_ratio must not exceed max_ratio.YYYY-MM-DD calendar date.10000; page * page_size must not exceed 10000.1 credit per record returned, minimum 2. A search that returns 20 records costs 20 credits, a full page of 100 costs 100, and an empty or one-record result costs 2. You are charged for what comes back, not for the page_size you ask for, but your balance must cover the requested page_size for the call to be accepted. The response header x-credit-cost shows what a call was charged.
| Field | Filled in, of 1 checked | Values in the sample |
|---|---|---|
| username | 1 | |
| id | 1 | |
| full_name | 1 | |
| biography | 1 | |
| external_url | 1 | youtube.com |
| avatar_url | 1 | scontent-waw2-2.cdninstagram.com |
| is_verified | 1 | true in 1 of 1 |
| is_business_account | 1 | true in 0 of 1 |
| has_bio | 1 | true in 1 of 1 |
| has_external_url | 1 | true in 1 of 1 |
| followers | 1 | 685,848,309 |
| following | 1 | 263 |
| posts | 1 | 8,533 |
| follower_following_ratio | 1 | 2,607,788.25 |
| source_tier | 1 | |
| crawled_at | 1 | 2026-07-24 |
| created_at | 1 | 2026-07-24 |
| schema_version | 1 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | No | Full-text query over username, full_name and biography, max 256 characters | ||
| username | string | No | Exact username filter (case-insensitive), max 128 characters | ||
| category_name | string | No | Exact category filter (case-insensitive, e.g. Digital Creator), max 128 characters | ||
| source_tier | string | No | Exact filter for seed tier (e.g. crossref, vertical-hashtags, mention-graph, head-directory), max 128 characters | ||
| is_verified | boolean | No | Filter by the Instagram verification checkmark | ||
| is_business_account | boolean | No | Filter by business or creator accounts | ||
| has_bio | boolean | No | Filter by a non-empty profile biography | ||
| has_external_url | boolean | No | Filter by a linked external URL | ||
| min_followers | integer | No | Minimum follower count | ||
| max_followers | integer | No | Maximum follower count | ||
| min_ratio | number | No | Minimum follower-to-following ratio | ||
| max_ratio | number | No | Maximum follower-to-following ratio | ||
| created_after | string | No | Accounts created on or after this date (RFC3339 or YYYY-MM-DD) | ||
| created_before | string | No | Accounts created on or before this date (RFC3339 or YYYY-MM-DD) | ||
| crawled_after | string | No | Records last refreshed on or after this date (RFC3339 or YYYY-MM-DD) | ||
| crawled_before | string | No | Records last refreshed on or before this date (RFC3339 or YYYY-MM-DD) | ||
| sort | string | No | Sort enum: relevance, followers_desc, followers_asc, crawled_at_desc, crawled_at_asc, created_at_desc, created_at_asc Allowed values: relevance, followers_desc, followers_asc, crawled_at_desc, crawled_at_asc, created_at_desc, created_at_asc. | ||
| page | integer | No | 1 | Page number, defaults to 1 | |
| page_size | integer | No | 20 and maxes at 100 | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/datasets/instagram-users/search?q=coffee&is_verified=true&is_business_account=true&has_bio=true&has_external_url=true&sort=relevance&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "instagram-users",
"items": [
{
"username": "instagram",
"id": "25025320",
"full_name": "Instagram",
"biography": "Discovering creators and stories around the world.",
"external_url": "https://about.instagram.com",
"avatar_url": "https://scontent.cdninstagram.com/avatar.jpg",
"is_verified": true,
"is_business_account": true,
"category_name": "Product/Service",
"has_bio": true,
"has_external_url": true,
"followers": 670000000,
"following": 80,
"posts": 7500,
"follower_following_ratio": 8375000,
"source_tier": "head-directory",
"crawled_at": "2026-07-23T10:00:00Z",
"schema_version": 1
}
],
"page": 1,
"page_size": 20,
"total": 1,
"sort": "followers_desc"
}
}Request schema
No body schema
Response schema
#/definitions/datasets.instagramUsersSearchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | datasets.InstagramUserSearchResponse | No | ||||
| data.dataset | string | No | ||||
| data.items | array | No | ||||
| data.items[].avatar_url | string | No | ||||
| data.items[].biography | string | No | ||||
| data.items[].category_name | string | No | ||||
| data.items[].crawled_at | string | No | ||||
| data.items[].created_at | string | No | ||||
| data.items[].external_url | string | No | ||||
| data.items[].follower_following_ratio | number | No | ||||
| data.items[].followers | integer | No | ||||
| data.items[].following | integer | No | ||||
| data.items[].full_name | string | No | ||||
| data.items[].has_bio | boolean | No | ||||
| data.items[].has_external_url | boolean | No | ||||
| data.items[].id | string | No | ||||
| data.items[].is_business_account | boolean | No | ||||
| data.items[].is_verified | boolean | No | ||||
| data.items[].posts | integer | No | ||||
| data.items[].schema_version | integer | No | ||||
| data.items[].source_tier | string | No | ||||
| data.items[].username | string | No | ||||
| data.page | integer | No | ||||
| data.page_size | integer | No | ||||
| data.sort | string | No | ||||
| data.total | integer | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/datasets/instagram-users/search?q=coffee&is_verified=true&is_business_account=true&has_bio=true&has_external_url=true&sort=relevance&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"