Expressões regulares

snipexp: é o único operador que não muda quais sites são encontrados: ele muda o que é exibido para cada um deles. É assim que uma lista de sites vira uma lista de IDs de editor, números de telefone ou nomes de plugins.

Em vez do texto ao redor da correspondência, o trecho passa a ser o que a sua expressão capturar.

A expressão é um padrão PCRE com delimitadores, geralmente |, já que uma consulta raramente contém esse caractere, e com pelo menos um grupo de captura, porque o que o grupo captura é o que você recebe. Os flags vêm depois do delimitador de fechamento, então i torna a expressão insensível a maiúsculas e minúsculas. Sem grupo de captura, o trecho volta vazio, que é o motivo mais comum de uma coluna em branco.

snipexp:|pubid=(ra\-[\w\d]+)|i

Os trechos são o que as exportações csvsnippets trazem e o que snippets=1 retorna na API. Para extrair um campo de um conjunto inteiro de sites de uma só vez, existem os clusters. Os trechos consomem uma cota diária separada; veja cotas e limite de requisições.