Pureframe AI API Documentation

Pass collection_id to restrict a search to one collection. This reduces unrelated matches when your account contains different kinds of footage, such as sales calls and product demonstrations.

curl -X POST https://api.pureframe.ai/v1/search \
  -H "Authorization: Bearer pf_..." \
  -F "query=pricing objection" \
  -F "collection_id=col_abc123"

Text queries require collection_id: there’s no whole-library text search. Image queries can omit it to search across every collection in your account.

Discovering collection IDs

curl https://api.pureframe.ai/v1/collections \
  -H "Authorization: Bearer pf_..."

If you’re building an agent integration, list_collections (see MCP Overview) does the same thing as a tool call.

Searching across everything

Omit collection_id entirely on an image search to check your whole account at once: useful for something like scanning every collection for a specific logo or product appearance. See Collections for how videos get organized into collections in the first place.