API de Búsqueda de Yandex

Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Yandex: Búsqueda (yandex/search).

Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en yandex y action en search, y los parámetros dentro de params.
- Parámetros obligatorios:
  - keyword: Palabra clave para buscar negocios en mapas con la acción search o productos con la acción market. Las reseñas de mapas y los productos de comercio electrónico son conjuntos de datos diferentes.
- Parámetros opcionales:
  - category: Categoría del negocio para la acción search en mapas. Usa none para no especificar. Los valores permitidos incluyen restaurants, cafes, coffee_shops, hotels, etc. Consulta la lista completa de valores. (valores admitidos: atms / auto_repair / banks / bars_pubs / beauty_salons / burgers / cafes / car_wash)
  - lang: Idioma para la acción search. Valores: ru (ruso), en (inglés), kk (kazajo), tr (turco), uk (ucraniano). No garantiza que los comentarios se traduzcan a este idioma. (valores admitidos: en / kk / ru / tr / uk)
  - language: Idioma de la interfaz. Por defecto es ru para search y en para reviews. Si envías el parámetro lang en una llamada a search, su valor anulará a este.
  - location: Ciudad para la búsqueda en mapas con la acción search. Por defecto es Moscú. No es el código de región numérico de market.
  - max_price: Condición de precio máximo para la acción correspondiente. Se usa junto con min_price. No se refiere a la puntuación máxima. El filtro usa números enteros: los decimales se redondean hacia arriba (145.98 pasa a 146).
  - min_price: Para la acción market, es el precio mínimo del producto. Para search, es un filtro de rango de precios para negocios en mapas. El significado del precio es diferente en cada caso.
  - sort: Criterio de orden. Para search, usa relevance (relevancia) o distance (distancia). Para market, usa popular (popularidad) o top_rated (mejor puntuación). (valores admitidos: distance / relevance)
  - limit: Número máximo de filas que devuelve esta llamada, un entero de 1 a 100. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. (por defecto: 20)
- Devuelve una lista de registros. Campos principales de cada registro: id, url, name, text, address, city, country, categories, rating, rating_scale, review_count, phone; 16 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=yandex.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "yandex",
  "action": "search",
  "params": {
    "keyword": "музей Санкт-Петербург"
  }
}
- Precio: $1.39 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.

Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.