Discovery

Search public posts

Search the network itself rather than your own posts, so an agent can see what is already being said before it writes. Runs on every connected network that supports searching; the ones that cannot are named in problems. Two limits decide whether a result means anything on Instagram, and neither is a rate limit you can retry past. Instagram has NO keyword search: a multi-word query cannot match a hashtag and comes back as a problems entry rather than an empty list. And Meta caps this at 30 UNIQUE hashtags per account per 7 days, so a scouting run has a weekly budget. sort=recent reads Meta's recent_media edge, which only covers the last 24 hours, so an empty recent result means nothing was posted today rather than that the tag is unused. Instagram results also carry authorHidden: true and can never name their author: Meta strips personally identifiable information from them, so post search cannot be used to find someone to contact.

get/v1/discover/posts

Request

  • Base URL: https://api.postlake.dev
  • URL: https://api.postlake.dev/v1/discover/posts
  • Auth: bearerAuth (a scheme the document does not define)

Query parameters

qstring required

What to search for

mode'keyword' | 'tag'

Search the words (default) or a topic tag

sort'top' | 'recent'

Best match (default) or newest first

mediaType'text' | 'image' | 'video'
authorstring

Only this handle's posts

sincestring date-time
untilstring date-time
accountstring

Search one connection only. Omit to search them all.

cursorstring
limitinteger

1-100

Response

Success

cursorstring nullable

Opaque. Pass it back verbatim; null means the end.

Changes

No recorded changes to this operation across all 1 revision of this API.