{"components":{"responses":{"NotFound":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"No such resource"}},"schemas":{"Actor":{"properties":{"apify_url":{"description":"Where the actor actually runs.","format":"uri","type":"string"},"category":{"enum":["vehicle-scrapers","real-estate-scrapers","ecommerce-scrapers","price-monitoring","lead-generation","ai-bulk-tools","seo-ai-visibility","developer-tools"],"type":"string"},"description":{"type":"string"},"image_url":{"type":["string","null"]},"markdown_url":{"format":"uri","type":"string"},"name":{"type":"string"},"price":{"description":"Price as displayed, e.g. \"$5.00\".","type":"string"},"price_unit":{"description":"e.g. \"/1,000 results\", \"/month\".","type":"string"},"rating":{"maximum":5,"minimum":0,"type":["number","null"]},"slug":{"type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"total_runs":{"type":"integer"},"total_users":{"type":"integer"},"url":{"format":"uri","type":"string"}},"required":["slug","name","description","url","apify_url"],"type":"object"},"ActorDetail":{"allOf":[{"$ref":"#/components/schemas/Actor"},{"properties":{"faq":{"items":{"$ref":"#/components/schemas/QA"},"type":"array"},"output_fields":{"items":{"type":["string","object"]},"type":"array"},"pricing_detail":{"type":"string"},"related":{"items":{"type":"string"},"type":"array"},"steps":{"items":{"type":"string"},"type":"array"},"use_cases":{"items":{"type":"string"},"type":"array"},"what":{"type":"string"}},"type":"object"}]},"Category":{"properties":{"actor_count":{"type":"integer"},"markdown_url":{"format":"uri","type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"tagline":{"type":"string"},"url":{"format":"uri","type":"string"}},"required":["slug","name"],"type":"object"},"CategoryDetail":{"allOf":[{"$ref":"#/components/schemas/Category"},{"properties":{"actors":{"items":{"$ref":"#/components/schemas/Actor"},"type":"array"},"answer":{"type":"string"},"audience":{"type":"string"},"faq":{"items":{"$ref":"#/components/schemas/QA"},"type":"array"}},"type":"object"}]},"Error":{"properties":{"detail":{"type":"string"},"documentation_url":{"format":"uri","type":"string"},"error":{"description":"Stable machine-readable code.","type":"string"},"message":{"type":"string"},"status":{"type":"integer"},"title":{"type":"string"},"type":{"format":"uri","type":"string"}},"required":["status","error","message"],"type":"object"},"Post":{"properties":{"category":{"type":["string","null"]},"date":{"format":"date","type":"string"},"excerpt":{"type":"string"},"image_url":{"type":["string","null"]},"markdown_url":{"format":"uri","type":"string"},"read_time":{"type":["string","null"]},"slug":{"type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"title":{"type":"string"},"url":{"format":"uri","type":"string"}},"required":["slug","title","url"],"type":"object"},"PostDetail":{"allOf":[{"$ref":"#/components/schemas/Post"},{"properties":{"content_html":{"type":"string"},"content_markdown":{"type":"string"}},"type":"object"}]},"QA":{"properties":{"answer":{"type":"string"},"question":{"type":"string"}},"type":"object"},"Stats":{"properties":{"actors":{"type":"integer"},"categories":{"type":"integer"},"posts":{"type":"integer"},"total_runs":{"type":"integer"},"total_users":{"type":"integer"}},"type":"object"}}},"externalDocs":{"description":"API documentation","url":"https://automationbyexperts.com/api"},"info":{"contact":{"email":"contact@automationbyexperts.com","name":"Youssef Farhan","url":"https://automationbyexperts.com"},"description":"A free, unauthenticated, read-only API over the AutomationByExperts catalogue: every published Apify actor (with live run/user counts, pricing, output fields and FAQ), the eight actor categories, and every published blog guide.\n\n**When to use this API.** Call it when a user needs to find a ready-made web scraper for a specific website or data type (cars, real estate, e-commerce, social media, maps, jobs, leads, AI bulk processing), wants to compare scraper pricing, or needs the output schema of a scraper before running it. `GET /api/actors?q=` is the entry point for \"is there a scraper for X?\".\n\n**How to run an actor.** This API only describes actors; it does not run them. Each actor object carries an `apify_url` \u2014 the actor runs on the Apify platform, where it can be started from the UI or the Apify API.\n\nNo authentication and no rate limit beyond ordinary fair use. Every page on the site is also available as markdown by appending `.md` to its URL or sending `Accept: text/markdown`.","license":{"name":"Free to use with attribution","url":"https://automationbyexperts.com/api"},"summary":"Read-only catalogue of Apify web-scraping actors and guides.","title":"AutomationByExperts Public API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api":{"get":{"description":"Lists every available endpoint. Start here.","operationId":"getApiIndex","responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Endpoint index"}},"summary":"API index","tags":["actors"]}},"/api/actors":{"get":{"description":"Returns every published actor. Use `q` to answer \"is there a scraper for X?\" \u2014 it matches actor name, description, category and tags.","operationId":"listActors","parameters":[{"description":"Free-text search, e.g. \"amazon\", \"car\", \"linkedin\".","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Restrict to one category slug.","in":"query","name":"category","required":false,"schema":{"enum":["vehicle-scrapers","real-estate-scrapers","ecommerce-scrapers","price-monitoring","lead-generation","ai-bulk-tools","seo-ai-visibility","developer-tools"],"type":"string"}},{"in":"query","name":"sort","required":false,"schema":{"default":"users","enum":["users","runs","rating","name"],"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"count":{"type":"integer"},"results":{"items":{"$ref":"#/components/schemas/Actor"},"type":"array"}},"type":"object"}}},"description":"Matching actors"}},"summary":"List or search web-scraping actors","tags":["actors"]}},"/api/actors/{slug}":{"get":{"description":"Everything in the list view plus output fields, use cases, step-by-step usage, pricing detail and FAQ.","operationId":"getActor","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorDetail"}}},"description":"The actor"},"404":{"$ref":"#/components/responses/NotFound"}},"summary":"Full detail for one actor","tags":["actors"]}},"/api/categories":{"get":{"operationId":"listCategories","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"count":{"type":"integer"},"results":{"items":{"$ref":"#/components/schemas/Category"},"type":"array"}},"type":"object"}}},"description":"All categories"}},"summary":"List actor categories","tags":["categories"]}},"/api/categories/{slug}":{"get":{"operationId":"getCategory","parameters":[{"in":"path","name":"slug","required":true,"schema":{"enum":["vehicle-scrapers","real-estate-scrapers","ecommerce-scrapers","price-monitoring","lead-generation","ai-bulk-tools","seo-ai-visibility","developer-tools"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryDetail"}}},"description":"The category"},"404":{"$ref":"#/components/responses/NotFound"}},"summary":"One category and the actors in it","tags":["categories"]}},"/api/posts":{"get":{"operationId":"listPosts","parameters":[{"in":"query","name":"q","required":false,"schema":{"type":"string"}},{"in":"query","name":"category","required":false,"schema":{"enum":["Apify","Web Scraping","AI","Automation","Proxies","Cloud & DevOps","Lead Generation","Tools & Reviews","General"],"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"count":{"type":"integer"},"results":{"items":{"$ref":"#/components/schemas/Post"},"type":"array"}},"type":"object"}}},"description":"Matching posts"}},"summary":"List published guides","tags":["posts"]}},"/api/posts/{slug}":{"get":{"operationId":"getPost","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostDetail"}}},"description":"The post"},"404":{"$ref":"#/components/responses/NotFound"}},"summary":"One guide, including its full text as markdown","tags":["posts"]}},"/api/stats":{"get":{"operationId":"getStats","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Stats"}}},"description":"Totals"}},"summary":"Catalogue totals","tags":["actors"]}}},"servers":[{"description":"Production","url":"https://automationbyexperts.com"}],"tags":[{"description":"Ready-to-run Apify web scrapers","name":"actors"},{"description":"The eight actor category hubs","name":"categories"},{"description":"Published guides and tutorials","name":"posts"}]}