Overview

This API provides bulk tender data. Results are returned in pages using cursor-based pagination. Use the examples below to fetch a single page or loop through all available pages while respecting the rate limit.

Authentication

All requests require an API key sent in the X-API-KEY header (or as a Bearer token in some clients).

X-API-KEY: 7a2b9c4d8e5f6a1b2c3d4e5f6

Pagination

The API uses cursor-based pagination.

  • First pull: Do not send a cursor parameter.
  • Response: Always includes a cursor string and a data array.
  • Next page: Pass the returned cursor as a query parameter.
  • Stop: When data is empty or cursor is null/missing, there are no more pages.
https://api.bidsinfo.com/bulk-data-fetch.php?endpoint=data&cursor=WyIyMDI2LTA4LTA2IDE2OjQ5OjA0IiwiMzY4ODQyODgiXQ==

Rate Limit

Maximum 5 requests per minute

When looping through pages, wait approximately 12 seconds between requests to stay within the limit. Exceeding the limit may result in temporary blocking or error responses.

Endpoint

GET https://api.bidsinfo.com/bulk-data-fetch.php?endpoint=data

Query Parameters

Parameter Type Required Description
endpoint string Yes Must be data
cursor string No Pagination cursor from previous response. Omit on first request.

cURL

Single-page requests.

# First pull (no cursor)
curl -X GET "https://api.bidsinfo.com/bulk-data-fetch.php?endpoint=data" \
  -H "Authorization: Bearer 7a2b9c4d8e5f6a1b2c3d4e5f6"

# Next page
curl -X GET "https://api.bidsinfo.com/bulk-data-fetch.php?endpoint=data&cursor=WyIyMDI2LTA4LTA2IDE2OjQ5OjA0IiwiMzY4ODQyODgiXQ==" \
  -H "Authorization: Bearer 7a2b9c4d8e5f6a1b2c3d4e5f6"

# Save to file
curl -X GET "https://api.bidsinfo.com/bulk-data-fetch.php?endpoint=data" \
  -H "Authorization: Bearer 7a2b9c4d8e5f6a1b2c3d4e5f6" \
  -o output.json

PHP – Loop all pages

Fetches every page, respects the 5 req/min rate limit, and collects all records.

$base_url = "https://api.bidsinfo.com/bulk-data-fetch.php?endpoint=data";
$api_key  = "7a2b9c4d8e5f6a1b2c3d4e5f6";
$cursor   = null;
$all_data = [];

do {
    $url = $base_url;
    if ($cursor) {
        $url .= "&cursor=" . urlencode($cursor);
    }

    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        "X-API-KEY: $api_key"
    ]);
    $response = curl_exec($ch);

    if (curl_errno($ch)) {
        echo 'Request Error: ' . curl_error($ch);
        curl_close($ch);
        break;
    }
    curl_close($ch);

    $result = json_decode($response, true);
    $page   = $result['data'] ?? [];
    $cursor = $result['cursor'] ?? null;

    if (empty($page)) {
        break; // No more data
    }

    $all_data = array_merge($all_data, $page);
    echo "Fetched " . count($page) . " records. Total: " . count($all_data) . "\n";

    // Rate limit: max 5 requests/min → wait ~12 seconds
    if ($cursor) {
        sleep(12);
    }
} while ($cursor);

echo "Done. Total records: " . count($all_data) . "\n";
// print_r($all_data);

JavaScript – Loop all pages

Async loop with rate-limit delay.

const baseUrl = "https://api.bidsinfo.com/bulk-data-fetch.php?endpoint=data";
const apiKey  = "7a2b9c4d8e5f6a1b2c3d4e5f6";
let cursor    = null;
const allData = [];

function sleep(ms) {
    return new Promise(resolve => setTimeout(resolve, ms));
}

async function fetchAllPages() {
    do {
        const url = cursor
            ? `${baseUrl}&cursor=${encodeURIComponent(cursor)}`
            : baseUrl;

        try {
            const response = await fetch(url, {
                method: "GET",
                headers: {
                    "X-API-KEY": apiKey,
                    "Content-Type": "application/json"
                }
            });
            const result = await response.json();

            if (!response.ok) {
                console.error(`Error (${response.status}): ${result.error || 'Unknown error'}`);
                break;
            }

            const page = result.data || [];
            cursor = result.cursor || null;

            if (page.length === 0) break;

            allData.push(...page);
            console.log(`Fetched ${page.length} records. Total: ${allData.length}`);

            // Rate limit: max 5 requests/min → wait ~12 seconds
            if (cursor) {
                await sleep(12000);
            }
        } catch (err) {
            console.error(`Network Error: ${err.message}`);
            break;
        }
    } while (cursor);

    console.log(`Done. Total records: ${allData.length}`);
    return allData;
}

// Usage
fetchAllPages().then(data => {
    // process data
});

Sample Response

{
  "cursor": "WyIyMDI2LTA4LTA2IDE2OjQ5OjA0IiwiMzY4ODQyODgiXQ==",
  "data": [
	{
      "erefno": 38136071,
      "buyer": {
        "company": "POWER TRANSMISSION COMPANY 1 - BRANCH OF NATIONAL POWER TRANSMISSION CORPORATION",
        "address": "Phường Hoàng Quế, Thành phố Quảng Ninh",
        "email": [],
        "website": "",
        "country": {
          "code": "VN",
          "name": "Vietnam"
        }
      },
      "title": "Cadastral Survey of Land Parcels for Land Lease Purposes for the Power Line Project",
      "description": "Tenders are invited for Cadastral Survey of Land Parcels for Land Lease Purposes for the 220kv Power Line Project Section Passing through Hoang Que Ward, Quang Ninh Province, under the Management of Uong Bi Power Line Management Team.\r\n\r\nPrice of bidding documents: 330.000 VND\r\n\r\nBid closing time: 23/10/2026 10:30\r\n\r\nBid opening time: 23/10/2026 10:30\r\n\r\nApproval date: 13/10/2026\r\n\r\n[Disclaimer: The above text is machine translated. For accurate information kindly refer the original document.]",
      "locations": [
        {
          "code": "VN",
          "name": "Vietnam"
        }
      ],
      "tender_no": "IB2600576634",
      "post_date": "2026-10-14",
      "deadline": "2026-10-23",
      "currency": "",
      "value": 0,
      "local": "NCB",
      "tender_type": "Service",
      "industry": [
        "Construction & related works",
        "Energy & Power"
      ],
      "documents": "-VN3~20261014-58042587.html",
      "funding": [
        "No"
      ]
    },
    {
      "erefno": 38128166,
      "buyer": {
        "company": "INTERNATIONAL LABOUR ORGANIZATION (ILO)",
        "address": "Algeria",
        "email": [
          "tunisachat@ilo.org"
        ],
        "website": "",
        "country": {
          "code": "DZ",
          "name": "Algeria"
        }
      },
      "title": "Hotel Selection (4 or 5 Stars) in the Hammamet Area to Organize a Capacity Building Workshop",
      "description": "Quotation are invited for Hotel Selection (4 or 5 Stars) in the Hammamet Area to Organize a Capacity Building Workshop: Knowledge Sharing and Training on the Digital Platform of Labor Administration - Hammamet November 2 to 6, 2026\r\n\r\nDeadline: 20-Oct-2026 00:59 (GMT 2.00)\r\n\r\n[Disclaimer: The above text is machine translated. For accurate information kindly refer the original document.]",
      "locations": [
        {
          "code": "DZ",
          "name": "Algeria"
        },
        {
          "code": "TN",
          "name": "Tunisia"
        }
      ],
      "tender_no": "rfx_12313_ROAF",
      "post_date": "2026-10-14",
      "deadline": "2026-10-20",
      "currency": "",
      "value": 0,
      "local": "ICB",
      "tender_type": "Works",
      "industry": [
        "Hotel & Hospitality"
      ],
      "documents": "-GLB3~20261014-58034302.html",
      "funding": [
        "United Nations (UN)",
        "International Labour Organization"
      ]
    },
    {
      "erefno": 38128129,
      "buyer": {
        "company": "WORLD HEALTH ORGANIZATION (WHO)",
        "address": "Tunisia",
        "email": [
          "emacotunprocurement@who.int"
        ],
        "website": "",
        "country": {
          "code": "TN",
          "name": "Tunisia"
        }
      },
      "title": "Provision of Vehicles with Driver for Business Trips",
      "description": "Request for proposals are invited for Request for Price Offer – Provision of Vehicles with Driver for Business Trips in Tunisia\r\n\r\nDeadline: 15-Oct-2026 09:00 (GMT 1.00)\r\n\r\n[Disclaimer: The above text is machine translated. For accurate information kindly refer the original document.]",
      "locations": [
        {
          "code": "TN",
          "name": "Tunisia"
        }
      ],
      "tender_no": "EM/ACO/TUN/P/0009616",
      "post_date": "2026-10-14",
      "deadline": "2026-10-15",
      "currency": "",
      "value": 0,
      "local": "ICB",
      "tender_type": "Supply",
      "industry": [
        "Logistics",
        "Engineering",
        "Consultancy"
      ],
      "documents": "-GLB3~20261014-58034244.html",
      "funding": [
        "United Nations (UN)",
        "World Health Organization (WHO)"
      ]
    },
    {
      "erefno": 38128118,
      "buyer": {
        "company": "INTERNATIONAL ORGANIZATION FOR MIGRATION (IOM)",
        "address": "Attn: IOM Uganda Procurement, IOM Uganda Procurement",
        "email": [
          "ugandaprocurementandlogistics@iom.int"
        ],
        "website": "",
        "country": {
          "code": "UG",
          "name": "Uganda"
        }
      },
      "title": "Supply and Installation of Information Kiosks at Poes",
      "description": "Quotation are invited for Request for a Quotation to Supply and Installation of Information Kiosks at Poes\r\n\r\nDeadline: 27-Oct-2026 13:11 0.00",
      "locations": [
        {
          "code": "UG",
          "name": "Uganda"
        }
      ],
      "tender_no": "30000035316",
      "post_date": "2026-10-14",
      "deadline": "2026-10-27",
      "currency": "",
      "value": 0,
      "local": "ICB",
      "tender_type": "Supply",
      "industry": [
        "Printing & Publishing"
      ],
      "documents": "-GLB3~20261014-58034078.html",
      "funding": [
        "United Nations (UN)"
      ]
    },
    {
      "erefno": 38128115,
      "buyer": {
        "company": "UNITED NATIONS INTERNATIONAL CHILDREN'S EMERGENCY FUND (UNICEF)",
        "address": "Attn: Suparlan, Wiyono\r\nTel: +93-730727319",
        "email": [
          "afghanistanetendering@unicef.org"
        ],
        "website": "",
        "country": {
          "code": "AF",
          "name": "Afghanistan"
        }
      },
      "title": "Construction of 7 Community Water Supply System",
      "description": "Request for proposals are invited for Construction of 7 Community Water Supply System in Nangarhar Province of Afghanistan\r\n\r\nDeadline: 03-Nov-2026 23:59 (GMT 4.30)",
      "locations": [
        {
          "code": "AF",
          "name": "Afghanistan"
        }
      ],
      "tender_no": "LRPS-2026-9206658",
      "post_date": "2026-10-14",
      "deadline": "2026-11-03",
      "currency": "",
      "value": 0,
      "local": "ICB",
      "tender_type": "Works",
      "industry": [
        "Metals & Minerals",
        "Construction & related works",
        "Hotel & Hospitality"
      ],
      "documents": "-GLB3~20261014-58034001.html",
      "funding": [
        "United Nations (UN)"
      ]
    },
    {
      "erefno": 38127723,
      "buyer": {
        "company": "INTERNATIONAL LABOUR ORGANIZATION (ILO)",
        "address": "Diagonal 6 12-42 zona 10, Edificio Design Center, Torre I, Oficina 410, Ciudad de Guatemala, Guatemala\r\nPhone Numbers: (502) 2233-0289 / (502) 2233-0290",
        "email": [],
        "website": "",
        "country": {
          "code": "GT",
          "name": "Guatemala"
        }
      },
      "title": "Camagro Labor Policy Print (100 Units)",
      "description": "Quotation are invited for Lightweight Rfq - Camagro Labor Policy Print (100 Units)\r\n\r\nDeadline: 15-Oct-2026 20:00 (GMT 2.00)\r\n\r\n[Disclaimer: The above text is machine translated. For accurate information kindly refer the original document.]",
      "locations": [
        {
          "code": "GT",
          "name": "Guatemala"
        }
      ],
      "tender_no": "rfx_12264_ROLAC",
      "post_date": "2026-10-14",
      "deadline": "2026-10-15",
      "currency": "",
      "value": 0,
      "local": "ICB",
      "tender_type": "Supply",
      "industry": [
        "Advertising",
        "Printing & Publishing"
      ],
      "documents": "-GLB3~20261014-58033918.html",
      "funding": [
        "United Nations (UN)",
        "International Labour Organization"
      ]
    },
    {
      "erefno": 38127717,
      "buyer": {
        "company": "INTERNATIONAL ORGANIZATION FOR MIGRATION (IOM)",
        "address": "Attn: IOM EG, Bids",
        "email": [
          "iomegbids@iom.int"
        ],
        "website": "",
        "country": {
          "code": "EG",
          "name": "Egypt"
        }
      },
      "title": "Provision of Italian Language Training and Learning Solutions for Fayoum Advance",
      "description": "Quotation are invited for Provision of Italian Language Training and Learning Solutions for Fayoum Advance\r\n\r\nDeadline: 23-Oct-2026 14:01 0.00",
      "locations": [
        {
          "code": "EG",
          "name": "Egypt"
        }
      ],
      "tender_no": "30000035320",
      "post_date": "2026-10-14",
      "deadline": "2026-10-23",
      "currency": "",
      "value": 0,
      "local": "ICB",
      "tender_type": "Service",
      "industry": [
        "Education"
      ],
      "documents": "-GLB3~20261014-58033849.html",
      "funding": [
        "United Nations (UN)",
        "International Organization for Migration (IOM)"
      ]
    },
    {
      "erefno": 38127708,
      "buyer": {
        "company": "INTERNATIONAL LABOUR ORGANIZATION (ILO)",
        "address": "Jordan",
        "email": [
          "amman@ilo.org"
        ],
        "website": "",
        "country": {
          "code": "JO",
          "name": "Jordan"
        }
      },
      "title": "Strategic Communication and Multimedia Production and Media Services for Social Security Activities",
      "description": "Quotation are invited for Rfq-Strategic Communication and Multimedia Production and Media Services for Social Security Activities in Jordan\r\n\r\nDeadline: 31-Oct-2026 21:59 (GMT 2.00)",
      "locations": [
        {
          "code": "JO",
          "name": "Jordan"
        }
      ],
      "tender_no": "rfx_12103_ROAS",
      "post_date": "2026-10-14",
      "deadline": "2026-10-31",
      "currency": "",
      "value": 0,
      "local": "ICB",
      "tender_type": "Supply",
      "industry": [
        "Administration service",
        "Advertising"
      ],
      "documents": "-GLB3~20261014-58033827.html",
      "funding": [
        "United Nations (UN)",
        "International Labour Organization"
      ]
    },
    {
      "erefno": 38127693,
      "buyer": {
        "company": "INTERNATIONAL ORGANIZATION FOR MIGRATION (IOM)",
        "address": "Attn: Abuja Tender Bids, Abuja Tender Bids",
        "email": [
          "iomabujatenders@iom.int"
        ],
        "website": "",
        "country": {
          "code": "NG",
          "name": "Nigeria"
        }
      },
      "title": "Private Security Service for Nigeria Mission",
      "description": "Request for proposals are invited for Request for Proposal-Private Security Service for Nigeria Mission\r\n\r\nDeadline: 26-Oct-2026 17:30 0.00",
      "locations": [
        {
          "code": "NG",
          "name": "Nigeria"
        }
      ],
      "tender_no": "30000033313-2",
      "post_date": "2026-10-14",
      "deadline": "2026-10-26",
      "currency": "",
      "value": 0,
      "local": "ICB",
      "tender_type": "Service",
      "industry": [
        "Safety & Security"
      ],
      "documents": "-GLB3~20261014-58033792.html",
      "funding": [
        "United Nations (UN)",
        "International Organization for Migration (IOM)"
      ]
    },
    {
      "erefno": 38127689,
      "buyer": {
        "company": "UNITED NATIONS OFFICE FOR PROJECT SERVICES (UNOPS)",
        "address": "• P.O. Box 941655, Amman, Jordan\r\n• Phone: +962 6 590 2100 (or +962 6 590 2131)",
        "email": [],
        "website": "",
        "country": {
          "code": "JO",
          "name": "Jordan"
        }
      },
      "title": "Supply & Commissioning of Inorganic Lab Tools",
      "description": "Quotation are invited for Rfq Goods- Supply & Commissioning of Inorganic Lab Tools to the Department of General Antiquities -Amman-Jordan\r\n\r\nDeadline: 27-Oct-2026 09:00 0.00",
      "locations": [
        {
          "code": "JO",
          "name": "Jordan"
        }
      ],
      "tender_no": "RFQ/2026/65015",
      "post_date": "2026-10-14",
      "deadline": "2026-10-27",
      "currency": "",
      "value": 0,
      "local": "ICB",
      "tender_type": "Supply",
      "industry": [
        "Laboratory Equipment"
      ],
      "documents": "-GLB3~20261014-58033724.html",
      "funding": [
        "United Nations (UN)"
      ]
    },
    {
      "erefno": 38127686,
      "buyer": {
        "company": "INTERNATIONAL LABOUR ORGANIZATION (ILO)",
        "address": "Zambia",
        "email": [
          "Intend.Admin@unrwa.org"
        ],
        "website": "",
        "country": {
          "code": "ZM",
          "name": "Zambia"
        }
      },
      "title": "Provision of Conference Facilities and Accommodation",
      "description": "Quotation are invited for Provision of Conference Facilities and Accommodation in Livingstone, Zambia (13-17 December 2026)\r\n\r\nDeadline: 23-Oct-2026 11:00 (GMT 2.00)",
      "locations": [
        {
          "code": "ZM",
          "name": "Zambia"
        }
      ],
      "tender_no": "rfx_12333_ROAF",
      "post_date": "2026-10-14",
      "deadline": "2026-10-23",
      "currency": "",
      "value": 0,
      "local": "ICB",
      "tender_type": "Works",
      "industry": [
        "Hotel & Hospitality"
      ],
      "documents": "-GLB3~20261014-58033685.html",
      "funding": [
        "United Nations (UN)"
      ]
    },
    {
      "erefno": 38127683,
      "buyer": {
        "company": "UNITED NATIONS RELIEF AND WORKS AGENCY (UNRWA)",
        "address": "Jordan",
        "email": [
          "Intend.Admin@unrwa.org"
        ],
        "website": "",
        "country": {
          "code": "JO",
          "name": "Jordan"
        }
      },
      "title": "Maintenance of Fire Protection Systems and Equipment",
      "description": "Quotation are invited for Maintenance of Fire Protection Systems and Equipment at Logistics Department Compound\r\n\r\nDeadline: 27-Oct-2026 01:00 (GMT 3.00)",
      "locations": [
        {
          "code": "JO",
          "name": "Jordan"
        }
      ],
      "tender_no": "RFQS-3026000483-(BR)",
      "post_date": "2026-10-14",
      "deadline": "2026-10-27",
      "currency": "",
      "value": 0,
      "local": "ICB",
      "tender_type": "Service",
      "industry": [
        "Defence",
        "Safety & Security",
        "Education"
      ],
      "documents": "-GLB3~20261014-58033670.html",
      "funding": [
        "United Nations (UN)"
      ]
    },
    {
      "erefno": 38127681,
      "buyer": {
        "company": "INTERNATIONAL LABOUR ORGANIZATION (ILO)",
        "address": "Office Representation: UN House, 38–44 Stein Street, Klein Windhoek, Windhoek, Namibia\r\nPostal Address: Private Bag 13329, Windhoek, Namibia\r\nPhone: +264 61 204 6111 (UN House main line)",
        "email": [],
        "website": "",
        "country": {
          "code": "NA",
          "name": "Namibia"
        }
      },
      "title": "Provision of Half-Day Conferencing Amenites",
      "description": "Quotation are invited for Provision of Half-Day Conferencing Amenites on 10 November 2026 for 40 Pax\r\n\r\nDeadline: 20-Oct-2026 13:00 (GMT 2.00)\r\n\r\nProvision of Half-Day Conferencing amenities on 10 November 2026 for 40 pax in Windhoek Namibia\r\nThe International Labour Office (ILO) is hereby requesting for quotations for conferencing services as follows:\r\nConference Facilities for 40 participants for 0.5 day on 10 November 2026 .\r\nConference package to include:\r\n• Venue Hire (must safely and comfortably accommodate 40 people)\r\n• Conference set up (with cordials and mints);\r\n• PA system (including at least 2 codeless microphones)\r\n• Projector;\r\n• Projector Screen;\r\n• Morning Teas with sandwiches at 10am\r\n• Lunch (starter, main course, dessert and one soft drink/juice per person);\r\n• Bottled Water (three per person per day);\r\n• Wi-Fi Connectivity;\r\n• Air Conditioning;\r\n• Stationery (including flip charts, flip chart stand, pen, paper, markers).",
      "locations": [
        {
          "code": "NA",
          "name": "Namibia"
        }
      ],
      "tender_no": "rfx_12344_ROAF",
      "post_date": "2026-10-14",
      "deadline": "2026-10-20",
      "currency": "",
      "value": 0,
      "local": "ICB",
      "tender_type": "Service",
      "industry": [
        "Hotel & Hospitality"
      ],
      "documents": "-GLB3~20261014-58033656.html",
      "funding": [
        "United Nations (UN)"
      ]
    },
    {
      "erefno": 38127679,
      "buyer": {
        "company": "INTERNATIONAL LABOUR ORGANIZATION (ILO)",
        "address": "Phone: +389 70 218 510",
        "email": [
          "krstanovski@ilo.org"
        ],
        "website": "",
        "country": {
          "code": "MK",
          "name": "Macedonia"
        }
      },
      "title": "Event Management Services",
      "description": "Quotation are invited for Event Management Services - 27 October 2026 (N. Macedonia)\r\n\r\nDeadline: 19-Oct-2026 12:00 (GMT 2.00)",
      "locations": [
        {
          "code": "MK",
          "name": "Macedonia"
        }
      ],
      "tender_no": "rfx_12343_Europe",
      "post_date": "2026-10-14",
      "deadline": "2026-10-19",
      "currency": "",
      "value": 0,
      "local": "ICB",
      "tender_type": "Service",
      "industry": [
        "Administration service",
        "Research & Development"
      ],
      "documents": "-GLB3~20261014-58033641.html",
      "funding": [
        "United Nations (UN)"
      ]
    }
  ]
}

Response Fields

Field Type Description
cursor string Opaque token for the next page. Pass it as the cursor query param.
data array Array of tender records for the current page.
data[].erefno integer Unique reference number for the tender.
data[].buyer object Buyer / issuing organization details.
data[].buyer.company string Issuing organization / department name.
data[].buyer.address string Organization address.
data[].buyer.email array of string Contact email(s). Empty array when none available.
data[].buyer.website string Organization website (may be empty).
data[].buyer.country object Buyer country information.
data[].buyer.country.code string ISO country code (e.g. "VN", "DZ").
data[].buyer.country.name string Country name (e.g. "Vietnam").
data[].title string Tender title.
data[].description string Full description including dates, fees, category, etc.
data[].locations array of object List of relevant locations for the tender.
data[].locations[].code string Location country code.
data[].locations[].name string Location country name.
data[].tender_no string Official tender / notice number.
data[].post_date string Date the tender was posted (YYYY-MM-DD).
data[].deadline string Bid submission deadline (YYYY-MM-DD).
data[].currency string Currency code (may be empty).
data[].value number Estimated value (0 if not specified).
data[].local string Procurement type indicator (e.g. "NCB", "ICB").
data[].tender_type string Type of tender (e.g. "Service", "Works", "Supply").
data[].industry array of string Industry / sector categories.
data[].documents string Document identifier / filename reference.
data[].funding array of string Funding source(s) (e.g. ["No"], ["United Nations (UN)"]).