How to search for specific value through API filterByFormula?

Topic Labels: API
34324 18
Showing results for 
Search instead for 
Did you mean: 
6 - Interface Innovator
6 - Interface Innovator

My “Published URL” column contains URLs of web pages.

Through API, I would like to be able to pull only the record containing a URL I supply in the call.

I am already successfully making a curl call with this…

  $base = 'appPtTr2kigmLlCP8';
  $table = 'Content';
  $view = urlencode('Published (Robert)');

  // $fields = urlencode('Published URL'); // Only return these fields, cf.
  if (!empty($offset)) {
    $q_offset = '&offset='.$offset;
  $airtable_url = '' . $base . '/' . $table;

  // construct the url query
  $url = '' . $base . '/' . $table . '?maxRecords=5&pagesize=1000&view='.$view . $q_offset;

But how can I make use of the relevant feature (is it filterByFormula?) to add

Elsewhere on the forum, I have seen reference like…


But I have not crystallised how I would perform a query for the record with a specific “Published URL” value.

How do I do this, and what do I need to know about encoding a URL and the whole query parameter pair?


18 Replies 18
6 - Interface Innovator
6 - Interface Innovator

filterByFormula allows you to apply an Airtable formula to limit the records that are returned. If I understand your question correctly, rather than trying to fetch a record by its Airtable record ID, you want to fetch it based on a different field value.

You can do this by doing filterByFormula={Field Name}="value". When your field names have a space in them, you have to wrap the name in curly brackets (you can also do this for field names that don’t have a space character, but it is not required). You should be aware that making a GET call with filterByFormula will always return a list of records, even if that list only has one value in it.

You can use this Airtable API Encoder to check how you should encode your data.

4 - Data Explorer
4 - Data Explorer

But how can I use filterByFormula to search for a specific containing string, i.e: If I’m searching for a book name like “UX design” and the search term was just ‘ux’ how to do this?

4 - Data Explorer
4 - Data Explorer

Reading the documentation at, your formula would look something like:

SEARCH("ux",{Field Name})

Using the Airtable API Encoder (at suggested above, the corresponding URL would look something like:

Hope this helps.


4 - Data Explorer
4 - Data Explorer

Is it possible to somehow replace the Field Name {Field Name} part of the URL string by the AirTable Field ID fldnXGeRDd2r9SeRb?
I want to avoid that the code breaks in case the column is renamed.

You can find out the Field ID by opening Chrome or Firefox Code Inspector and searching for the column header’s parent div which looks like:
<div class="cell header primary read" data-columnid="fldnXGeRDd2r9SeRb" ...>

Thanks for your feedback!


The above Formula is not working for the below format
“loanFk”: [

How can I compose a filterByFormula string to get only records from a set of record IDs? I tried filterByFormula=“OR(RECORD_ID() = ‘recRjdJSziwMjfhO8’, RECORD_ID() = ‘recdRonUzKAIMPOxb’)”, but id doesn’t work. Thank you in advance,

The string filterByFormula=“OR(RECORD_ID() = ‘recRjdJSziwMjfhO8’, RECORD_ID() = ‘recdRonUzKAIMPOxb’)” works. Sorry. My bad. I had another issue.

Hey @Momen_Zakaria Were you able to get it working?

7 - App Architect
7 - App Architect

Based on new available functions of Regular Expressions.

Now you can use things like this.

კაი კაცი ხარ ბრააააატ

What would be the syntax for something like this:
filterByFormula={Field Name}=ANY["value1", "value2", "value2", "value2"]

Hi @dilipborad
I an new to Airtable and have a similar requirement. I have a simple database with keywords. I’m looking for a get API that will search input string in the database and if available, output the same.
It looks like Regex can resolve this. What would the syntax look like?


If we have a list of a keyword like

  1. Tiger
  2. Lion
  3. Elephant
  4. Jackel

Now if you use.

REGEX_MATCH({Keywords}, ‘Tiger’)


REGEX_MATCH({Keywords}, ‘Lio’);

Thank you - I was looking for the JS Script API, which I was able to figure using the attached link

4 - Data Explorer
4 - Data Explorer

I have a lookup field that contains comma separated values, like so: pg, cc, pg

How might I structure my formula to say, “If my field contains ‘cc’”…?

I figured it out. The lookup field was pulling from a single line text field. Once I changed it to a single select field, I was able to use a FIND formula:

FIND("cc",{Learning Center ID})>0
4 - Data Explorer
4 - Data Explorer

When using filterByFormula , the new filter will be applied on top of the existing View filters to further filter the results down. It will not replace filters already on your View.

Did you manage to filter by a field id rather than the name? I could not get it working, and its driving me crazy.