{"openapi":"3.1.0","info":{"title":"semrush-bridge API","description":"Замеры Semrush (Keyword Magic, Bulk Keyword Overview) для агентов. Авторизация: `Authorization: Bearer sbk_…`. Подробная инструкция для агента — [/docs/agent](https://semrush.patrik-dreams-42.duckdns.org/docs/agent).","version":"0.1.0"},"paths":{"/v1/me":{"get":{"tags":["api"],"summary":"Кто я: владелец токена и расход","operationId":"me_v1_me_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/status":{"get":{"tags":["api"],"summary":"Жива ли сессия Semrush и занят ли браузер","operationId":"status_v1_status_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/keyword-magic":{"post":{"tags":["api"],"summary":"Keyword Magic: сводка кластера, головы по объёму, потолок по CPC","operationId":"keyword_magic_v1_keyword_magic_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MagicIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bulk":{"post":{"tags":["api"],"summary":"Bulk Keyword Overview: до 100 фраз одним замером","operationId":"bulk_v1_bulk_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"BulkIn":{"properties":{"keywords":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"Keywords","description":"До 100 фраз."},"db":{"type":"string","pattern":"^[a-z]{2}(-[a-z]{2})?$","title":"Db","default":"us"},"fresh":{"type":"boolean","title":"Fresh","default":false},"fold_diacritics":{"type":"boolean","title":"Fold Diacritics","description":"Добавить к каждой фразе с диакритикой её форму без диакритики и вернуть пары (Semrush хранит их как разные ключи с разными объёмами).","default":false}},"type":"object","required":["keywords"],"title":"BulkIn"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"MagicIn":{"properties":{"q":{"type":"string","maxLength":120,"minLength":1,"title":"Q","description":"Ядро (seed). Phrase match, как в Keyword Magic `mode=1`."},"db":{"type":"string","pattern":"^[a-z]{2}(-[a-z]{2})?$","title":"Db","description":"База Semrush = гео: br, pt, it, pl, us, uk, ae…","default":"us"},"limit":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","description":"Сколько строк вернуть в каждом срезе (by_volume, by_cpc).","default":20},"fresh":{"type":"boolean","title":"Fresh","description":"true — не брать из кэша, снять заново.","default":false}},"type":"object","required":["q"],"title":"MagicIn"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}