Marcas y seguimiento de marcas

Esto complementa el Referencia de la API. GET /api/v1/marcas es el API-key tracked-brands list (metered credits). Detail tabs and deep brand analytics use /api/marcas/* in the browser while you are logged in.

Nota sobre la ruta: Tracked brands over an API key: solo GET /api/v1/marcas. GET /api/brands es el panel de control list for the logged-in session (same underlying data, not the metered JSON route for keys). Biblioteca de anuncios de Meta (GET /api/v1/adlibrary) is documented in Biblioteca de anuncios de Meta.

MCP tool (Brand tracker)#

• marcas_seguidas — same data as GET /api/v1/marcas (optional buscar, clasificar, board_id).

Configuración: MCP. Parámetros: MCP · Referencia de herramientas. Para buscar_anuncios_en_Facebook, véase Biblioteca de anuncios de Meta.

Autenticación y medición compartidas (/api/v1/adlibrary, /api/v1/marcas)#

GET /api/v1/marcas uses the same auth and metering path as /api/v1/adlibrary. Full parameter context for the ad library route lives in Biblioteca de anuncios de Meta.

• Clave API: Clave X-API, Autorización: al portador, o ?api_key= (véase Referencia de la API).
• Sesión: Si el visitante ya ha iniciado sesión, las mismas rutas pueden ejecutarse sin clave; no obstante, el usuario activo debe cumplir con la comprobación de acceso a la API que se indica a continuación.
• Plan: La cuenta debe incluir Acceso a la API. De lo contrario 403.
• Créditos / límite de velocidad: Créditos mensuales de API y 60 solicitudes por minuto por usuario. Una vez agotado, 429 con un error JSON y opcional créditos objeto.

Cuando utilizas una clave API sin una sesión de navegador activa, el servidor sigue asociando la clave a tu cuenta para esa solicitud, de modo que el comportamiento coincide con el del panel de control.

GET /api/v1/marcas — Tracked brands list (API key)#

Returns the same tracked-brands list you see in the app’s Brand tracker, scoped to the API key owner.

Query parameters#

Response#

JSON array of brand rows (not wrapped in { success, data }). Each item includes fields such as id (Facebook page id), nombre, logo_url, added_at, page_url, status, total_ads, active_ads_on_page, formats, new_ads_count, new_ads_change, and related summary fields (same shape as the in-app list).

Brand details (GET /api/brands/*) — session / logged-in#

These routes require a logged-in browser session (except GET /api/brands/shared-board, which uses a token). They are no the metered API-key list — that is GET /api/v1/marcas only. Automating detail tabs means driving the app with session cookies, not the API key alone.

Brand identifier: Almost all detail endpoints take id = Facebook page_id (same as id in the brands list).

Track / untrack brands (session)#

Yes — you can both track and remove brands in the Brand tracker, using session-authenticated routes:

Track a brand#

POST /api/brands/follow

JSON body:

{ "url": "https://www.facebook.com/ads/library/?view_all_page_id=108897621643793" }

Notas:

• Requires a logged-in session and plan capacity.
• Devoluciones éxito, además de brand, has_data, y details_url when accepted.

Remove a tracked brand#

POST /api/brands/unfollow

JSON body:

{ "page_id": "108897621643793" }

Notas:

• Removes the brand from your tracker.
• Also removes that brand from your boards for the current user.
• Devoluciones éxito, amount, y max_allowed.

Count tracked brands#

GET /api/brands/amount-tracked returns:

• amount - number of brands currently tracked by the logged-in user.
• max_allowed - plan cap for Brand tracker.

Date range filter (many detail tabs)#

Query parameters map as follows:

Used directly by GET /api/brands/ads. The same filter applies to other brand insight tabs (ad copies, headlines, hooks, personas, themes, …): pass the same fecha_rango / fecha_de_inicio / fecha_hasta query params on those endpoints.

Example: paginated ads for one brand#

GET /api/brands/ads?id={page_id}&page={n}

• página: 0-based page index (12 ads per page).
• Optional date filter: fecha_rango, fecha_de_inicio, fecha_hasta as above.
• Response: JSON array of processed ad objects.

Other detail endpoints — common query parameters#

Brand-related routes are also summarized in the API reference.