> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creatordb.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Search Content
> Search for Instagram content (image posts, reels) across all creators in the CreatorDB database using content-level and creator-level filters. Enables discovery of specific content by performance metrics, hashtags, sponsorship status, and more. By default, the `contentList` is sorted by `publishTime` descending (newest first). Custom sorting can be applied using the `sortBy` parameter.
## OpenAPI
````yaml /api-v3/api-v3.yaml post /instagram/content-search
openapi: 3.1.0
info:
version: 1.0.0
title: CreatorDB Headless API V3
description: '# CreatorDB Headless API V3'
contact:
name: CreatorDB
url: https://www.creatordb.app
email: support@creatordb.app
license:
url: http://www.apache.org/licenses/LICENSE-2.0.html
name: Apache 2.0
servers:
- url: https://apiv3.creatordb.app
description: Production Environment (CreatorDB Headless API V3)
security:
- ApiKeyAuth: []
tags:
- name: Brand
description: Brand analysis endpoints including sponsor search and brand reports.
- name: Facebook
description: Facebook creator data endpoints with metrics and search capabilities.
- name: General Operations
description: >-
General-purpose endpoints such as API status, content retrieval, and
cross-platform operations.
- name: Instagram
description: >-
Instagram creator data endpoints with metrics and advanced search
capabilities.
- name: Niches
description: >-
Niche-related endpoints for content category analysis and related
searches.
- name: Threads
description: Threads creator data endpoints with basic metrics and historical data.
- name: TikTok
description: >-
TikTok creator data endpoints with metrics and advanced search
functionality.
- name: Topic
description: Topic-based analysis and reporting endpoints for content categorization.
- name: YouTube
description: >-
YouTube creator data endpoints including basic metrics, historical data,
and detailed analytics.
paths:
/instagram/content-search:
post:
tags:
- Instagram
summary: Search Content
description: >-
Search for Instagram content (image posts, reels) across all creators in
the CreatorDB database using content-level and creator-level filters.
Enables discovery of specific content by performance metrics, hashtags,
sponsorship status, and more. By default, the `contentList` is sorted by
`publishTime` descending (newest first). Custom sorting can be applied
using the `sortBy` parameter.
operationId: searchInstagramContent
requestBody:
content:
application/json:
schema:
type: object
properties:
filters:
type: array
items:
type: object
properties:
filterName:
type: string
description: The field to apply the filter on.
op:
type: string
enum:
- in
- '>'
- '='
- <
description: >-
The comparison operator. Available values include
`in`, `>`, `=`, `<`.
- String fields accept:
`=`, `in`.
- Number fields support: `>`, `=`,
`<`.
- Boolean fields support: `=`
value:
description: >-
Type depends on the `filterName`.
- String
fields accept `string` or `string[]`.
- Number
fields accept `number`.
- Boolean fields accept
`boolean`.
- Operator `in` accepts `string[]`,
operator `=` accepts string for `string` fields.
anyOf:
- type: string
- type: number
- type: array
maxItems: 100
items:
type: string
- type: boolean
isFuzzySearch:
type: boolean
description: >-
When `true`, performs a fuzzy match for `string` type
`filterName`.
default: false
required:
- filterName
- op
- value
minItems: 1
maxItems: 10
description: >-
Filter objects that include `filterName`, `op`, and `value`.
For all accepted `filterName` values and their data types,
see [Configuring Custom Search Filters and
Examples](https://docs.creatordb.app/api-v3/configuring_advanced_search_filters#available-filtername-&-sortby).
desc:
type: boolean
description: >-
Sort order for results. `true` for descending, `false` for
ascending order.
sortBy:
type: string
description: >-
Field to sort content by. For example, `likes` sorts by like
count.
pageSize:
type: integer
description: 'Number of results per page. Maximum: 100.'
minimum: 1
maximum: 100
offset:
type: integer
description: Number of records to skip before returning results.
minimum: 0
required:
- filters
- pageSize
- offset
description: >-
Request body for searching Instagram content across all creators
using content-level and creator-level filters.
example:
filters:
- filterName: hashtag
op: '='
value: '#skincare'
- filterName: postType
op: '='
value: reel
- filterName: likes
op: '>'
value: 5000
- filterName: publishTime
op: <
value: 7
sortBy: likes
desc: true
pageSize: 20
offset: 0
responses:
'200':
description: Instagram content search data returned successfully.
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
contentList:
type: array
items:
type: object
properties:
contentId:
type: string
description: >-
The unique content ID.
- Image post URL:
`https://www.instagram.com/p/{contentId}`
Reel URL:
`https://www.instagram.com/reel/{contentId}`
example: DMCkc5CyZdf
contentType:
type:
- string
- 'null'
description: >-
Content type: `reel`, `slideshow`, or `video`.
May be `null` for legacy posts that predate
`postType` classification.
example: reel
description:
type: string
description: The content caption.
example: |-
突然覺得這輩子一定要好好賺錢
以後都搭商務艙😭😭😭
thumbnail:
type: string
description: Thumbnail or cover image URL of the content.
example: >-
https://www.instagram.com/p/DMCkc5CyZdf/media/?size=l
url:
type: string
description: Direct URL of the content.
example: https://www.instagram.com/reel/DMCkc5CyZdf
publishTime:
type: integer
minimum: 0
description: >-
Publish time, represented as a Unix timestamp in
milliseconds.
example: 1752392905000
isSponsored:
type: boolean
description: '`true` if sponsored.'
example: true
partneredBrands:
type: array
items:
type: string
description: >-
Brand IDs (returned as domains) associated with
the sponsored content. Empty if the content is
not sponsored.
example:
- acer.com
likes:
type: integer
minimum: 0
description: Number of likes.
example: 15840
comments:
type: integer
minimum: 0
description: Number of comments.
example: 121
engagementRate:
type: number
description: >-
Engagement rate, rounded to 4th decimal place.
*Engagement Rate =(Likes + Comments)
/ Followers*
example: 0.1201
hashtags:
type: array
items:
type: string
description: Keywords in the content caption.
example:
- '#skincare'
- '#routine'
creator:
type: object
properties:
uniqueId:
type: string
description: Account handle.
example: goodalicia
displayName:
type: string
description: Account display name.
example: 愛莉莎莎 Alisasa 🐨
avatarUrl:
type: string
description: Account profile picture URL.
example: https://instagram.ftpe8-4.fna.fbcdn.net/...
totalFollowers:
type: integer
minimum: 0
description: Total number of followers.
example: 613344
required:
- uniqueId
- displayName
- avatarUrl
- totalFollowers
description: Creator information for the content.
required:
- contentId
- contentType
- description
- thumbnail
- url
- publishTime
- isSponsored
- partneredBrands
- likes
- comments
- engagementRate
- hashtags
- creator
description: A content item with creator and performance details.
description: Content items matching the search filters.
totalResults:
type: integer
minimum: 0
description: >-
Total number of content items matching the search
filters.
example: 850
hasNextPage:
type: boolean
description: '`true` if there is a next page of results.'
example: true
nextOffset:
type: integer
minimum: 0
description: >-
The offset value for retrieving the next page of
results.
example: 20
required:
- contentList
- totalResults
- hasNextPage
- nextOffset
description: Content search results with pagination details.
traceId:
type: string
description: Unique trace ID for each request.
example: f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0
timestamp:
type: integer
description: >-
Time the response was generated, represented as a Unix
timestamp in milliseconds.
example: 1750732453635
creditsAvailable:
type: number
description: Number of API credits remaining.
example: 975
creditsUsed:
type: number
description: Number of credits consumed by this request.
example: 25
errorCode:
type: string
description: >-
Error code returned if the request fails. Empty if the
request succeeds.
example: ''
errorDescription:
type: string
description: Description of the error if any. Empty if successful.
example: ''
success:
type: boolean
description: '`true` if the request is successful.'
example: true
required:
- data
- traceId
- timestamp
- creditsAvailable
- creditsUsed
- errorCode
- errorDescription
- success
description: >-
Response body for content search results. The content list and
pagination details are returned in `data`.
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
description: The valid CreatorDB API key for authentication.
name: api-key
in: header
````