// docs

Sympla: Search events

Extracts search results from Sympla by keyword and page, with total results, next page and event cards without browser rendering.

sympla.com.br:plp · 1 credit per request

Standard credit cost. Your account pricing is shown in the sandbox.

Try this operation in the sandbox

HTTP request

cURL

curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "target": "sympla.com.br",
  "type": "plp",
  "keyword": "teatro",
  "page": 1
}'

Keep your API key on your server. See the quickstart for authentication and response handling.

MCP request

The hosted MCP tool fixes target and type for this operation. Its remaining arguments use the same input rules as Extract.

POST /v1/mcp · Bearer or X-API-Key authentication

sympla_com_br_plp · tools/call

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "sympla_com_br_plp",
    "arguments": {
      "keyword": "teatro",
      "page": 1,
      "executionId": "exec_example_123"
    }
  }
}

Supported inputs

Conditional fields depend on the alternatives and constraints in the rule column. Fields marked unsupported are omitted.

Field	Type	Requirement	Rule	Default	Example
url URL extraction target. For some PLPs it can be omitted when API assembles URL from other fields.	string (URL)	Conditional	Optional. When sent, it must point to /eventos and contain keyword in s.	-	https://www.sympla.com.br/eventos?s=teatro&page=1
keyword Keyword for PLP searches. In Google Search it represents the query sent to Google; in Booking PLP is mandatory; in other PLPs it can replace URL.	string	Conditional	Mandatory when url is not sent. Turn the search parameter only.	-	teatro
target Target source for extraction.	enum	Required	Always mandatory and must be sympla.com.br.	-	sympla.com.br
type Extraction type: pdp, idp, plp, ilp, quote, review or places.	enum	Required	Always mandatory and must be plp.	-	plp
page Pagination. In PLP, including Trivago, and in Reclame AQUI ILP starts in 1; in review (MercadoLivre, Booking and Hotels) starts in 0. The Reclame AQUI ILP even accepts the page 100.	integer	Optional	Paginacao 1-based.	1	1

Request examples

PLP by keyword

The URL search is automatically assembled from keyword and page.

PLP by keyword

{
  "target": "sympla.com.br",
  "type": "plp",
  "keyword": "teatro",
  "page": 1
}

PLP by URL ready

It also accepts URL to search for Sympla, as long as the query contains s=keyword.

PLP by URL ready

{
  "target": "sympla.com.br",
  "type": "plp",
  "url": "https://www.sympla.com.br/eventos?s=teatro&page=1"
}

Response schema

Leaf paths and expected types. Field names and enum values are part of the API contract.

responseSchema

{
  "requestId": "string (uuid)",
  "executionId": "string (uuid)",
  "notFound": "boolean (optional; true when the upstream entity was not found and data is null)",
  "data.source": "string",
  "data.type": "string",
  "data.parser": "\"1.0.0\"",
  "data.url": "string",
  "data.requestUrl": "string",
  "data.extractedAt": "string (iso datetime)",
  "data.keyword": "string",
  "data.page": "number",
  "data.limit": "number",
  "data.totalResults": "number",
  "data.primaryResults": "number",
  "data.nextPage": "number",
  "data.nextPageUrl": "string",
  "data.items[].position": "number",
  "data.items[].id": "number",
  "data.items[].eventId": "number",
  "data.items[].name": "string",
  "data.items[].url": "string",
  "data.items[].type": "string",
  "data.items[].company": "string",
  "data.items[].durationType": "string",
  "data.items[].globalScore": "number",
  "data.items[].startDate": "string",
  "data.items[].endDate": "string",
  "data.items[].startDateLabel": "string",
  "data.items[].endDateLabel": "string",
  "data.items[].imageUrl": "string",
  "data.items[].imageLgUrl": "string",
  "data.items[].imageXsUrl": "string",
  "data.items[].location.name": "string",
  "data.items[].location.address": "string",
  "data.items[].location.addressAlt": "string",
  "data.items[].location.addressNum": "string",
  "data.items[].location.neighborhood": "string",
  "data.items[].location.city": "string",
  "data.items[].location.state": "string",
  "data.items[].location.zipCode": "string",
  "data.items[].location.country": "string",
  "data.items[].location.latitude": "number",
  "data.items[].location.longitude": "number",
  "data.items[].organizer.id": "string",
  "data.items[].organizer.name": "string",
  "data.items[].organizer.email": "string",
  "data.items[].organizer.url": "string",
  "data.items[].organizer.image": "string",
  "data.items[].organizer.organizerRange": "string",
  "data.items[].organizer.organizerRangeId": "string"
}

Example response

Illustrative response. Product names, reviews and other source content retain their original language. Missing and null values do not imply zero stock, free shipping or zero reviews.

responseExample

{
  "requestId": "req_01JQ4Z2DM0X0AHVYAFR75T7Q9A",
  "executionId": "exe_01JQ4Z2DM0X0AHVYAFR75T7Q9B",
  "data": {
    "source": "sympla.com.br",
    "type": "plp",
    "parser": "1.0.0",
    "url": "https://www.sympla.com.br/eventos?s=teatro&page=1",
    "requestUrl": "https://www.sympla.com.br/eventos?s=teatro&page=1",
    "extractedAt": "2026-03-31T14:05:00.000Z",
    "keyword": "teatro",
    "page": 1,
    "limit": 24,
    "totalResults": 1806,
    "primaryResults": 24,
    "nextPage": 2,
    "nextPageUrl": "https://www.sympla.com.br/eventos?s=teatro&page=2",
    "items": [
      {
        "position": 1,
        "id": 50117663,
        "eventId": 117663,
        "name": "O CEU DA LINGUA",
        "url": "https://bileto.sympla.com.br/event/117663",
        "type": "NORMAL",
        "company": "ttrs",
        "durationType": "multiple",
        "globalScore": 607428,
        "startDate": "2026-04-22T22:00:00+00:00",
        "endDate": "2026-04-26T00:30:00+00:00",
        "startDateLabel": "Qua, 22 Abr - 2026 · 19:00",
        "endDateLabel": "Sab, 25 Abr - 2026 · 21:30",
        "imageUrl": "https://assets.bileto.sympla.com.br/eventmanager/production/24s1ocg90u9kldhr3vbho8gspu8rvhg7b8rjcu0cb7v1ft6r58hcq7743e8ld2b5j7hoprjqgistj0r2m5m6dppbp98s8via1krsvj2.webp",
        "imageLgUrl": "https://assets.bileto.sympla.com.br/eventmanager/production/24s1ocg90u9kldhr3vbho8gspu8rvhg7b8rjcu0cb7v1ft6r58hcq7743e8ld2b5j7hoprjqgistj0r2m5m6dppbp98s8via1krsvj2.webp",
        "imageXsUrl": "https://assets.bileto.sympla.com.br/eventmanager/production/24s1ocg90u9kldhr3vbho8gspu8rvhg7b8rjcu0cb7v1ft6r58hcq7743e8ld2b5j7hoprjqgistj0r2m5m6dppbp98s8via1krsvj2.webp",
        "location": {
          "name": "Grande Teatro Cemig Palacio das Artes",
          "address": "Av. Afonso Pena,1537",
          "addressAlt": "",
          "addressNum": "0",
          "neighborhood": "",
          "city": "Belo Horizonte",
          "state": "MG",
          "zipCode": "",
          "country": "",
          "latitude": -19.9256264,
          "longitude": -43.9337146
        },
        "organizer": {
          "id": "5824",
          "name": "FUNDACAO CLOVIS SALGADO - FCS",
          "email": "clarissa@padrok.com.br",
          "url": "https://www.sympla.com.br/produtor/fundacao-clovis-salgado",
          "image": "https://images.sympla.com.br/organizer-fundacao-clovis-salgado.jpg",
          "organizerRange": "UPPER_RANGE",
          "organizerRangeId": "1"
        }
      }
    ]
  }
}

Complete field reference

Path	Type	Description	Example
data.extractedAt	string (iso datetime)	Extraction timestamp UTC.	2026-03-31T14:05:00.000Z
data.items[].company	string	Slug/company associated with the card when informed.	ttrs
data.items[].durationType	string	Event duration type.	multiple
data.items[].endDate	string	Event end date/time in raw format.	2026-04-26T00:30:00+00:00
data.items[].endDateLabel	string	Friendly label of the ultimate data.	Sab, 25 Abr - 2026 · 21:30
data.items[].eventId	number	ID canonical of the event extracted from URL of the card.	117663
data.items[].globalScore	number	Internal/global score of the item in the search payload.	607428
data.items[].id	number	ID card raw in the search payload.	50117663
data.items[].imageLgUrl	string	Large version of the card image.	https://assets.bileto.sympla.com.br/eventmanager/production/24s1ocg90u9kldhr3vbho8gspu8rvhg7b8rjcu0cb7v1ft6r58hcq7743e8ld2b5j7hoprjqgistj0r2m5m6dppbp98s8via1krsvj2.webp
data.items[].imageUrl	string	Main card image.	https://assets.bileto.sympla.com.br/eventmanager/production/24s1ocg90u9kldhr3vbho8gspu8rvhg7b8rjcu0cb7v1ft6r58hcq7743e8ld2b5j7hoprjqgistj0r2m5m6dppbp98s8via1krsvj2.webp
data.items[].imageXsUrl	string	Extra-small version of the card image.	https://assets.bileto.sympla.com.br/eventmanager/production/24s1ocg90u9kldhr3vbho8gspu8rvhg7b8rjcu0cb7v1ft6r58hcq7743e8ld2b5j7hoprjqgistj0r2m5m6dppbp98s8via1krsvj2.webp
data.items[].location.address	string	Textual address of the location.	Av. Afonso Pena,1537
data.items[].location.addressAlt	string	Address complement.
data.items[].location.addressNum	string	Address number.	0
data.items[].location.city	string	Event city.	Belo Horizonte
data.items[].location.country	string	Country entered in the payload.
data.items[].location.latitude	number	Location latitude.	-19.9256264
data.items[].location.longitude	number	Location longitude.	-43.9337146
data.items[].location.name	string	Event location name.	Grande Teatro Cemig Palacio das Artes
data.items[].location.neighborhood	string	Neighborhood of the location when informed.
data.items[].location.state	string	UF of the event.	MG
data.items[].location.zipCode	string	CEP of the location when entered.
data.items[].name	string	Event name in the listing.	O CEU DA LINGUA
data.items[].organizer.email	string	Organizer's email when informed.	clarissa@padrok.com.br
data.items[].organizer.id	string	ID from the organizer in the listing payload.	5824
data.items[].organizer.image	string	Organizer image when it exists.	https://images.sympla.com.br/organizer-fundacao-clovis-salgado.jpg
data.items[].organizer.name	string	Organizer name displayed on card.	FUNDACAO CLOVIS SALGADO - FCS
data.items[].organizer.organizerRange	string	Internal range of the organizer.	UPPER_RANGE
data.items[].organizer.organizerRangeId	string	ID numeric/textual organizer track.	1
data.items[].organizer.url	string	URL publishes from the organizer when it exists.	https://www.sympla.com.br/produtor/fundacao-clovis-salgado
data.items[].position	number	Absolute position of the item in the listing.	1
data.items[].startDate	string	Event start date/time in raw format.	2026-04-22T22:00:00+00:00
data.items[].startDateLabel	string	Friendly label of the initial data.	Qua, 22 Abr - 2026 · 19:00
data.items[].type	string	Event type returned by Sympla.	NORMAL
data.items[].url	string	URL publishes the event card.	https://bileto.sympla.com.br/event/117663
data.keyword	string	Keyword used in the search parameter.	teatro
data.limit	number	Number of items per page reported by the payload.	24
data.nextPage	number	Next available page, if any.	2
data.nextPageUrl	string	URL ready for the next page, if any.	https://www.sympla.com.br/eventos?s=teatro&page=2
data.page	number	Current search page (1-based).	1
data.parser	"1.0.0"	Stable version of the API response format.	1.0.0
data.primaryResults	number	Quantity of items returned in array items.	24
data.requestUrl	string	Same value as `data.url`; never exposes the queried internal endpoint.	https://www.sympla.com.br/eventos?s=teatro&page=1
data.source	string	Fixed operation source.	sympla.com.br
data.totalResults	number	Total events found for keyword.	1806
data.type	string	Fixed operation type.	plp
data.url	string	URL returned by the upstream request.	https://www.sympla.com.br/eventos?s=teatro&page=1
executionId	string (uuid)	ID internal to the execution processed by the worker.	exe_01JQ4Z2DM0X0AHVYAFR75T7Q9B
notFound	boolean (optional; true when the upstream entity was not found and data is null)	Present and true when the upstream entity was not found. In this case data is null and the request still completes successfully.	N/A
requestId	string (uuid)	ID from request HTTP to GeckoAPI.	req_01JQ4Z2DM0X0AHVYAFR75T7Q9A

Errors and missing data

When supported by this operation, an entity not found upstream can return HTTP 200 with data: null and notFound: true. Check the documented response fields before interpreting an empty result. Source-specific behavior and exceptions are described above.

HTTP status	Error code	Meaning
400	`INVALID_PAYLOAD`	Invalid JSON or a request that violates the documented validation rules.
401	`UNAUTHORIZED`	Missing authorization or an invalid API key or token.
402	`INSUFFICIENT_CREDITS`	The account has insufficient credits for this operation.
403	`FORBIDDEN`	The account does not have access, or the API is temporarily disabled.
409	`EXECUTION_CONFLICT`	The execution identifier conflicts with an incompatible execution state.
429	`RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS`	A rate limit or simultaneous request limit was exceeded.
5xx	`UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_FUNCTION_ERROR`	An upstream, worker or gateway failure. Failed requests follow the platform refund policy.

Other Sympla operations

Get event details (PDP)