PeekPanda markpeekpandaDocumentation
For your AI
Copy pageCopy entire docs
Dashboard

Search organic content

Search the copied public organic corpus with bounded filters.

Download Markdown ↓

GEThttps://api.peekpanda.com/v1/organic

Request

Send filters as query parameters. This read serves stored corpus rows and does not scrape TikTok.

Parameters

NameInTypeRequiredDescription
qquerystring, 1–200NoFree-text search.
categoryqueryHealth & Wellness | Personal Development | Relationships & Lifestyle | Arts, Hobbies & Entertainment | Education & Knowledge | Fashion & Beauty | Spirituality & Beliefs | Business & Finance | Travel | Food & Cooking | Home & Design | Fitness | Technology | Gaming & Esports | Productivity & OrganizationNoExact organic corpus category.
business_typequeryapp | ecommerce | saas | service | affiliate | other | creator | game | book | unclassifiedNoExact business-type filter.
platformquerytiktok | instagram | threadsNoOrganic platform filter.
content_typequeryslideshow | video | mixedNoContent-type filter.
accountquerystring, 1–200NoCreator account filter.
productquerystring, 1–200NoExact product-name filter.
store_idsquerycomma-separated numeric App Store ids, 1–100NoPosts PeekPanda tied to any of these apps, such as every app on a board.
max_slidesqueryinteger, 1–100NoMaximum slide count.
adqueryads | likely_or_ads | not_adsNoTikTok paid reach: posts TikTok served as ads, also likely ads (Spark Ads authorized or paid-reach engagement), or neither. Unchecked posts count as not ads.
creator_sponsoredquerybooleanNotrue for posts a brand paid a creator to make, false to hide them. Unchecked posts count as not sponsored.
languagequerycomma-separated ISO 639-1 codesNoPosts in any of these languages, such as en,es. mul is bilingual, zxx has no spoken or written words, und is undetermined.
published_sincequerydate, YYYY-MM-DDNoInclusive calendar start date.
published_untilquerydate, YYYY-MM-DDNoInclusive calendar end date; must be at or after published_since.
sortqueryrelevance | newest | latest_posted | most_views | most_likes | most_comments | most_slidesNoDefaults to relevance when q is set and newest otherwise.
limitqueryinteger, 1–40NoPage size; defaults to 12. offset + limit cannot exceed 1000.
offsetqueryinteger, 0–960NoResult offset; defaults to 0.

Response

posts is a page of organic corpus rows. product_app is null when no catalogue app was matched; product_app.matchedBy = product_name means a conservative inferred association, not verified ownership. slide_texts is null on list results. relevance is always null. next_offset is null on the last page or when the offset cap is reached.

Response fields

posts[].idstring
posts[].platformstring
posts[].content_typestring
posts[].linkstring
posts[].categorystring
posts[].business_typestring
posts[].product_namestring
posts[].product_websitestring
posts[].product_app.platformstring
posts[].product_app.storeIdstring
posts[].product_app.appNamestring
posts[].product_app.iconUrlstring
posts[].product_app.matchedBystring
posts[].accountstring
posts[].captionstring
posts[].hashtags[]string[]
posts[].date_publishedstring
posts[].metrics.viewsnumber
posts[].metrics.likesnumber
posts[].metrics.commentsnumber
posts[].metrics.sharesnumber
posts[].metrics.bookmarksnumber
posts[].slide_countnumber
posts[].preview_image_urlstring
posts[].image_urls[]string[]
posts[].video_urlnull
posts[].hook_textstring
posts[].hook_analysis.content_classstring
posts[].hook_analysis.format_templatestring
posts[].hook_analysis.psychology_tags[]string[]
posts[].search_summarystring
posts[].nichestring
posts[].topics[]string[]
posts[].search_keywords[]string[]
posts[].ad_signalnull
posts[].creator_sponsoredboolean
posts[].languagestring
posts[].slide_textsnull
posts[].relevancenull
totalnumber
has_moreboolean
next_offsetnull

Authentication

Requires Bearer API credential or OAuth access token. Scope context:read. MCP calls search_organic with action search.

Errors

400invalid_request for an invalid filter, identity or limit.
401authentication_required for a missing or invalid credential.
402subscription_required when access is not entitled.
403authorization_required for a missing scope or unavailable preview access.
403workspace_not_accessible when x-genviral-tenancy names a workspace the credential cannot reach.
404not_found when the record is outside the accessible catalogue.
429rate_limited; honor Retry-After when present.
429daily_call_limit; the plan's daily API and MCP calls are used until 00:00 UTC.

MCP request

Call search_organic with action search. Path fields go in params, filters in query, and a write body in body.

{
  "name": "search_organic",
  "arguments": {
    "request": {
      "action": "search"
    }
  }
}

Source

Stored public organic content with its original source identity and observation date.

Refresh

This read returns stored content and does not begin collection.

AI agent or LLM? Read this page as markdown