{
  "openapi": "3.0.1",
  "info": {
    "title": "Etimad Award Results — Saudi Tender Winners, Bids & Prices",
    "description": "Who bid, what each bidder offered, who won and for how much, on Saudi government tenders from Etimad. Filter by activity, region, agency, keyword or competitor name (Arabic-safe). $0.03 per award result.",
    "version": "0.1",
    "x-build-id": "bW1UURdhMXeCfZgq0"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/dottti~etimad-awards/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-dottti-etimad-awards",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/dottti~etimad-awards/runs": {
      "post": {
        "operationId": "runs-sync-dottti-etimad-awards",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/dottti~etimad-awards/run-sync": {
      "post": {
        "operationId": "run-sync-dottti-etimad-awards",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "offerDeadlineFrom": {
            "title": "Offer deadline from",
            "type": "string",
            "description": "Only tenders whose offer deadline (آخر موعد لتقديم العروض) falls on or after this date. Format YYYY-MM-DD. Leave empty for 120 days ago. Awards are usually published a few weeks after the deadline."
          },
          "offerDeadlineTo": {
            "title": "Offer deadline to",
            "type": "string",
            "description": "Only tenders whose offer deadline falls on or before this date. Format YYYY-MM-DD. Leave empty for 30 days ago."
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Words to match against tender name, agency, branch and activity. Arabic is matched after normalisation, so alef/hamza, ة/ه and ى/ي spelling variants all match. Leave empty for every tender the other filters allow.",
            "items": {
              "type": "string"
            }
          },
          "matchMode": {
            "title": "Keyword match mode",
            "enum": [
              "any",
              "all"
            ],
            "type": "string",
            "description": "any: keep a tender when at least one keyword matches. all: keep it only when every keyword matches.",
            "default": "any"
          },
          "supplierContains": {
            "title": "Supplier name contains (competitor tracking)",
            "type": "string",
            "description": "Keep only tenders where a bidder or winner name contains this text, for example a competitor's company name. Normalised like keywords. Only matching tenders are billed as award results."
          },
          "agencyContains": {
            "title": "Government agency contains",
            "type": "string",
            "description": "Keep only tenders whose agency or branch name contains this text. Normalised the same way as keywords. Example: أمانة"
          },
          "tenderTypeIds": {
            "title": "Tender types",
            "type": "array",
            "description": "Etimad tender type IDs. Verified against the live feed on 13 September 2026 with the tender counts shown.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "5",
                "6",
                "8"
              ],
              "enumTitles": [
                "1 — منافسة عامة (public competition)",
                "2 — شراء مباشر (direct purchase)",
                "5 — المزايدة العكسية الالكترونية (electronic reverse auction)",
                "6 — المنافسة على مرحلتين (المرحلة الاولى) (two-stage, first stage)",
                "8 — تأهيل لاحق (post-qualification)"
              ]
            }
          },
          "tenderActivityIds": {
            "title": "Business activities",
            "type": "array",
            "description": "Etimad main activity IDs, read from the portal's own نشاط المنافسة lookup. Sub-activity IDs (for example 1919 خدمات الموانئ) are accepted here too. One query is issued per activity.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6",
                "7",
                "8",
                "9",
                "10",
                "11",
                "12",
                "13",
                "14",
                "15",
                "16",
                "17",
                "18",
                "19"
              ],
              "enumTitles": [
                "1 — التجارة",
                "2 — المقاولات",
                "3 — التشغيل والصيانة والنظافة للمنشآت",
                "4 — العقارات والأراضي",
                "5 — الصناعة والتعدين والتدوير",
                "6 — الغاز والمياه والطاقة",
                "7 — المناجم والبترول والمحاجر",
                "8 — الإعلام والنشر والتوزيع",
                "9 — الاتصالات وتقنية المعلومات",
                "10 — الزراعة والصيد",
                "11 — الرعاية الصحية والنقاهة",
                "12 — التعليم والتدريب",
                "13 — التوظيف والاستقدام",
                "14 — الأمن والسلامة",
                "15 — النقل والبريد والتخزين",
                "16 — المهن الاستشارية",
                "17 — السياحة والمطاعم والفنادق وتنظيم المعارض",
                "18 — المالية والتمويل والتأمين",
                "19 — الخدمات الأخرى"
              ]
            }
          },
          "tenderAreaIds": {
            "title": "Regions",
            "type": "array",
            "description": "Saudi administrative regions, as published by Etimad's own منطقة التنفيذ lookup. One query is issued per region.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6",
                "7",
                "8",
                "9",
                "10",
                "11",
                "12",
                "13"
              ],
              "enumTitles": [
                "1 — منطقة الرياض",
                "2 — منطقة مكة المكرمة",
                "3 — منطقة المدينة المنورة",
                "4 — منطقة القصيم",
                "5 — المنطقة الشرقية",
                "6 — منطقة عسير",
                "7 — منطقة تبوك",
                "8 — منطقة حائل",
                "9 — منطقة الحدود الشمالية",
                "10 — منطقة جازان",
                "11 — منطقة نجران",
                "12 — منطقة الباحة",
                "13 — منطقة الجوف"
              ]
            }
          },
          "includeNotAnnounced": {
            "title": "Also list tenders with no results yet",
            "type": "boolean",
            "description": "Add tenders whose award has not been announced, with awardStatus not_announced. These rows are free.",
            "default": false
          },
          "lookUpEveryTender": {
            "title": "Look up every tender, whatever its Etimad status",
            "type": "boolean",
            "description": "Off (default): tenders whose Etimad status shows results are not out yet (for example still open or under evaluation) are skipped without a lookup and are not charged. In tests this saved 15 to 36% of lookups, more on recent dates. A sample of them is still checked, and a status that turns out to have results is looked up in full. Turn on to look up every tender anyway (slower). Always on when 'Also list tenders with no results yet' is on.",
            "default": false
          },
          "maxItems": {
            "title": "Maximum award results",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "Hard cap on delivered award results. You are charged per award result, so this is also your cost cap.",
            "default": 10
          },
          "maxTendersChecked": {
            "title": "Maximum tenders to check",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Each tender needs its own lookup on Etimad. Lookups run in parallel (see Parallel lookups). Each check costs $0.0003. This caps run time and cost when few tenders have results.",
            "default": 3000
          },
          "requestDelayMs": {
            "title": "Delay between requests (ms)",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Pause between requests on each parallel worker (each worker has its own IP). Etimad returns HTTP 429 on bursts. Lower this only if the run is slower than you need and the logs show few 429s.",
            "default": 900
          },
          "maxRetries": {
            "title": "Retries per page",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Retries with exponential backoff when Etimad answers 429 or 5xx.",
            "default": 6
          },
          "concurrency": {
            "title": "Parallel lookups",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many award lookups run at the same time. Each one uses its own proxy IP, so Etimad's per-IP throttling slows one worker only. Needs a proxy; with the proxy off the run uses one worker.",
            "default": 5
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Apify Proxy (automatic datacenter IPs) by default. Each parallel worker gets its own IP and switches to a new one when Etimad throttles it.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}