Search Global Ad Library
Search global, source-scoped ad-library rows without brand context.
Keyword mode (q + filters) is the default and is open to anyone. When
brand_intel_ad_embeddings_enabled is on, semantic=<text> (meaning-based
search) or similar_to_ad_id=<uuid> (“more like this”) switch to the
pgvector + Cohere-rerank path; when the flag is off those params are ignored.
Those two params are plan-gated (semantic_ad_search, Starter and above)
via _authorized_semantic_params — which drops them for anonymous callers
rather than refusing the request. See its docstring for why the three
outcomes differ.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
1 - 2001 - 801 - 2001 - 401 - 1201 - 2551 - 24001 - 2551 - 2552 - 10002 - 10001 - 2001 - 2001 - 2001 - 10001 - 10001 - 4001 - 6001 - 2001 - 4001 <= x <= 100x >= 1x >= 01 - 512Response
Successful Response