OpenAdLibrary

npx add-mcp 'https://mcp.openadlibrary.com/mcp'

Documentação da API e MCP do OpenAdLibrary

Consulte o catálogo público de anúncios programaticamente com os mesmos dados seguros contra vazamentos disponíveis no produto.

Crie e proteja uma chave de API

Crie uma chave em Configurações. Uma chave é exibida apenas uma vez quando é criada, então armazene-a com segurança e revogue-a se ela for exposta.

Autentique requisições

Envie a chave no cabeçalho x-api-key ou como Authorization: Bearer <key>. A mesma chave pode autenticar a API REST e o endpoint MCP hospedado.

API REST

A API pública expõe campos da biblioteca de anúncios seguros contra vazamentos e suporta filtragem e paginação. Ela também publica a cadeia de redirecionamento por trás de um anúncio — a URL do rastreador onde o clique começa, cada salto pelo qual passa e a URL do anunciante onde termina — por meio de /api/v1/ads/{id}/chain, /api/v1/chains/{chainHash} e /api/v1/chains/match. As URLs da cadeia têm credenciais removidas, enquanto parâmetros de atribuição como subid, click_id e utm_* permanecem intactos. A API não expõe dados privados de conta nem identificadores internos. A referência interativa carrega nesta página quando JavaScript está disponível.

Cotas e respostas

Contas gratuitas recebem uma pequena cota diária; contas assinadas recebem a cota completa do plano. Verifique a cota em tempo real exibida ao lado das suas chaves em Configurações. Uma cota de plano esgotada pode retornar 402 Payment Required, enquanto limites de taxa por rajada ou do plano assinado retornam 429 Too Many Requests.

Endpoint MCP hospedado

Conecte um assistente compatível com MCP a https://mcp.openadlibrary.com/mcp e forneça a chave no cabeçalho Authorization. Documentação legível por máquina também está disponível em llms.txt e llms-full.txt.